Browse / General-purpose / codex-workspace-template
codex-workspace-template
annieaska
一键搭好 Codex / Claude Code 工作区:目录规范、全局规则、Superpowers 默认开启、上下文管理与记忆架构
Open annieaska/codex-workspace-template → Checked against the four rules.
Works with any agent
ships AGENTS.md, the cross-tool instruction file.
In its own words
给第一次用 Codex(或 Claude Code)的同事准备:一条命令搭好工作区目录、全局规则、Superpowers 开发工作流和长期记忆检索。整套设计的核心是 会话里只带当前任务需要的最少信息,其余放在文件里按需取回,长任务不跑偏,也省 Token。
两个客户端共用同一份规则:Codex 读 AGENTS.md,Claude Code 读 CLAUDE.md(里面只有一行 @AGENTS.md)。
3 分钟上手
准备:macOS,已安装 Codex App 或 Codex CLI;Claude Code 可选。建议先装好 Homebrew,再运行 brew install git node uv && uv tool install basic-memory(记忆检索要用)。
方式 A:让 Codex 帮你装(推荐)。 在 Codex 里新建一个会话,把下面这段发给它:
方式 B:自己在终端运行。
装完后,在 Codex 里打开 ~/codex-workspace 这个文件夹,先发一句“介绍一下这个工作区的规则和目录”,确认它读到了规则。
setup.sh 做了什么
可以重复运行。已存在且被你改过的规则文件不会被覆盖,新版本会写到同目录的 .new 文件里供你对比。配置文件只追加缺少的段落,不改动已有内容。
日常用法速记
- 跨多天的任务:在
02_项目/01_进行中/下建项目目录,复制PROJECT.template.md当作状态真源。长对话压缩或换窗口前,让 AI 更新它。 - 做开发:直接描述需求,Superpowers 会先跟你澄清,再写计划、测试驱动实现。小改动说“不用 brainstorm,直接改”。
- 需要历史信息:说“回忆一下 X”,AI 才会去查记忆。确认过的结论按模板写进
07_记忆库/,再运行.basic-memory/sync_memory.sh。 - 规则要按自己的习惯改:改
~/.codex/AGENTS.md(全局)或工作区的AGENTS.md(本工作区)。
更新
指南文档和记忆脚本会直接更新。你改过的规则文件会生成 .new 版本,自己对比后合并。
隐私边界
这个仓库只包含通用规则、模板和脚本,不含任何业务资料、凭据、真实服务地址或个人配置。你自己的工作区如果要推到远端,只用私有仓库。
The whole README. Open the repo ↗
Read from the repository's git tree on 2026-08-17.