SuperAPI AI 工具集

crank-spec

写作与研究

查看项目

更新于 10-15 20:12

技能介绍

用途:把与用户讨论的内容或用户的想法,整合成一份自包含的规格文档,一半是 PRD(面向用户的意图),一半是技术规格(已经确定的技术决策)。适用场景是用户要求 spec out 或撰写规格时。

主要能力:先就悬而未决的技术决策逐条询问用户(每次一个问题,先给出推荐答案与权衡);将草稿写入操作系统临时文件 $(mktemp -t crank-spec).md,除非用户明确要求否则不写入工作目录;引用真实文件时使用 path:line 形式;随后由一个重型子代理依据评审简报对规格进行对抗性评审,并把评审摘要回报给用户。

文档可包含:问题、解决方案、用户故事、验收标准、技术决策、测试方案、重构范围、范围之外等章节,按主题规模伸缩。

必要用法:在技术决策草拟前先并行派发标准子代理对代码库做 grounding,查找现有同类功能与约定;对未决且材料性的技术决策逐一访谈用户;草稿按 SPEC-TEMPLATE.md 模板撰写;评审使用 SPEC-REVIEW-BRIEF.md;交互式 HTML 评审依据 HTML-REVIEW.md,仅在用户选择时渲染。子代理层级需按 SUBAGENT-TIERS.md 显式设置,不可留空默认。

限制与约束:禁用 TODO、TBD、for later、v2 等占位语言,未决项要么当场解决,要么移入范围之外并说明原因;不要重新讨论已确定的内容;只在代码库无法回答时向用户提问。

其他细节:官方文档与收费信息暂未提供。