SuperAPI AI 工具集

architect-specify

通用与其它

查看项目

更新于 10-15 23:57

技能介绍

用途:architect-specify 是 tikalk/adlc-team-skills 提供的技能,把 PRD 或高层系统描述转化为有据可查的架构决策记录(ADR)。它强调先讨论与探索、再落地文档,目标是暴露权衡、验证假设并协作做出决策。适合新项目、重大变更、把口头决策写成正式 ADR,以及新人了解架构依据;不适合已有代码库(应使用 /architect-init)和小的 ADR 修订(应使用 /architect-clarify)。

主要能力:扮演解决方案架构师主持架构发现会议,探索方案及其权衡、提澄清问题、给出带后果的备选方案,达成共识后按 MADR 格式记录。参考 Rozanski & Woods 视角,以 Functional 视角为基石。支持子系统的自动分解与确认。支持参数 --views(core 默认:Context、Functional、Information、Development、Deployment;all 为全部 7 个视图;或逗号分隔自定义)、--adr-heuristic(surprising 默认跳过明显默认、all 记录全部、minimal 只记高风险或不常规决策)、--no-decompose 关闭自动分解。

使用方式:在系统层运行,ADR 写入 {REPO_ROOT}/.adlc/drafts/adr/ADR-{NNN}.md,架构描述为 {REPO_ROOT}/AD.md。REPO_ROOT 由从当前目录向上查找 .adlc 目录确定,不要用相对路径。需要先安装 architect-clarify 技能:adlc-cli skills add tikalk/adlc-team-skills --skill architect-clarify,并运行 {REPO_ROOT}/.agents/skills/architect-clarify/scripts/bash/setup-architect.sh。流程:子系统检测(Phase 0)、按子系统解析 PRD、加载 {REPO_ROOT}/docs/adlc/memory/constitution.md(旧路径 {REPO_ROOT}/.adlc/memory/constitution.md 作为回退)、交互探索(Phase 2)、决策记录(Phase 3),状态必须为 Proposed,需经 /architect-clarify 批准。

限制:这是交互式命令,需要用户参与。子系统检测来自 PRD 分析而非代码结构;识别出 4 个及以上子系统时必须获得用户确认,超过 6 个必须建议分组并确认。生成 ADR 时状态不得直接设为 Accepted。资料未提供收费、价格或平台支持等信息。