mcpField
A
architect

architect

github.com/akshay-diwadkar开发173 次安装今天更新
代码仓库

关于 architect

architect 是用于确定项目结构方向并记录架构决策的仓库技能，不编辑实现文件。它引导机会发现、证据收集，并封存架构记录。

主要功能

  1. 01选择目标前进行机会发现
  2. 02按架构协议审查证据
  3. 03记录结构决策及其后果
  4. 04在仓库中封存架构记录

适用场景

  1. 01判断变更是否需要结构性重设计
  2. 02记录责任边界与架构约束
  3. 03在 blueprint 规划前整理未知事项和证据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/akshay-diwadkar/first-four-hours --skill architect

安装后在 Claude Code 中输入/architect确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
skill-protocol.json
agents/
openai.yaml
references/
architecture-protocol.md
architecture-template.md
calibration-examples.md
delegation-protocol.md
opportunity-discovery.md
structural-techniques.md
worked-examples.md
scripts/
_diagnostic_contract.py
_skill_protocol_runtime.py
architecture_contract.py
architecture_handoff.py
architecture_workspace.py
cli.py
seal_assessment.py

详细介绍

架构师

职责范围

决定架构。若未提供目标，则在选择目标、no-design-change 或阻碍因素之前，先执行机会发现。为 blueprint 将已确定的内容封存到被忽略的 .first-four-hours/architectures/<slug>/architecture.md；不要编辑实现文件。

止步于架构。绝不判定实现层级、执行完整的传播审查、指定文件级编辑、编写测试或执行蓝图、安排迁移或发布，也不着手实现。这些职责归 blueprint 所有。路径和可选视图是证据线索，而非编辑指令。

工作流

  1. 遵循架构协议。在确定方案前、失败或方向改变后，以及封存前，咨询 reason。仅在协议或发现流程指出时，才加载结构技术。
  2. 仅将有界委派协议用于可选的证据工作者或经授权的专家审查。
  3. 根据交接模板起草。
  4. 仅在需要可选替代方案、用户策略或视图校准时，使用示例；在将目标限定于单个模块或类中，或选择 no-design-change 以外的任何结构之前，查看校准示例。
  5. 封存一次：
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。若封存失败，修复所指明的草稿或工作区冲突，然后重新运行。若证据发生变化，则根据新快照更新并封存。最终报告和停止报告应根据其 Checkpoint trace 追溯 reason 检查点。最后提供一个符合此结果的可选后续步骤：提供一段围栏包裹的完整提示词，并注明所需的任何仓库、问题、PR 或产物；或者说明不需要后续步骤。只有收到“yes”才启动该步骤，通过提示词中指定的任意 skill 启动；但用户必须自行以其 /<skill> 命令运行 charter、diagnose 或 ticket 步骤。

评论

支持 Markdown