/athena-setup (v9.6)

设计哲学 (启动时告诉用户)

v9.6 原则:
- permissions.deny 仅保留 "Bash(rm -rf *)" + 机密文件 (sandbox 是正道)
  参考: https://claude.com/blog/beyond-permission-prompts-making-claude-code-more-secure-and-autonomous
- 全局 lessons 已删, 跨项目记忆推 claude-mem (默认装)
- /goal /batch /background CC 原生, 不再造状态机驱动器
- 不维护插件推荐列表, 实时查 marketplace

Step 0: CC 版本检查

参考: https://code.claude.com/docs/en/changelog

claude --version

要求 ≥ v2.1.121 (worktree isolation + updatedToolOutput 全工具). v2.1.139+ 解锁 /goal /background. 低于 → claude update 或 npm install -g @anthropic-ai/claude-code@latest.

把检测到的版本写入 .ai_state/_index.md.platform_features.cc_version. 解析后置 goal_supported/batch_supported/background_supported.

Step 1: 插件安装 (按 PACE 节点 best-fit, 非强依赖)

每装一个问自己: "这个真的会用吗?" 多余 = context 浪费。

工程主线 (强烈推荐)

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex

跨项目记忆 (v9.6 默认推 claude-mem)

claude-mem 89k stars, Apache-2.0, 自动捕获 tool use + 压缩摘要 + 注入下次 session. 参考: https://github.com/thedotmack/claude-mem

# 检测是否已装
if /plugin list | grep -iq claude-mem; then
  echo "claude-mem ✓ 已装"
else
  echo "推荐安装 claude-mem (跨 session 记忆):"
  echo "  /plugin marketplace add <claude-mem 所在 marketplace>"
  echo "  /plugin install claude-mem"
  echo "  (如不在 marketplace, 从 github.com/thedotmack/claude-mem 下载)"
fi

未装也行——Athena 仍可用, _index.md.platform_features.cross_session_memory 标 "none".

PACE 节点 best-fit (按需, 实时查 marketplace)

athena-setup 不写死推荐列表, 改用 /plugin browse + 关键词查询:

路径	关键词 (用 /plugin browse 查)
Bugfix	debugger / bug-fix / metronome
Feature 实现	superpowers / dev-workflows / context7
Feature 审查	codex-plugin-cc / agent-peer-review / local-review
Refactor	TypeScript LSP / Rust LSP / ast-grep
Refactor 审查	codex-plugin-cc / AgentLint
System	shipyard (IaC) / mcp-builder
跨节点	context-mode (大输出 sandbox 化)

官方插件 (claude-plugins-official, 已在 settings.json 启用)

/plugin install feature-dev
/plugin install code-review
/plugin install commit-commands

/reload-plugins 后生效.

Step 2: context7 (skill 模式)

npx ctx7 setup --claude

无需全局装 ctx7 CLI, npx 按需拉. OAuth 登录后 ~/.claude/skills/ 自动生成 context7 skill. 触发方式: "use context7" 或 "use context7 with /owner/repo for <query>".

Step 3: Codex 配置

/codex:setup

未登录 → !codex login.

不要启用 review gate (/codex:setup --enable-review-gate) — 会 Claude ↔ Codex 死循环.

settings.json codex 权限 (已在 v9.6 默认 settings 含):

"Bash(codex:*)",
"Bash(node:*)"

Codex 独立配置 ~/.codex/config.toml (见本仓库 cx/.codex/config.toml).

Step 4: Hooks 安装

mkdir -p ~/.claude/hooks
cp .claude/hooks/*.cjs ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.cjs

v9.6 hook 列表 (8 个):

• session-start · pre-bash-guard · index-updater · subagent-retry
• delivery-gate · pace-continuator
• permission-retry · compact-snapshot · compact-restore · state-audit

Step 5: 验证

claude --version                         # ≥ 2.1.121, 最佳 ≥ 2.1.139
/plugin list                             # superpowers / codex / claude-mem (推荐)
npx ctx7 library express                 # context7 CLI 通
/codex:setup                             # Codex ready
ls ~/.claude/hooks/*.cjs | wc -l         # 应 = 10
cat .ai_state/_index.md | head -5        # 含 schema_version: "9.6"

通过 → "安装完成。每个新项目 /athena-init, 然后 /athena-dev."

为什么这样设计 (用户视角)

v9.5 有	v9.6 变化原因
18 → 0 条 deny	sandbox 是正道, 但 v9.6 再加回 "Bash(rm -rf *)" 兜底
全局 lessons 系统	删, 委外给 claude-mem (89k stars)
手写 spawn_agent 协议	部分场景接入 /batch (CC v2.1.121+ 原生)
delivery-gate 自造 VERDICT 解析	接入 /goal evaluator (v2.1.139+), 旧版本兜底
写死的插件推荐列表	改为 /plugin browse 实时查