Athena Setup

---
name: athena-setup
description: |
  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.
effort: low
---

# /athena-setup — Athena 全局首次配置 (Codex, v9.7.0)

## 触发

第一次安装 Athena 时跑一次. 之后跨项目复用.

## CX 端步骤

### Step 1: 复制 config.toml

```bash
[ -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

```bash
[ -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)

```bash
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)

```bash
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)

```bash
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/)

```bash
mkdir -p ~/.codex/skills
cp -r cx/.codex/skills/* ~/.codex/skills/
```

### Step 7: 验证 entry + workflow + tool skills 全部被发现

```bash
# 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)

```bash
# 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/`                         |

## 卸载

```bash
# 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.