用途
Architect 用于在结构层面评估代码库是否组织良好。它通过分层分析推进:发现价值观(Teach)、广度扫描(Sweep)、深度分析(Deep Dive)、评估(Assess),以及可选的规划(Plan)与执行(Execute)。
该技能明确区别于代码审查(关注正确性)、代码简化(清理)以及 /ship(PR 前流水线)。/architect 关注的是代码库如何被组织——模块化、耦合、组合、框架契合度与结构一致性。
主要能力
- 价值观发现:首次运行每个项目时以对话方式了解项目的架构哲学与关键偏好,用于校准后续评估标准。
- 广度扫描:通过 7 个架构视角(结构组织、设计模式、组合与继承、耦合与内聚、框架契合度、API 与接口设计、重复与复用)快速扫描代码库,标记需要深入分析的区域。
- 深度分析:对扫描中标记为 yellow 或 red 的视角并行派发专门分析。
- 评估:呈现发现结果,与用户讨论,并生成评估产物(markdown 文件)。
- 规划与执行:按需提供分阶段实施策略,并调用写作计划进行重构。
使用方式
调用命令与行为:
/architect:完整运行:teach(如需要)> sweep > deep dive > assess/architect --teach:重新运行价值观发现/architect --sweep:仅做广度扫描,跳过深度分析/architect <target>:聚焦某个子系统(例如 "the dispatch system"、app/models)。如需要则运行 Teach,然后将扫描与深度分析限定到目标区域,并更新主评估产物。
多个标志可组合使用,例如 --teach 与目标组合会先重新发现价值观,再限定到该子系统。
项目检测:脚本通过 $HOME/.claude/skills/architect/scripts/architect.sh detect 获取项目信息(slug、root、configured)。若 slug 为空,则停止并提示:"Not in a git repository. /architect needs a git repo to work with."
适用场景
- 需要从结构层面评估代码库组织质量时。
- 需要针对某个子系统进行架构聚焦分析时。
- 需要基于项目自身架构哲学(而非单一标准)来评估结构问题时。
- 需要生成架构评估产物并可能规划重构时。
限制
- 需要处于 git 仓库中才能工作。
- 不用于代码正确性审查、代码简化或 PR 前流水线。
- 广度扫描为分诊性质,并非完整深度报告。
- 深度分析仅针对扫描中标记为 yellow 或 red 的视角;若全部为 green,则跳过深度分析阶段。
- 具体收费、价格、平台支持范围等事实暂未提供。