SuperAPI AI 工具集

write-a-spec

编程与开发

查看项目

更新于 10-15 22:38

技能介绍

用途:把"决定要建"转化为"如何构建"的契约。规范派生自已通过的提案(ACCEPTED proposal),先映射当前系统再提出变更,并将单向门选择记入决策日志。

主要能力与执行顺序:硬性门禁不可跳过。步骤0查找父提案(ls -A proposals/、ls -A decisions/、search、cat 读取);无提案需用户确认后才可继续。步骤1用宿主原生工具读取真实代码,用 OpenKnowledge 动词读取知识库,先写当前系统映射并附文件指针。步骤2为范围确认门禁,监督模式下需等待确认。步骤3创建 specs/NNN-name/spec.md 并填 frontmatter。步骤4写 Goals/Non-goals,非目标附原因。步骤5设计分当前系统与拟议变更两层。步骤6追加 Decision Log。步骤7维护 Open Questions 待办。步骤8写 Migration 与 Test plan,命名真实状态与测试层级。步骤9在真正开建时才创建 plan.md 与 tasks.md(模板 spec-plan、spec-tasks,parent_spec: ./spec.md)。步骤10链接与校验(audit、links)。

用法:通过 skills.sh 获取该技能包;平台 /open-knowledge 技能仍统管所有 markdown 操作。写入用 write({ document: { path: ..., template: "spec" } }),读取用 exec 与 search。

限制:监督模式默认在范围门禁停止等待用户;无通过的父提案属风险信号,需显式确认并记入决策日志。具体安装命令、收费、平台支持及更多细节暂未提供。