SuperAPI AI 工具集

skill-draft-ship

智能体与模型

查看项目

更新于 10-15 22:12

技能介绍

用途:在仓库中持久化一个已选定的技能提案,或在通过全部人工与组合门禁后发布已评审提案。它不执行受理、路径选择、用途评审、组合评审或隐式路由,必须显式调用。

调用方式:在 Cursor 或 Claude Code 中使用 /skill-draft-ship,在 Codex 中使用 $skill-draft-ship,也可直接写 skill-draft-ship。

仓库事实来源:先用 git rev-parse --show-toplevel 解析 repo_root,要求存在 WORKFLOW.md、skills/INDEX.md 及所选模式需要的同级 SKILL.md;同级说明只从 <repo_root>/skills/ 读取,不使用全局安装副本作为来源或回退。发现失败则返回 blocked 且不写入。草稿写入限于 <repo_root>/.skill-proposals/<skill_name>/,发布写入限于已批准的 skills/<skill_name>/ 及 skills/INDEX.md、README.md。

输入契约:draft 模式需要 mode: draft、完整清单(purpose、audience、when_to_use、when_not、success_signal、boundaries、context、output_format、skill_name、skill_summary、可选 invocation、replace: none|proposal|shipped|both)以及 verdict 为 methodology 或 procedural 的路径结果;methodology 还需未修改的 methodology-selector 契约与选择。ship 模式需要 mode: ship、明确的人工发布语句、确切的草稿路径、purpose_pass,以及 composition_ok 或人工组合跳过说明;目标已存在时还需本次发布中新的 ship_replace: true 人工语句。

冲突规则:省略替换权限按 replace: none 处理,不得推断升级。proposal 目标需 proposal 或 both;shipped 目标需 shipped 或 both,且只创建替换提案、不动已发布包;both 目标需 both,只替换提案。权限仅在人工于当前任务中指明 skill_name 与目标类型时有效,否则返回 blocked 并给出类型与确切路径。

流程:draft 模式先解析仓库并校验输入,写入前复查冲突;methodology 直接运行仓库的 methodology-skill-creator,不经过 loop-orchestrator;procedural 按仓库风格撰写单个 SKILL.md;验证通过后只写一个提案并返回 draft_created,等待单独的 skill-review。ship 模式校验全部门禁,组合通过后任何草稿编辑都会使证据失效;复制草稿到 skills/,更新 INDEX.md 与 README Meta 列表,全部成功后才删除提案,失败则保留草稿。

结果:成功返回 draft_created 或 shipped;失败返回 blocked,含 code(repo_root_missing、missing_dependency、invalid_input、collision、validation_failed、ship_gate_failed)、缺失依赖、冲突类型与路径及 required_action。

限制:不执行受理、不调用 skill-brief、不选择路径、不选择方法论、不判断用途、不调用 skill-composition(ship 模式只要求其产物)、draft 模式不写 skills/<name>/、不提交、不推送、不全局安装、不编辑仓库外文件。替换提案、为已发布名称创建替换草稿、替换已发布包、跳过组合或发布前均需人工批准;每次只完成一个草稿、一次发布或一个 blocked 结果。