用途:architect-init 是一个面向棕地(已有代码库)项目的技能,通过反向工程从现有代码中推导架构决策,生成架构决策记录(ADR)。它关注“当前实现是什么”,而非“应该是什么”,可与 /architect-specify(面向新项目的可能性探索)区分使用。适用棕地项目、遗留系统现代化前的现状理解、团队快速上手文档化隐式决策、技术债评估等场景;已存在架构文档或新建项目时不适用。
主要能力:作为“架构考古学家”,扫描代码库中的技术选型与模式,从代码结构推断架构决策,按子系统和 Rozanski & Woods 视图生成 ADR,并识别决策不清晰之处。输出位于 {REPO_ROOT}/.adlc/drafts/adr/ADR-{NNN}.md(每份单独文件),并自动生成索引 {REPO_ROOT}/.adlc/drafts/adr/adr.md。
使用方式:技能接收用户输入(可为空,空则扫描整个代码库),支持子命令式参数与标志:--adr-heuristic 可选 surprising(默认,跳过生态默认项,只记录意外或高风险决策)、all(记录全部发现)、minimal(仅高风险决策);--no-decompose 关闭自动子系统检测。流程包含:子系统检测(Phase 0,自动检测,多个模块时运行,需用户确认,4 个以上子系统必须确认)、代码库扫描、文档去重、模式识别、按子系统生成 ADR、差距分析,随后运行 /architect-clarify 校验发现。脚本位于 {REPO_ROOT}/.agents/skills/architect-clarify/scripts/bash/setup-architect.sh,需先安装 architect-clarify 技能:adlc-cli skills add tikalk/adlc-team-skills --skill architect-clarify。
限制:不创建 AD.md;不虚构决策的拒绝理由;生成 ADR 的置信度标注为 HIGH/MEDIUM/LOW;需要已有代码库和相关技能支持。其他未在资料中说明的平台、收费或效果信息暂未提供。