用途:为 Java 项目生成架构决策记录(ADR),通过交互式对话系统性地收集撰写结构化 ADR 所需的决策输入。这是一个交互式 SKILL,仅使用当前对话和当前会话中明确可用的仓库文件,不暴露、持久化或复用无关的用户/项目上下文。
主要能力:ADR 文件存储配置;对话式信息收集,涵盖背景、利益相关者、决策驱动因素、带优缺点的选项、结果与影响;按 MADR 模板生成 ADR 文档。
使用方式:先加载本技能的 references/030-architecture-adr-general.md,然后仅通过当前对话引导用户提供利益相关者、决策驱动因素、选项与权衡;随后综合并确认推荐选项、理由与后果,在用户确认后再生成 ADR 产物,输出包含最终决策、备选方案、后果与后续行动的 MADR 风格文档。
适用场景:生成 ADR、创建架构决策记录、记录架构或技术决策、架构文档、记录设计决策、技术选型文档、框架选择 ADR、数据库选择 ADR、架构权衡、技术备选方案评估、部署策略 ADR、基础设施选择、供应商选择 ADR 等。
限制:需显式处理歧义与阻塞,避免隐含假设。若用户目标不明确,应停止并先提出澄清问题,再编辑文件或运行项目级命令;若缺少必要上下文、文件、凭据或工具,应明确报告阻塞并询问是否继续设置或提供回退指引;若请求的变更与项目约束或安全边界冲突,应说明冲突并请用户确认取舍。详细指引、示例与约束见 references/030-architecture-adr-general.md。