4.8 KiB
name, description, effort, disable-model-invocation
| name | description | effort | disable-model-invocation |
|---|---|---|---|
| athena-setup | Athena 全局安装。检查 CC 版本、装插件、配置 Codex、部署 hooks、推 claude-mem。首次使用运行一次。 | xhigh | true |
/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 ".
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 实时查 |