メニュー
维护 .ai_state/architecture/ 长效档案 (项目现状档). Refactor/System 路径完成后强制更新 ARCHITECTURE.md 总入口 + {type}-{slug}.md 子系统档. 注: 不同于 cx 端的 architect.toml subagent (后者是 design stage 工作者).
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/WenJunDuan/Rlues --skill architect-docコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
SOC 職業分類に基づく
| name | architect-doc |
| description | 维护 .ai_state/architecture/ 长效档案 (项目现状档). Refactor/System 路径完成后强制更新 ARCHITECTURE.md 总入口 + {type}-{slug}.md 子系统档. 注: 不同于 cx 端的 architect.toml subagent (后者是 design stage 工作者). |
| 时机 | 强制度 | 责任 |
|---|---|---|
| System 路径 ship 完成 | 强制 | 主 agent |
| Refactor 路径改动 ≥ 5 文件 | 强制 | 主 agent |
用户显式 /architect-doc update {type}-{slug} | 触发 | 主 agent |
| Feature 路径完成 (新增 endpoint / 新数据模型) | 可选 | 主 agent 判断 |
| athena-init 首次 | 创建 ARCHITECTURE.md 初版 | athena-init |
Refactor / System (≥ 5 文件) + stage=ship 时, delivery-gate hook 检查:
_index.path 和本 sprint 改动文件数 (从 evidence.yaml)architecture/ARCHITECTURE.md mtime ≥ 本 sprint 开始时间{type}-{slug}.md mtime ≥ 本 sprint 开始时间/architect-doc updateathena-init 时, 主 agent:
README.md / docs/architecture/ / ARCHITECTURE.md.ai_state/architecture/ARCHITECTURE.md 初版design.md + git diffsrc/{module}/ 路径模式)architect subagent (read-only sandbox, ultrathink) 生成 patch_index.pointers.latest_architecture_updateSystem 路径引入新子系统时:
api / db / auth / cache / frontend / backendinfra / messaging / monitoring / cli / libarchitecture/{type}-{slug}.md (从模板)ARCHITECTURE.md 索引段.ai_state/architecture/
├── ARCHITECTURE.md # 总入口 + 索引 (强制存在)
└── {type}-{slug}.md # 子系统档 (按需创建)
例:
api-rest.mddb-postgres.mdauth-jwt.mdcache-redis.mdfrontend-react.mdinfra-k8s.mdcompound/decision-*.md)design.md (sprint 一次性, 写"这次要改 X")
↓ ship 后
architecture/{type}-{slug}.md (长效, 写"X 现在长这样")
↓ 重大决策同步
compound/decision-*.md (永久, 写"为什么这样选")
三者各司其职, 不冗余.
跨季度时, 旧的 compound/ 和已 ship 的 sprints/ 自动归档:
.ai_state/archive-{quarter}/compound/ 只保留近 1 个季度 + 近 5 个 decision (永远保留所有 decision)architecture/ 不归档 (永远是现状).
见 ~/.agents/skills/pace/templates/architecture/