SuperAPI AI 工具集

plan-3a-v2-adr

通用与其它

查看项目

更新于 10-15 22:40

技能介绍

用途:从功能规格(spec)及澄清内容生成领域感知的架构决策记录(ADR),保存到 docs/adr/,并建立交叉链接,供 /plan-3-v3-architect 与 /plan-5-v2 导入约束。

主要能力:读取 spec(必填)与 plan(可选),加载 docs/project-rules 下的 doctrine 文件对齐约束;并行运行 5 个研究子代理(现有 ADR 扫描、doctrine 映射、决策提取、备选方案分析、领域影响分析);生成含 Front Matter 与固定章节的 ADR,包含 Context、Decision、Domain Impact、Consequences、Alternatives Considered、Implementation Notes、References;执行编号与原子写入,更新 docs/adr/README.md 索引,并向 spec、plan、领域文档及 domain-map 回链。

使用方式:通过参数调用,如 --spec(必填,spec 绝对路径)、--plan、--title、--status、--stakeholders、--replace NNNN、--non-interactive、--supersedes NNNN。编号通过扫描 docs/adr/adr-*.md 取最大值加一,写入临时文件校验后原子重命名。

适用场景:需要为架构决策生成正式 ADR、维护 ADR 索引与领域文档一致性、追踪决策对领域边界与契约影响的工程流程。

限制:--spec 缺失即中止;ADR 章节与编码有严格校验(如 POS-001、ALT-002,至少 3 条 POS、3 条 NEG、2 个备选方案);状态仅限 Proposed、Accepted、Rejected、Superseded、Deprecated;日期须为 YYYY-MM-DD;Domain Impact 章节必填且 domains 至少一个 slug。资料未提供具体收费、平台支持或效果数据。