/athena-setup — Athena 全局首次配置 (Codex, v9.7.0)
触发
第一次安装 Athena 时跑一次. 之后跨项目复用.
CX 端步骤
Step 1: 复制 config.toml
[ -f ~/.codex/config.toml ] && cp ~/.codex/config.toml ~/.codex/config.toml.pre-athena
mkdir -p ~/.codex
cp cx/.codex/config.toml ~/.codex/config.toml
# 把模板中的 <USER_HOME> 替换为实际 $HOME (config.toml 里 skills 路径用到)
sed -i "s|<USER_HOME>|$HOME|g" ~/.codex/config.toml
Step 2: 复制 hooks.json
[ -f ~/.codex/hooks.json ] && cp ~/.codex/hooks.json ~/.codex/hooks.json.pre-athena
cp cx/.codex/hooks.json ~/.codex/hooks.json
# 注: Codex 同时支持 hooks.json 与 config.toml inline [hooks]; 本项目用 hooks.json,
# config.toml 不放 [hooks] 表 (同层两者并存会 warn). hooks 默认启用.
Step 3: 复制 hooks/ Python 脚本 (10 个 .py)
mkdir -p ~/.codex/hooks
cp cx/.codex/hooks/*.py ~/.codex/hooks/
chmod +x ~/.codex/hooks/*.py
ls ~/.codex/hooks/*.py | wc -l # 应为 10:
# session-start / user-prompt-submit / index-updater / pre-bash-guard / subagent-retry
# / delivery-gate / evidence-collector / compact-snapshot / compact-restore / subagent-tracker
/usr/bin/env python3 -c "print('ok')" || echo "ERROR: python3 不可达, 修复 PATH 后再跑"
Step 4: 复制 agents/ (9 个 .toml)
mkdir -p ~/.codex/agents
cp cx/.codex/agents/*.toml ~/.codex/agents/
# 9 个: architect / critic / docs_researcher / evaluator / generator / polish_worker / pr_explorer / reviewer / spec-compliance
ls ~/.codex/agents/*.toml | wc -l # 应为 9
Step 5: 复制 standards/ (6 个 md)
mkdir -p ~/.codex/standards
cp cx/.codex/standards/*.md ~/.codex/standards/
ls ~/.codex/standards/*.md | wc -l # 应为 6 (_index + coding/doc/git/security/ui)
Step 6: 复制 skills/ (到 ~/.codex/skills/)
mkdir -p ~/.codex/skills
cp -r cx/.codex/skills/* ~/.codex/skills/
Step 7: 验证 entry + workflow + tool skills 全部被发现
# 7 个 athena-* entry skill 以 skill 形态部署, 文件名一律 SKILL.md (config.toml [[skills.config]] 指向 SKILL.md).
# 自检: 应列出全部 16 个 (7 entry + pace/polish/compound/brainstorm/roadmap/architect-doc + context7/antigravity/deps-check)
codex /skills 2>&1 | grep -ic athena # 期望 ≥ 13 (含 athena 字样的)
grep -c '\[\[skills.config\]\]' ~/.codex/config.toml # 期望 16
# hooks.json 不与 config.toml inline [hooks] 冲突 (后者应为空)
grep -c '^\[\[hooks\.' ~/.codex/config.toml # 期望 0
ls ~/.codex/hooks.json # 应存在
# 启动验证
codex --version
不部署 prompts/: Codex 自定义 prompt 已 deprecated 且只能人工
/触发、不能被 agent 隐式调用. 所有 athena-* 入口统一为 skill (自动发现 + 可隐式调用), 与 CC 端 skill 形态对齐. 从 v9.6.4 升级时rm -rf ~/.codex/prompts清理旧部署.
CC 端步骤 (若用户也用 Claude Code)
# Settings
mkdir -p ~/.claude && cp cc/.claude/settings.json ~/.claude/settings.json
# Rules (6 个 md: _index + coding/doc/git/security/ui)
mkdir -p ~/.claude/rules && cp cc/.claude/rules/*.md ~/.claude/rules/
# Hooks (14 个 .cjs)
mkdir -p ~/.claude/hooks && cp cc/.claude/hooks/*.cjs ~/.claude/hooks/ && chmod +x ~/.claude/hooks/*.cjs
ls ~/.claude/hooks/*.cjs | wc -l # 应为 14
# Agents (5 个 .md: critic / evaluator / generator / reviewer / spec-compliance)
mkdir -p ~/.claude/agents && cp cc/.claude/agents/*.md ~/.claude/agents/
ls ~/.claude/agents/*.md | wc -l # 应为 5
# Skills
mkdir -p ~/.claude/skills && cp -r cc/.claude/skills/* ~/.claude/skills/
AG (Antigravity) 端
不部署. Antigravity 由用户通过 agy 自己使用, Athena 只调度.
跨平台部署位置表
| Athena 资产 | CC 部署位置 | CX 部署位置 |
| ----------------- | ---------------------------- | ---------------------------------------------- |
| Settings | ~/.claude/settings.json | ~/.codex/config.toml + ~/.codex/hooks.json |
| Rules / Standards | ~/.claude/rules/ (6) | ~/.codex/standards/ (6) |
| Hooks | ~/.claude/hooks/*.cjs (14) | ~/.codex/hooks/*.py (10) |
| Subagents | ~/.claude/agents/*.md (5) | ~/.codex/agents/*.toml (9) |
| Skills (含 entry) | ~/.claude/skills/ | ~/.codex/skills/ |
卸载
# CX
rm ~/.codex/hooks.json
mv ~/.codex/config.toml.pre-athena ~/.codex/config.toml 2>/dev/null
rm -rf ~/.codex/{hooks,agents}
rm -rf ~/.codex/standards
rm -rf ~/.codex/skills
升级
跑 athena-migrate skill (备份现有配置 → 应用迁移 → 验证). 详见 athena-migrate.