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/