用途:Skill Builder 用于创建、更新、审查或排查兼容 Agent Skills 的 SKILL.md 技能包。它把技能视为聚焦、可复用的工作流包,而非长提示词,强调精确触发、清晰执行契约、可选可复用资源与验证证据。
主要能力:定义单一主要职责与明确排除项;先编写并验证触发描述,再写正文;规划资源结构,将核心工作流、关键陷阱与验证规则留在 SKILL.md,把详细 API 文档、框架变体、模式与长示例放入一级 references/,把确定性或反复改写的逻辑放入 scripts/,把输出模板、样板、图片、字体或复制文件放入 assets/;提供触发质量检查、红旗信号、反合理化说明与验证清单。
使用方式:输入技能名称或目标能力、目标目录(如 skills/、.codex/skills/ 或 ~/.codex/skills/)、应触发与不应触发的真实用户请求、需编码的现有文档、代码、运行手册、模板、脚本或历史失败。若缺少示例,可据目标起草 3-5 个真实触发示例。输出包括变更文件路径、description 中捕获的触发意图、有意添加或省略的资源、模板文件处理方式及原因、已执行验证与剩余缺口。
适用场景:为编码代理构建开发类技能,或创建、更新、审查、排查 Agent Skills 兼容技能包。
限制:不用于不会成为可复用技能的通用提示词写作;不用于任务中途创建自定义子代理 TOML 文件;除非用户明确要求,不安装、发布或全局同步技能。仅在目标工作、目标位置或所需专有/源材料无法安全推断时才停下询问,否则做保守假设并继续。SKILL.md 建议不超过约 200 行,description 不超过 3 行。验证命令包括:grep -E "^name:|^description:" SKILL.md | wc -l 必须为 2;目录名需匹配技能名;检查示例块外无未解析占位符。