| name | cx-init |
| description | Codex 侧 CX 项目初始化。收集项目级配置,建立 开发文档/CX工作流 与 .cx,并确保共享 cx core 可立即供 CC 与 Codex 共用。 |
CX Init (Codex Adapter)
仅在用户明确要求初始化时执行。
先阅读:
../cx-shared/references/codex-skill-contract.md
../cx-shared/references/core-schema-overview.md
然后按这个顺序执行:
- 检测项目根目录与 Git 状态
- 检测
开发文档/CX工作流 或旧版 .claude/cx 是否已存在
- 如果已经有
.cx/core/projects/*.json
- 如果存在旧版
开发文档/CX工作流/配置.json / 开发文档/CX工作流/状态.json 但没有 core/
- 先运行
bash ../cx-shared/scripts/cx-core-migrate.sh
- 如果项目尚未初始化
- 先收集
developer_id、github_sync、agent_teams、code_review、worktree_isolation、auto_memory
- 运行
bash ../cx-shared/scripts/cx-init-setup.sh --developer-id ...
- 紧接着运行
bash ../cx-shared/scripts/cx-core-migrate.sh
- 初始化完成后,统一调用:
bash ../cx-shared/scripts/cx-dashboard-bridge.sh --project-root "$(git rev-parse --show-toplevel)" --display-name "$(basename "$(git rev-parse --show-toplevel)")"
- 如果 bridge 返回
should_prompt=true
- 提醒用户存在全局 Web 管理面板
- 这是强推荐,不是强制前置
- 用户接受时执行同一个 bridge helper 并追加
--decision accept
- 用户暂不启用时执行同一个 bridge helper 并追加
--decision decline
- 如果 bridge 返回
prompt_state=accepted 且 auto_register=true
.worktrees 初始化
初始化时确保 .worktrees/ 目录存在且被 .gitignore 忽略:
PROJECT_ROOT=$(git rev-parse --show-toplevel)
mkdir -p "$PROJECT_ROOT/.worktrees"
if ! grep -qxF '.worktrees' "$PROJECT_ROOT/.gitignore" 2>/dev/null; then
echo '.worktrees' >> "$PROJECT_ROOT/.gitignore"
fi
结果要求
- 项目里有
开发文档/CX工作流/配置.json
- 项目里有
开发文档/CX工作流/状态.json
- 项目里有
.cx/core/projects/project.json
- 共享 runtime roots 已包含
codex
- 后续可以直接进入
cx-prd 或 cx-fix
禁止事项
- 不要写 Claude Code 专用 hooks 到项目
.claude/settings.json
- 不要跳过 migrate 直接让 Codex 在旧布局上并行执行
- 不要把 Codex 运行时文件写到
.cx/runtime/cc/