SuperAPI AI 工具集

create-adr-spike

写作与研究

查看项目

更新于 10-15 20:34

技能介绍

用途:为技术决策创建架构决策记录(ADR),并开展研究 spike,用统一的五阶段流程把研究、分析、决策和文档沉淀下来。

主要能力:五阶段工作流——研究(收集上下文、检索已有 ADR 与记忆、必要时查外部资料)、分析(至少 2-3 个备选方案,比较性能、可维护性、成本、团队匹配度、风险与取舍)、决策(给出明确推荐及理由、后果与缓解措施)、文档化(按模板生成 ADR,放入对应状态目录并编号)、记忆存储(在记忆图中创建实体与关系)。附带 ADR 与迁移模板、校验脚本和查找下一个编号的脚本。

使用方式:在需要记录架构决策、比较技术方案或评估库/框架/模式时调用。示例触发语如“Create an ADR for choosing between PostgreSQL and Neo4j for our graph storage”。文档结构规则:not_started/ 只放 ADR.md;in_progress/ 放 ADR.md 与 IMPLEMENTATION_PLAN.md,最多两个文件,不另建 RESEARCH.md、ANALYSIS.md 等。查找编号可用:find docs/adr -name "[0-9].md" | sed 's/./([0-9])-./\1/' | sort -n | tail -1,或运行 ./scripts/find_next_adr_number.sh。

适用场景:架构选型、重构或迁移规划、技术权衡记录、追溯既有架构决策。

限制:不适用于无架构影响的简单重构、缺陷修复、次要配置改动和日常维护;需要 docs/adr/ 目录结构、模板、记忆系统及相应工具权限;资料未提供具体收费、价格或平台信息。