SuperAPI AI 工具集

architect

编程与开发

查看项目

更新于 10-16 02:01

技能介绍

用途

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,则跳过深度分析阶段。
  • 具体收费、价格、平台支持范围等事实暂未提供。