一位摄影展策划人有一批图片说明文件，想生成按展区排序的索引，不再手动复制文件名。Codex 入门可以从这样的有限任务开始：读取练习目录，生成一份清单，报告缺少说明或编号重复的文件，保留原资料。先用六个虚构文件完成，再考虑换工具复核与批量处理。目标不是第一次就自动接管全部工作，而是让输入、执行和结果都能看清。
第一次任务先给边界和已知答案
建立只含虚构文件的练习副本，明确哪个目录允许读取、哪个目录存放产物。准备两条正常说明、一条重复展品编号、一条空白说明，以及带空格和中文的文件名，手工标出预期。说明排序依据是展区与展品编号，未知展区应报告，不能悄悄归到任意位置。先保存原目录清单，任务中要求不重命名、不覆盖或删除源文件。
让 Codex 先说明当前环境可用的文件与执行工具，再检查输入样本和现有项目说明。给任务卡写出产物：索引文件、异常清单、运行方法和一条验证记录。若它只有文本材料而没有文件访问，先让它整理方案，不能声称已扫描实际目录。能执行时先在小样上运行，记录命令、退出状态与输出路径。错误和建议保留原样，执行成功要由真实文件与内容确认。
逐项对照六个样本。正常条目是否出现，重复编号是否被报告，空白说明是否有明确处理，中文与空格是否保持正确。再次运行应得到同样清单，而不是重复追加。故意给一个不存在的输入目录，检查是否明确失败且没有改动源资料。一个命令返回成功并不能证明所有需求满足，这些可见条件才是第一次任务的完成标准。
与 Claude Code 配合时传递版本和产物
若团队也使用 Claude Code，可以让一个工具实现，另一个复核有限产物，但先确认两个环境都能读取哪份资料。传递脚本版本、六个样本、规则和已有检查结果，要求复核者指出具体问题、触发条件与重跑方式。不要仅转发一段「已经完成」的摘要，也不要假设一个宿主的会话会自动知道另一个宿主的上下文。
初次复核保持只读，检查编号解析、排序、异常路径和源文件保护。复核者没有运行脚本时，意见标成源码推断或待验证。由主任务维护者决定修改，再用相同样本复跑。避免两个会话同时写同一个脚本后难以判断哪个版本通过。共享分支时明确整合者，使用隔离副本时标明各自版本，最终交付只选一份经过复验的结果。
这不是必须安装某个跨宿主封装的前提。先查看各宿主当前官方文档与工具支持，用文件和可复跑方法交接就能形成最小协作。只有当重复操作确实形成瓶颈，再调查集成工具需要的账号、依赖和权限。安装名为某工具的技能也不代表已经拥有该工具的认证或执行环境。
进阶实践先把小样变成回归
把六个输入与预期结果保存为回归夹具，补一个未知展区和一个大小写不同的文件名，确认规则如何处理。扩展到多个目录前，规定是否递归、怎样排除产物目录、如何报告无法读取的文件。若只想扫描指定目录，脚本不应自动跟随指向其他位置的入口。批量运行给每份输出加来源与状态，部分失败要出现在最终汇总，不能被其他成功遮盖。
给使用说明写清依赖、输入路径、输出格式、错误与复跑方式。技术文稿复核可选 Writing Guidelines：已核对条目要求读取指定写作手册，对目标文件返回有行位置的建议。它用于本阶段改进运行说明的可读性，先确认手册可访问并说明读者是非程序员策划人。它不验证脚本执行或目录结果，实际小样仍需运行核对。
稳定流程可以再整理为任务方法，参考 OpenAI 的工作流示例 分开项目约定、阶段资料与验证记录。文档是帮助接手的入口，不应膨胀成每次都读的聊天备份。请同事按说明在同一练习副本生成索引，记录他缺少的信息，再修正文档。比较效率时包含查错与复核时间，而非只看第一版生成速度。
找技能先描述需要的产物
先检查是否已有 SkillPI Skill Finder，没有时阅读官方仓库说明，按当前宿主支持方式安装启用。搜索时说明文件类型、任务范围、读写边界与产物，要求给真实来源、版本和依赖，再打开实际包核对。不要为了入门把所有推荐都装上，不能确认用途或来源的候选先不使用。
安装后区分宿主发现、任务调用和结果符合预期。换宿主时重新核对加载位置、脚本与工具接口。技能许可证、模型订阅和外部服务成本分别检查，不把开源等同于所有执行免费。原任务已能用现有工具完成时，技能可以只负责某一重复步骤，不必替换整个流程。
常见问题
不会编程，怎样判断结果正确？
用能手工核对的小样和明确产物开始。按文件逐项比较清单，检查源资料未变，故意制造一条错误观察报告。看不懂的命令请维护者解释后再执行。
助手说跑完了，但没有找到文件怎么办？
要求给出实际输出路径与运行结果，再检查文件内容。若只提供代码或建议，状态应是待运行。不要把对话里的承诺当成交付。
两个工具给出不同结论怎么办？
固定同一版本和输入，用可复跑样本验证争议。先检查是否读了不同资料，保留观察与推断的区别。数量更多的意见不一定更正确。
技能不适合项目，可以直接换吗？
记录失败原因，使用宿主支持的方法停用或移除，确认原流程仍能运行。新候选先用同一小样比较，再决定是否替换关联与使用说明。
求助时提供什么最有效？
给宿主与系统版本、来源提交、最小合成输入、运行命令、脱敏错误和预期结果。说明失败发生在安装、发现还是执行，能帮助得到具体修复建议。