| name | athena-setup |
| description | Athena 全局首次配置 (跨项目, 一次性). 从分发包部署 settings/config/rules/standards/hooks/agents/skills 到 ~/.claude/ (CC) 与 ~/.codex/ (CX).
和 athena-init 区别: setup 全局一次性, init 每项目一次. 已装则转 verify/upgrade (走 athena-migrate).
|
| effort | low |
/athena-setup — Athena 全局首次配置 (v9.9.0)
v9.8.0 修两处历史硬伤: (1) CC 端旧版把 CX skills/standards 装到 ~/.agents/, 但全 harness (config.toml 注册路径、CX skill 内部互引、session-start standards 查找) 都认 ~/.codex/ —— 装到 ~/.agents/ 等于装了没人读。现统一到 ~/.codex/。(2) 旧版 cp 用相对 cwd 裸路径、无包定位, 从项目里 /athena-setup 触发时无源可 cp。现加 ATHENA_CC_PKG / ATHENA_CX_PKG 定位 + 幂等。
Step 0 · 定位分发包 + 判首装/已装 (必做)
CC_PKG="${ATHENA_CC_PKG:-}"
CX_PKG="${ATHENA_CX_PKG:-}"
for c in "$CC_PKG" "$PWD/.claude" "$PWD/cc/.claude" "$PWD/claude/9.9.0/.claude"; do
[ -n "$c" ] && [ -f "$c/settings.json" ] && CC_PKG="$c" && break
done
for c in "$CX_PKG" "$PWD/.codex" "$PWD/cx/.codex" "$PWD/codex/9.9.0/.codex"; do
[ -n "$c" ] && [ -f "$c/config.toml" ] && CX_PKG="$c" && break
done
echo "CC_PKG=$CC_PKG"; echo "CX_PKG=$CX_PKG"
[ -f "$CC_PKG/settings.json" ] || echo "⚠️ 未定位 CC 包: export ATHENA_CC_PKG=<.claude 目录> 再跑"
[ -f "$CX_PKG/config.toml" ] || echo "⚠️ 未定位 CX 包: export ATHENA_CX_PKG=<.codex 目录> 再跑"
if [ -d ~/.claude/skills ] || [ -d ~/.codex/skills ]; then
echo "检测到已安装 Athena → 走升级请用 /athena-migrate (备份+迁移); 仅校验则跑下方各 Step 的自检命令."
fi
chicken-and-egg 提示: 能跑 /athena-setup 说明 CC skills 已在 ~/.claude/skills/。真正首装需先手动 cp -r "$CC_PKG/skills/"* ~/.claude/skills/ 再用 skill 形态。本 skill 负责非-skill 资产 + CX 全套 + 校验。
CC 端 (~/.claude/)
mkdir -p ~/.claude/{rules,hooks,agents,skills}
cp "$CC_PKG/settings.json" ~/.claude/settings.json
cp "$CC_PKG/rules/"*.md ~/.claude/rules/
cp "$CC_PKG/hooks/"*.cjs ~/.claude/hooks/ && chmod +x ~/.claude/hooks/*.cjs
cp "$CC_PKG/agents/"*.md ~/.claude/agents/
cp -r "$CC_PKG/skills/"* ~/.claude/skills/
echo "rules=$(ls ~/.claude/rules/*.md|wc -l) hooks=$(ls ~/.claude/hooks/*.cjs|wc -l) agents=$(ls ~/.claude/agents/*.md|wc -l) skills=$(ls -d ~/.claude/skills/*/|wc -l)"
CX 端 (~/.codex/) ← 全部落 ~/.codex/, 与 config.toml 注册路径一致
[ -f ~/.codex/config.toml ] && cp ~/.codex/config.toml ~/.codex/config.toml.pre-athena
mkdir -p ~/.codex/{hooks,agents,standards,skills}
cp "$CX_PKG/config.toml" ~/.codex/config.toml
sed "s|<USER_HOME>|$HOME|g" ~/.codex/config.toml > ~/.codex/config.toml.tmp && mv ~/.codex/config.toml.tmp ~/.codex/config.toml
cp "$CX_PKG/hooks.json" ~/.codex/hooks.json
cp "$CX_PKG/hooks/"*.py ~/.codex/hooks/ && chmod +x ~/.codex/hooks/*.py
cp "$CX_PKG/agents/"*.toml ~/.codex/agents/
cp "$CX_PKG/standards/"*.md ~/.codex/standards/
cp -r "$CX_PKG/skills/"* ~/.codex/skills/
echo "hooks=$(ls ~/.codex/hooks/*.py|wc -l) agents=$(ls ~/.codex/agents/*.toml|wc -l) standards=$(ls ~/.codex/standards/*.md|wc -l) skills=$(ls -d ~/.codex/skills/*/|wc -l)"
grep -c '^\[\[skills.config\]\]' ~/.codex/config.toml
grep -c '^\[\[hooks\.' ~/.codex/config.toml
⚠️ v9.9.0 · CX hook trust: Codex hooks GA 后按内容哈希记录信任 — 本 setup 每次覆盖 hooks 都会使其
全部变为 untrusted 待审. 部署后首次进 codex 会逐个提示信任, 属预期; 自动化/CI 场景用
--dangerously-bypass-hook-trust (名字已经告诉你后果, 自负责).
不部署 prompts/: Codex 自定义 prompt 已 deprecated, 入口统一为 skill (自动发现). 从旧版升级时 rm -rf ~/.codex/prompts。
AG (Antigravity)
不部署. Athena 只调度 agy。
跨平台部署位置表 (权威, 与 config.toml / session-start / skill 内部引用一致)
| 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 | ~/.claude/skills/ (23 目录) | ~/.codex/skills/ (23 目录 / 注册 22) |
卸载
rm -rf ~/.claude/{rules,hooks,agents,skills}; rm ~/.claude/settings.json
rm ~/.codex/hooks.json; mv ~/.codex/config.toml.pre-athena ~/.codex/config.toml 2>/dev/null
rm -rf ~/.codex/{hooks,agents,standards,skills}
rm -rf ~/.agents/skills/_athena ~/.agents/standards
升级
跑 /athena-migrate (备份 → 迁移 → 验证). 不要用 athena-setup 覆盖已装环境。
