SuperAPI AI 工具集

spec-driven-development

编程与开发

查看项目

更新于 10-16 08:00

技能介绍

用途:该技能要求在每次编码任务、功能请求或架构讨论中使用,指导智能体选用正确模板、理解 Constitution 的整合作用、判断何时拆分模块,并跟踪哪些内容已实现、哪些仍待完成。

模板层级:CONSTITUTION_TEMPLATE.md 是整合所有决策的唯一事实来源;PRODUCT_FEATURE_TEMPLATE.md 用于任何用户可见的新能力;COMPONENT_TEMPLATE.md 用于内部模块,仅当功能需要拆分时使用;ARCHITECTURE_DECISION_RECORD_TEMPLATE.md 用于重大且不可逆的变更;AGENT_TEMPLATE.md 在每个 LLM 会话中加载。

关键分离原则:AGENT_TEMPLATE 与 CONSTITUTION_TEMPLATE 不得重叠或重复内容。Constitution 是产品不可变规则,被每个规范引用;AGENT_TEMPLATE 仅包含面向 LLM 的行为指令。智能体提示应始终写“加载并执行 Constitution”,但绝不重述其规则,违反须立即纠正。

实现与待定约定:所有规范存放在 /specs/ 下,特征位于 /specs/features/pending/ 与 /specs/features/implemented/,组件位于 /specs/components/pending/ 与 /specs/components/implemented/。新规范先放入对应的 pending/;编码智能体完成实现后的最后动作是在同一提交中执行 git mv,把文件从 pending/ 移到 implemented/。

使用时机:初次设置时创建 /specs/ 目录结构、编写首个 Constitution、把 AGENT_TEMPLATE 加载到主 LLM 编码智能体;新增功能时从 PRODUCT_FEATURE_TEMPLATE.md 创建文件放入 /specs/features/pending/;创建模块时仅在单个功能规范过大(超过 50 条需求或多个内部关注点)时,从 COMPONENT_TEMPLATE.md 创建文件放入 /specs/components/pending/;重大架构变更时立即创建 ADR 并从相关规范链接。

工作流:确认 Constitution 存在;按上述判断所需模板;无规范则在正确 pending/ 中创建;规范附给智能体后先写简短实现计划,只实现规范所写内容,为每条验证标准提供完整代码与测试,给出映射回规范与 Constitution 的合规清单;最后 git mv 到 implemented/ 并一起提交。

禁止事项:AGENT_TEMPLATE 与 CONSTITUTION 重叠或重复、跳过 Constitution 引用、添加规范外内容、无 ADR 做重大架构变更、实现后仍把规范留在 pending/。资料未提供该技能的价格、平台或效果等信息。