SuperAPI AI 工具集

architect

编程与开发

查看项目

更新于 11-06 16:21

技能介绍

用途

architect 用于在蓝图规划之前,基于仓库实际情况做出架构决策。它处理的是结构性判断:边界如何划分、依赖方向如何确定、状态归属谁、抽象层次如何取舍、模块如何整合等。它不负责实现层面的工作。

主要能力

  • 在未提供目标时,先执行 Opportunity Discovery,再选择目标架构、不做设计变更或标记阻碍三种结果之一。
  • 依据 Architecture Protocol 推进架构工作,并在确定方案前、失败或方向改变后、以及封存前查阅 reason 检查点。
  • 仅在协议或发现过程指向需要时加载 Structural Techniques。
  • 对可选的证据工作者或必要的专家评审,使用 Bounded Delegation Protocol。
  • 按 Handoff Template 起草架构文档。
  • 在单个模块或类内框定目标、或选择非“无设计变更”的结构之前,可参考 Calibration Examples 进行校准。
  • 将已确定的结构性事实持久化:压力或无变更结果、所有者与边界、约束、选定的架构、后果、证据、与信任相关的未知项,以及任何用户自有策略。

使用方式

按以下流程工作:遵循 Architecture Protocol,在关键节点查阅 reason,从 Handoff Template 起草,然后执行封存命令:

python /absolute/skill-root/scripts/cli.py --repo-root /absolute/repo \
  --input draft=/absolute/architecture-draft.md \
  --input slug=<architecture-slug> --format json run

命令返回 status: complete 且 result.path 指向 .first-four-hours/architectures/<slug>/architecture.md 时才算完成,并需报告 result.git_ignored。若封存失败,应修复指定的草稿或工作区冲突后重跑;若证据发生变化,应基于新快照刷新并重新封存。最终报告需按 reason 的 Checkpoint trace 追溯各检查点。

适用场景

适用于在实现开始前需要明确仓库级架构边界的场景,例如确定模块划分与依赖方向、厘清状态所有权、评估抽象是否合理、判断是否应整合模块,或决定是否根本不需要设计变更。

限制

该技能止步于架构层。它不会对实现进行分级,不执行完整的传播扫描,不规定文件级修改,不编写测试或执行蓝图,不安排迁移或发布顺序,也不对具体实现进行攻击性审查——这些属于蓝图阶段的职责。文档中的路径与可选视图只是证据定位,不是修改指令。结束时应给出一个可选的下一步:一个自包含的围栏提示,指明所需的仓库、issue、PR 或产物,或说明无需下一步;只有用户回复“yes”才通过它指定的技能启动。