القائمة
维护 .ai_state/architecture/ 长效档案 (项目现状档). Refactor/System 路径完成后强制更新 ARCHITECTURE.md 总入口 + {type}-{slug}.md 子系统档. 注: 不同于 cx 端的 architect.toml subagent (后者是 design stage 工作者).
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Athena 全局首次配置 (跨项目, 一次性). 从分发包部署 settings/config/rules/standards/hooks/agents/skills 到 ~/.claude/ (CC) 与 ~/.codex/ (CX). 和 athena-init 区别: setup 全局一次性, init 每项目一次. 已装则转 verify/upgrade (走 athena-migrate).
会话记忆固化 skill (v9.8.0 新). 会话结束/中途, agent 自己总结本会话增量写进 .ai_state (_index.md 当前状态 + sprints/{slug}/session-log.md), 免去用户每次手动描述一堆让它存. 手动 /checkpoint 触发. 与 compact-snapshot hook 互补 (hook 机械兜底, skill 做需推理的总结).
Athena 主入口 skill. 接收用户任务, 做 PACE 路由分诊 (brainstorm/roadmap/plan/...), 启动对应 stage. v9.7.0: 铁律引用名称化 (CC/CX 编号非对称, 引用一律用 铁律[名称]).
Athena 项目初始化 skill. 在项目中执行 /athena-init 时调用. 职责: 探测平台 / 工具可用性, 创建 .ai_state/ 目录 + 复制 _index.md 模板 + 填入探测结果.
Bugfix 路径的结构化问题流程: report → analyze → fix-note 三件套档案, 落在 sprints/{slug}/. 把"偏轻"的 Bugfix 升级成可复现 / 可追溯 / 可复盘. 借 CodeStable issue 实体, 适配 agent-in-loop.
Athena 版本迁移工具. v9.6.4 重写: 含 v9.6.2 → v9.6.4 破坏式重构 (sprints/ + compound/ + 4 新 ai_state 文件 + lessons.md 三选项交互).
| name | architect-doc |
| description | 维护 .ai_state/architecture/ 长效档案 (项目现状档). Refactor/System 路径完成后强制更新 ARCHITECTURE.md 总入口 + {type}-{slug}.md 子系统档. 注: 不同于 cx 端的 architect.toml subagent (后者是 design stage 工作者). |
| effort | medium |
| 时机 | 强制度 | 责任 |
|---|---|---|
| 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/ 不归档 (永远是现状).
见 ~/.codex/skills/pace/templates/architecture/