实践指南
选一件要做的事:跟着步骤做、复制任务单、核对真实成果
像做产品一样设计、分片与盲测 Agent Skill
把高频重复任务整理为带 SKILL.md 入口、静默后置配置引导、确定性脚本、单页分片产物与双盲子 Agent 评测的工程资产。

请帮我把当前这套重复工作流封装为项目级 Skill:1) SKILL.md 写清触发场景、输入输出与禁止事项,并注明直接调用 scripts/ 而不必阅读脚本源码;2) 将固定格式转换与后置校验写成确定性脚本,长输出采用逐页/逐段中间文件落盘再合并;3) 生成完成后,启动一个无上下文子 Agent 对加载该 Skill 前后的产出做一次同题双盲对比评测。
不要把所有垂类 Skill 都装在全局目录里污染上下文。为项目初始化一份精简的 AGENTS.md 写清项目定位与文件索引,将只在该项目使用的工作流放在项目级隐藏目录(如 .codex/skills/),并在 SKILL.md 头部写清精确的触发场景描述。
- 在 SKILL.md 中明确写“不要阅读 scripts/ 源码,直接按命令行参数调用”
- 脚本缺省配置时自动采用安全默认值,仅在输出尾部附带一行修改说明
- 凡是规则固定的转换(FFmpeg 切片、HTML 拼接、字数与比例校验)全部写成脚本
留下的成果新开会话时 Agent 能自动读取 AGENTS.md 并在匹配任务时准确触发目标 Skill,不与其他项目串味。
时间戳计算、文件切分合并、格式校验等确定性工作一律封装进 scripts/ 脚本,只把语义判断留给 Agent。禁止让 Agent 每次运行前去翻几百行脚本源码查配置项;脚本应直接以默认参数跑完主流程,在结尾打印一行轻量的自定义配置提示。
留下的成果首次调用零配置即可跑通默认产物,Token 消耗与耗时显著下降。
为了兼容轻量模型并防止长输出后半段偷懒删减,强制让 Agent 按单页或单步生成独立中间文件(如 slide-01.html),再由脚本合并。涉及视觉封面、排版或字幕校对时,将产物注入本地 HTML 预览模板,让人在浏览器里一眼确认。
- 相同任务并行跑“加载 Skill”与“不加载 Skill”,交由无上下文子 Agent 盲测打分
- 检查 Windows 与 macOS 路径分隔符兼容,避免硬编码个人绝对路径
- 将垂类 Skill 收纳进项目目录,并在精简的 AGENTS.md 中维护触发索引
留下的成果长文档或 15 页演示文稿零内容遗漏,且人工可在本地 HTML 页面一键挑选或确认。
用同一道真实任务分别在“加载 Skill”和“不加载 Skill”下生成结果,把两份匿名产物交给一个全新的子 Agent 盲测对比完成度、遵循度与 Token 开销;同时检查 Windows/macOS 路径分隔符与外链可用性。
留下的成果盲测记录明确证明加载 Skill 后的产出在稳定性与规范遵循上优于裸跑。