155 lines
4.8 KiB
Markdown
155 lines
4.8 KiB
Markdown
|
---
|
||
|
|
name: athena-setup
|
||
|
|
description: >
|
||
|
|
Athena 全局安装。检查 CC 版本、装插件、配置 Codex、部署 hooks、推 claude-mem。首次使用运行一次。
|
||
|
|
effort: xhigh
|
||
|
|
disable-model-invocation: 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>
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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 模式)
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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 含):
|
||
|
|
|
||
|
|
```json
|
||
|
|
"Bash(codex:*)",
|
||
|
|
"Bash(node:*)"
|
||
|
|
```
|
||
|
|
|
||
|
|
Codex 独立配置 `~/.codex/config.toml` (见本仓库 cx/.codex/config.toml).
|
||
|
|
|
||
|
|
## Step 4: Hooks 安装
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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: 验证
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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 实时查 |
|