Make Skill

创建 Skill

从当前原始对话创建一个新的 workspace Skill。按以下生命周期使用本目录脚本，不依赖 make-skill 专属的 core tool、mode 或状态存储。

通过 execute_shell_command 运行下文每个 python scripts/... 命令，并将 cwd 设为 available-skills 条目中本 Skill 的 <dir>；每个脚本从 stdin（或 --input <file>）读取一个 JSON 对象，并向 stdout 写出一个 JSON 对象。

计划

/make-skill <focus> 的 focus 必填；自然语言请求则结合请求和当前对话推断。用户较晚的纠正会替换冲突的旧规则。保留会改变未来 agent 行为的稳定指导、契约、模板和流程，排除一次性数据、临时路径、密钥与重试噪声。

阅读主类型与包结构，选择一个主类型和实际需要的文件。计划的测试模式不是 off 时，在定义测试目标前阅读行为测试。

Batch workflow

存储 Batch 是随 workflow Skill 一起提供的参数化 run_tool_batch 程序。当一个可复用区域的动作、分支和成功条件能在执行前说明，并且存储入口能实质减少 agent 与工具往返时，设置 batch: true。该区域可以是完整 workflow、一个 substantial helper，或一个语义完整的 tool-native action；action 数量不是判据。只要处理规则已经确定，运行时数据、observation 和最终 agent review 都不妨碍使用 Batch。

只有运行时必须重新发明下一步或成功条件，或者统一入口没有实际复用价值时，才设置 batch: false。用户明确要求 Batch 时，把它视为已批准的计划修订，直接修改计划，不再争论 eligibility。

只有选择 batch: true 后，才在最终确定 workflow 和文件树前阅读运行 Batch；batch: false 时不要读取。

计划阶段除运行 python scripts/create_plan.py 外只读：依据对话证据和已有产物判断，不执行或探测候选工作流，不创建文件，也不初始化 draft。通过 stdin 传入候选计划：

{
  "revision": 1,
  "focus": "一句话说明提炼范围",
  "name": "lowercase-hyphen-name",
  "goal": "未来 agent 要达成的结果",
  "type": "workflow",
  "batch": true,
  "steps": ["用户可判断的流程步骤"],
  "package": ["SKILL.md", "scripts/run.batch.json"],
  "execution": "foreground",
  "test": {"mode": "off", "target": ""},
  "warnings": []
}

用中文渲染规范化计划，并把已选值和全部可选项一起展示，让用户无需了解 schema 也能修改。用户可见计划必须包含下列紧凑选项表，不得用散文或批准提示代替；非 workflow 省略 Batch 行：

传给脚本的值仍分别使用 instruction/template/workflow、true/false、foreground/background 和 off/smoke/eval。同时展示名称、目标、工作流、完整文件树、适用时的测试目标和警告。不得发明脚本 schema 之外的选项；不展示 Batch 关闭理由、schema、revision 或内部 enum。请用户批准、修改或取消，然后结束当前响应，不再调用工具。只有后续新的用户消息明确批准已展示的 revision，才继续执行。

• 用户修改后合并最新反馈、增加 revision、重跑 create_plan.py 并展示完整返回结果。
• 取消时停止；模糊回复只追问一次简短确认。
• execution 和 test 已在计划中，不再单独询问。

本版本只创建新 Skill；名称冲突时通过新 revision 重新批准名称，不覆盖已有 Skill。

构建

批准后运行 python scripts/init_draft.py，并通过 stdin 传入 JSON：

{"workspace": "/workspace/path", "plan": {"...": "完整规范化计划"}}

只在返回的 skill_dir 中创建批准文件。生成的 SKILL.md 使用合法 frontmatter：

---
name: lowercase-hyphen-name
description: 简要说明能力及适用场景。
---

正文只保留必要流程和约束，不重复 description；无需 type metadata。

校验前，从“未来 agent 看不到原始对话”的视角通读 package。除非资源确实随包提供且可复用，否则删除对原任务目录、旧输出、临时 ID、当前 case 示例或 make-skill draft/publish 话术的引用。复用已有 helper 时，要泛化路径、docstring 和结果说明，并确认实现仍符合最终可复用规则。这只是一轮作者自查，不增加 case-specific lifecycle 检查。

选择后台执行时，把完整批准计划、最新纠正、draft 路径和剩余 gates 交给通用 subagent；subagent 不再请求批准。

校验、测试并发布

执行任何 draft script 或 batch 前，先运行 python scripts/validate_skill.py，并通过 stdin 传入 JSON：

{"workspace": "/workspace/path", "draft_id": "returned-draft-id"}

按静态或安全错误修复 draft 并重新校验。测试与 Batch 相互独立：按行为测试只运行已批准的测试，off 不执行 draft。测试或 Batch 运行失败时保留 draft，报告具体错误；如果修正方向明确，就修改 Skill 后重新校验，不用 fallback 隐藏失败。

运行 python scripts/publish_skill.py，并通过 stdin 传入 JSON，以发布未经改动且已校验的 draft：

{"workspace": "/workspace/path", "draft_id": "returned-draft-id", "expected_digest": "digest-from-validation"}

成功后报告 package tree、校验摘要、已执行的测试结果和调用命令 /<name>；冲突或失败时保留 draft 并报告错误。发布 Skill 已经完成持久化；除非用户另行明确要求，不再写入 MEMORY.md 或 daily memory。