SuperAPI AI 工具集

skill-design-loop

智能体与模型

查看项目

更新于 10-15 22:12

技能介绍

用途:将一次显式提供的技能设计意图,在同一任务内依次经过仓库预检、受限需求收集、路径选择,并最多产出一份提案草稿;在目的评审、组合评审或发布之前停止,保留同级技能契约。

调用方式:在 Cursor 或 Claude Code 中使用 /skill-design-loop,在 Codex 中使用 $skill-design-loop,或直接写 skill-design-loop。必须显式调用,普通技能设计讨论不会激活该流程。

输入:接受自由形式的技能想法、部分清单或完整清单。规范化清单字段包括 purpose、audience、when_to_use、when_not、success_signal、boundaries、context、output_format、skill_name、skill_summary、invocation(可选)、replace(none|proposal|shipped|both)。省略的 replace 规范化为 none,不虚构清单值或替换权限。

仓库事实来源:用 git rev-parse --show-toplevel 解析 repo_root,要求存在 WORKFLOW.md、skills/INDEX.md 及当前阶段所需的同级 SKILL.md;只从 <repo_root>/skills/ 读取并执行同级指令,不使用全局安装内容作为来源或回退。始终要求 skill-brief、skill-path-selector、methodology-selector、skill-draft-ship;仅在需求缺口需提问时要求 grill-me,仅在方法论判定后要求 methodology-skill-creator。发现失败则返回 blocked 且不写入。唯一草稿目标为 <repo_root>/.skill-proposals/<skill_name>/。

状态机:preflight 解析仓库并校验依赖;intake 即使清单看似完整也进入,缺失字段时用 skill-brief 逐题提问,默认最多八个决策问题,预算耗尽仍缺字段则 blocked;selection 应用 skill-path-selector,decompose 返回更小技能列表且不写入,blocked 返回证据且不写入,methodology 或 procedural 继续,并检查 proposal、shipped、both 冲突门;draft 在 methodology 判定时要求 methodology-skill-creator,调用 skill-draft-ship 草稿模式,生成一份 draft_created 后停止,不运行评审、组合、修订、发布、安装、提交或推送。

终止结果:draft_created、decompose 或 blocked,各含 stage_trace、checklist、path、next 等字段。验证命令:node skills/skill-design-loop/scripts/self-test.mjs。

限制:不使用全局同级包作为来源或回退;不在当前仓库外写入;blocked 或 decompose 时不写提案;无当前任务人类明确授权不替换目标;不吸收同级判断或复制其契约;不评审、修订、组合、发布、安装、提交或推送。提案替换、已发布名称的替换意图、跳过组合或发布需人类批准,本技能只负责前两项。