# Cx Init

> Codex 侧 CX 项目初始化。收集项目级配置，建立 开发文档/CX工作流 与 .cx，并确保共享 cx core 可立即供 CC 与 Codex 共用。

- Skill: `m19803261706/cx-init-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add m19803261706/cx-init-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/m19803261706/cx-init-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: m19803261706 (https://skillmd.com/u/m19803261706)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/m19803261706/cx-init-2

---


# CX Init (Codex Adapter)

仅在用户明确要求初始化时执行。

先阅读：

- `../cx-shared/references/codex-skill-contract.md`
- `../cx-shared/references/core-schema-overview.md`

然后按这个顺序执行：

1. 检测项目根目录与 Git 状态
2. 检测 `开发文档/CX工作流` 或旧版 `.claude/cx` 是否已存在
3. 如果已经有 `.cx/core/projects/*.json`
   - 只做健康检查与缺失修复，不重复初始化
4. 如果存在旧版 `开发文档/CX工作流/配置.json` / `开发文档/CX工作流/状态.json` 但没有 `core/`
   - 先运行 `bash ../cx-shared/scripts/cx-core-migrate.sh`
5. 如果项目尚未初始化
   - 先收集 `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`
6. 初始化完成后，统一调用：
   - `bash ../cx-shared/scripts/cx-dashboard-bridge.sh --project-root "$(git rev-parse --show-toplevel)" --display-name "$(basename "$(git rev-parse --show-toplevel)")"`
7. 如果 bridge 返回 `should_prompt=true`
   - 提醒用户存在全局 Web 管理面板
   - 这是强推荐，不是强制前置
   - 用户接受时执行同一个 bridge helper 并追加 `--decision accept`
   - 用户暂不启用时执行同一个 bridge helper 并追加 `--decision decline`
8. 如果 bridge 返回 `prompt_state=accepted` 且 `auto_register=true`
   - 当前项目应该已经自动注册到全局面板
   - 不要重复询问

## .worktrees 初始化

初始化时确保 `.worktrees/` 目录存在且被 `.gitignore` 忽略：

```bash
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/`