Rlues

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 三选项交互).

维护 .ai_state/requirements/ 长效需求档 (软件要素: 为什么要这个能力). 原始用户故事 + 当时权衡, 独立于会演化的 design.md —— 代码烂掉时弃码重生的逃生通道. 借 CodeStable requirements 实体, 适配 agent-in-loop: 需求落盘可召回, 隐知识不丢.

PACE impl 后的运行时验证环 (v9.8.0 新). 用官方 /goal 承载"实跑接口→自测自改→模拟环境/数据"自驱循环, 补 PACE 只单测不实跑的洞. System/Refactor 强制, Feature 可选, Bugfix/Quick/Hotfix 跳过. Loop Engineering 落地: DOER (generator 改代码) + CHECKER (/goal supervisor + delivery-gate), 不自批不自造 loop.

快速查看当前项目的 Athena 状态: stage / path / sprint / 进度 / 活动 worktree. 无副作用, 只读.

PACE 路由 + 9 stage 状态机. Athena 项目的中枢. 主 agent 进入任何 sprint 前必读. v9.7.0: 热路径精简 (铁律[三原语]). 本文件只保留路由判断; stage 详解 / 编排路由表 / hook 联动下沉 references/, 按需 Read.

PACE polish stage. Refactor/System 路径强制. 5 检查项 + worktree 清理 + 触发 architecture 更新. 含 finishing-a-development-branch 流程 (借 Superpowers) + compound/ 触发.

会话记忆固化 skill (v9.8.0 新, Codex). 会话结束/中途, 主 thread 自己总结本会话增量写进 .ai_state (_index.md 当前状态 + sprints/{slug}/session-log.md), 免去用户每次手动描述一堆让它存. 手动 /checkpoint 触发. 与 compact-snapshot.py hook (0.129+) 互补.

Athena 主入口 skill (Codex). 接收用户任务, 做 PACE 路由分诊 (brainstorm/roadmap/plan/...), 启动对应 stage. v9.7.0: 由 deprecated prompts/ 迁为 skill; 修 CC 残留 (session-start.cjs→py); 铁律引用名称化.

Athena 项目初始化 skill (Codex). 在项目中说"初始化 Athena"/"athena init"时触发. 职责: 探测平台 / 工具可用性, 创建 .ai_state/ 目录 (v9.6.4 schema) + 复制 _index.md 模板 + 填入探测结果. v9.7.0: 文件名修正 athena-init.md → SKILL.md (config.toml [[skills.config]] 指向 SKILL.md, 旧文件名导致加载失败).

Bugfix 路径的结构化问题流程: report → analyze → fix-note 三件套档案, 落在 sprints/{slug}/, Codex. 把"偏轻"的 Bugfix 升级成可复现 / 可追溯 / 可复盘. 借 CodeStable issue 实体, 适配 agent-in-loop.

Athena 版本迁移工具. 含 v9.6.2 → v9.6.4 破坏式重构 (sprints/ + compound/ + lessons.md 三选项交互). v9.7.0: 由 deprecated prompts/ 迁为 skill; 修 Step 7 跨端命令残留 (node ~/.claude/… → python3 ~/.codex/hooks/…).

维护 .ai_state/requirements/ 长效需求档 (软件要素: 为什么要这个能力), Codex. 原始用户故事 + 当时权衡, 独立于会演化的 design.md —— 代码烂掉时弃码重生的逃生通道. 借 CodeStable requirements 实体, 适配 agent-in-loop: 需求落盘可召回, 隐知识不丢.

PACE impl 后的运行时验证环 (v9.8.0 新, Codex). 用 Codex Goals 承载"实跑接口→自测自改→模拟环境/数据"自驱循环, 补 PACE 只单测不实跑的洞. System/Refactor 强制, Feature 可选, Bugfix/Quick/Hotfix 跳过. Loop Engineering 落地: DOER (generator 改) + CHECKER (Goals 完成判定 + delivery-gate), 不自批不自造 loop.

快速查看当前项目的 Athena 状态: stage / path / sprint / 进度 / 活动 worktree. 无副作用, 只读. v9.7.0: 由 deprecated prompts/ 迁为 skill.

PACE 路由 + 9 stage 状态机. Athena 项目的中枢. 主 agent 进入任何 sprint 前必读. v9.7.0: 热路径精简 (铁律[三原语]). 本文件只保留路由判断; stage 详解 / 编排路由表 / hook 联动下沉 references/, 按需 Read.

PACE polish stage. Refactor/System 路径强制. 5 检查项 + worktree 清理 + 触发 architecture 更新. v9.6.4 升级: 加 finishing-a-development-branch 流程 (借 Superpowers), 加 compound/ 触发.

维护 .ai_state/architecture/ 长效档案 (项目现状档). Refactor/System 路径完成后强制更新 ARCHITECTURE.md 总入口 + {type}-{slug}.md 子系统档. 注: 不同于 cx 端的 architect.toml subagent (后者是 design stage 工作者).

Athena 主入口 skill (Codex). 接收用户任务, 做 PACE 路由分诊 (brainstorm/roadmap/plan/...), 启动对应 stage. v9.7.0: 由 deprecated prompts/ 迁为 skill; 修 CC 残留 (session-start.cjs→py); 铁律引用名称化.

Athena 项目初始化 skill (Codex). 在项目中说"初始化 Athena"/"athena init"时触发. 职责: 探测平台 / 工具可用性, 创建 .ai_state/ 目录 (v9.6.4 schema) + 复制 _index.md 模板 + 填入探测结果. v9.7.0: 文件名修正 athena-init.md → SKILL.md (config.toml [[skills.config]] 指向 SKILL.md, 旧文件名导致加载失败).

Athena 版本迁移工具. 含 v9.6.2 → v9.6.4 破坏式重构 (sprints/ + compound/ + lessons.md 三选项交互). v9.7.0: 由 deprecated prompts/ 迁为 skill; 修 Step 7 跨端命令残留 (node ~/.claude/… → python3 ~/.codex/hooks/…).

Athena 全局首次配置 (Codex 端, 跨项目一次性). 部署 config.toml / hooks / agents / standards / skills 到 ~/.codex/. 和 athena-init 区别: setup 全局一次性, init 每项目一次. v9.7.0: 文件名修正为 SKILL.md (config.toml 指向 SKILL.md); 修 stale 计数 (CC hooks 14 / agents 5); CX hooks 增至 10 个 .py.

PACE 可选最早 stage. 用户想法模糊时通过对话理清楚. AI 角色: 思考伙伴, 挖用户真正想解决的问题, 必要时提出更好的替代方案. 完成后产出 sprints/{date}-{slug}/brainstorm.md 并路由到 plan / roadmap / direct design.

Compound Learning Loop. 跨 sprint 积累的经验沉淀到 compound/, 按 doc_type 分文件存档. 4 种 doc_type: learning / trick / decision / explore. v9.6.4 重写 (替代 v9.6.2 单文件 lessons.md). 铁律 13: 一事一档, ≤100 行.

PACE 路由 + 8 stage 状态机. Athena 项目的中枢. 主 agent 进入任何 sprint 前必读. v9.7.0: 热路径精简 (铁律[三原语]). 本文件只保留路由判断; stage 详解 / 编排路由表 / hook 联动下沉 references/, 按需 Read.

PACE polish stage. Refactor/System 路径强制. 5 检查项 + worktree 清理 + 触发 architecture 更新. v9.6.4 升级: 加 finishing-a-development-branch 流程 (借 Superpowers), 加 compound/ 触发.

PACE 可选 stage. 大需求 (跨 ≥3 模块) 拆成子 feature 序列. 产出 .ai_state/roadmap/{slug}/items.yaml + roadmap.md. 每个子 item 完成后回写 status, 主 agent 自动进入下一个 item 的 plan stage.

Athena 主入口 skill. 接收用户任务, 做 PACE 路由分诊 (brainstorm/roadmap/plan/...), 启动对应 stage. v9.7.0: 铁律引用名称化 (CC/CX 编号非对称, 引用一律用 铁律[名称]).

PACE review stage 执行 skill. 6 维度 (并行 spawn 3 subagent: reviewer + spec-compliance + evaluator). v9.7.0: 清除 Stop hook prompt 类型残留引用 (该 hook 类型已于 v9.6.4-hotfix2 删除, 门禁统一由 delivery-gate 在 ship stage 执行).

PACE 可选最早 stage. 用户想法模糊时通过对话理清楚. AI 角色: 思考伙伴, 挖用户真正想解决的问题, 必要时提出更好的替代方案. 完成后产出 sprints/{date}-{slug}/brainstorm.md 并路由到 plan / roadmap / direct design.

Compound Learning Loop. 跨 sprint 积累的经验沉淀到 compound/, 按 doc_type 分文件存档. 4 种 doc_type: learning / trick / decision / explore. 铁律[复利]: 一事一档, ≤100 行.

PACE 路由 + 8 stage 状态机. Athena 项目的中枢. 主 agent 进入任何 sprint 前必读. v9.7.0: 热路径精简 (铁律[三原语]). 本文件只保留路由判断; stage 详解 / 编排路由表 / hook 联动下沉 references/, 按需 Read.

PACE polish stage. Refactor/System 路径强制. 5 检查项 + worktree 清理 + 触发 architecture 更新. 含 finishing-a-development-branch 流程 (借 Superpowers) + compound/ 触发.

项目级 Athena 偏好设置 (e.g. skip_polish, default_path, 优先工具). v9.7.0: 由 deprecated prompts/ 迁为 skill (可隐式调用).

PACE review stage 执行 skill (Codex). 6 维度 (并行 spawn 3 subagent: reviewer + spec-compliance + evaluator). v9.7.0: 由 deprecated prompts/ 迁为 skill; 清除 Stop hook prompt 类型残留引用 (该类型已删, 门禁统一由 delivery-gate 在 ship stage 执行).

快速查看当前项目的 Athena 状态: stage / path / sprint / 进度 / 活动 worktree. 无副作用, 只读. v9.7.0: 由 deprecated prompts/ 迁为 skill.