SuperAPI AI 工具集

030-architecture-adr-general

编程与开发

查看项目

更新于 10-16 05:48

技能介绍

用途:为 Java 项目生成架构决策记录(ADR),采用交互式对话方式,系统性地收集产出结构化 ADR 文档所需的全部上下文。

主要能力:包含 ADR 文件存储配置;通过对话收集上下文、干系人、决策驱动因素、含优缺点的备选方案、结果与影响;生成 MADR 模板文档。

工作流:先读取 references/030-architecture-adr-general.md 参考文件并收集上下文,再综合并确认决策(汇总推荐选项、理由与后果,并在生成前与用户确认一致性),最后生成包含最终决策、备选方案、后果及后续行动的 MADR 风格 ADR 文档。

适用场景:生成 ADR、撰写架构决策记录、记录技术/设计决策、架构文档、技术选型记录、框架选择、数据库选型、架构权衡、技术备选方案评估、部署策略、基础设施选择、供应商选择等。

限制与边界情况:遇到歧义或阻碍需明确指出,避免隐含假设。若用户目标不明确,应停止并先提出澄清问题,之后再编辑文件或运行项目级命令;若缺少必需上下文、文件、凭据或工具,应明确报告阻碍并询问是继续配置还是提供回退方案;若请求的变更与项目约束或安全边界冲突,应说明冲突并请用户确认偏好的取舍。

详细指导、示例与约束见 references/030-architecture-adr-general.md。