athena-setup
Skill328 starsChanged 6 months agoMITView on GitHub
Athena 全局安装。检查 CC 版本、装插件、配置 Codex、部署 hooks、推 claude-mem。首次使用运行一次。
- Deletes or force-pushes
- Installs packages
1 other project uses a version of this.
Adopted by
Most recently taken up by
- zarubinvibe/athenatheir own version, first seen Jun 15, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- zarubinvibe/athena★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository10 other files it gives its agents.
- .codex/AGENTS.mdAGENTS.md
- .claude/CLAUDE.mdCLAUDE.md
- athena-devSkill
- athena-initSkill
- athena-migrateSkill
- athena-preferencesSkill
- athena-reviewSkill
- athena-statusSkill
- compoundSkill
- paceSkill
The file
Files
/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 原生, 不再造状态机驱动器
- 不维护插件推荐列表, 实时查 marketplaceStep 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/*.cjsv9.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 实时查 |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

