用途:在项目中创建、更新或合并架构决策记录(Architecture Decision Records)。当用户提到 adr、创建 ADR、记录决策等时使用。
主要能力:区分创建、更新、合并、列出等操作;检测对话语言,英文用 references/template-en.md,西班牙文用 references/template-es.md;扫描 docs/adr、doc/adr、adr、docs/decisions 下已有 ADR,列出标题与日期并检查关联;从上下文收集背景、问题、备选方案、决策与后果,并比较各方案优缺点、架构影响、实现成本与风险;可结合可行性分析结果,并可选搜索配置的文档来源。
使用方式:先读取 ${CLAUDE_PLUGIN_ROOT}/config.yaml(不存在时记录警告后继续),检查 docs_sources 并搜索相关决策;随后判断操作、检测语言、扫描已有 ADR、收集上下文、生成 ADR。文件路径为 docs/adr/YYYY-MM-DD-<slug>.md,目录不存在则创建;若已有 ADR 使用数字前缀(如 001-),沿用该约定。更新时在原文增加 "## Update — {date}" 章节;合并时新建取代旧记录的整合 ADR,并将旧记录标记为 "Superseded by {new ADR}"。写入后展示内容与路径,并询问是否调整、标记为 Proposed、关联工单或提交。
限制:模板使用和语言检测须由用户语言或明确询问决定;不明确时应询问用户。资料未提供模板具体字段、config.yaml 结构及提交命令细节。