// 维护 .ai_state/architecture/ 长效档案 (项目现状档). Refactor/System 路径完成后强制更新 ARCHITECTURE.md 总入口 + {type}-{slug}.md 子系统档. 注: 不同于 cx 端的 architect.toml subagent (后者是 design stage 工作者).
检查项目依赖 (库 / 包 / jar) 是否有可升级版本, 适配多生态: Maven / npm·pnpm·yarn·bun / PyPI / Cargo / Go / RubyGems / Composer / NuGet. 铁律: 版本号必须从官方 registry 在线查询, 不靠记忆/编造, 且区分 "声明的版本是否存在" 与 "是否最新". 用户要求"看有没有要更新的依赖"时使用.
Athena 主入口 skill. 接收用户任务, 做 PACE 路由分诊 (brainstorm/roadmap/plan/...), 启动对应 stage. v9.6.4 升级: 加 brainstorm + roadmap 分诊 (铁律 14), 加路由检测自动 ultrathink 提示.
Athena 项目初始化 skill. 在项目中执行 /athena-init 时调用. 职责: 探测平台 / 工具可用性, 创建 .ai_state/ 目录 + 复制 _index.md 模板 + 填入探测结果.
Athena 版本迁移工具. v9.6.4 重写: 含 v9.6.2 → v9.6.4 破坏式重构 (sprints/ + compound/ + 4 新 ai_state 文件 + lessons.md 三选项交互).
PACE review stage 执行 skill. v9.6.4 升级: 6 维度 (并行 spawn 3 subagent: reviewer + spec-compliance + evaluator).
快速查看当前项目的 Athena 状态: stage / path / sprint / 进度 / 活动 worktree. 无副作用, 只读.
| 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/ 不归档 (永远是现状).
见 ~/.claude/skills/pace/templates/architecture/