用途:arch-manage 用于创建或更新项目中被文档化的架构内容,分为两类文件——架构决策记录(ADR,位于 docs/adr/)和按领域划分的架构标准(位于 docs/standards/)。它的核心是区分“决策”与“标准”:ADR 记录某个时间点的技术选择及原因,属于历史性、叙事的、一经 Accepted 不再改动;标准则是某技术领域的规范性文档(如 Testing Standards),会随新决策持续增长和更新。
主要能力:先对输入分类,判断属于哪种情形——A 只有决策而无持续规则(只产出 ADR,emits 为空,不触碰 docs/standards/);B 决策同时确定持续可验证规则(产出 ADR 及写入对应领域标准的合规准则);C 只有规则或惯例而没有新决策(直接创建或更新标准、条目)。标准中的每个需求用 RFC 2119/RFC 8174 规范关键词(大写,如 MUST/SHOULD/MAY 或 DEBE/DEBERÍA/PUEDE 等)书写,并配可验证的合规准则(CR-XXX),必要时附带 fitness function,供 arch-audit 审计。文档间通过 emits(ADR 侧)与 source_adrs(标准侧)交叉引用,不复制内容。
使用方式:技能自带模板 assets/adr-template.md 与 assets/standard-template.md,写入前需读取对应模板;共享引用位于 ${PLUGIN_ROOT}/references/(如 language.md、linking.md、functional-domains.md、conventions.md、artifacts.md)。需先解析架构根(<raíz-arq>):若存在子模块或嵌套仓库,须询问决策归属哪个根,文档写入该根的 docs/ 下。执行前须读取并遵循 language.md 与 linking.md。
适用场景:为具体代码仓库记录架构选择、为领域建立或补齐可执行规范、将既有实践回溯记录为 ADR 等。
限制:输入若模糊不清(是否属于持续规则),需向用户确认,不自行裁定;存在冲突(同技术已有 Accepted ADR 或 Active 需求)时不直接撰写,而应告知并提供更新、新 ADR 并标记 Superseded 或调整范围等选项;不得虚构事实,缺失信息须询问。具体定价、平台与安装步骤资料暂未提供。