用途:cx:init 是纯 CX 3.1 项目中唯一一次集中式重配置向导,负责为单个项目建立运行时真相。每个项目的 developer_id 都单独确认,不作为 feature 目录命名,仅作项目展示称呼。
主要能力:初始化项目级“开发文档/CX工作流”目录与 .cx 运行时;生成配置.json 与状态.json;建立 功能/ 与 修复/ 子目录;确保 .worktrees/ 存在并被 .gitignore 忽略;安装插件级 hooks 接线;检查 GitHub remote,若无 remote 默认建议创建仓库并绑定;补齐 CLAUDE.md / AGENTS.md 最小规则段。完成后项目可直接进入 /cx:cx-prd 或 /cx:cx-fix。
使用方式:先检测项目根目录与 Git 状态(GIT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)),非 Git 仓库先建议初始化;若检测到旧版 .claude/cx 而无共享 core/,先运行 bash ${CLAUDE_PLUGIN_ROOT}/scripts/cx-core-migrate.sh,迁移后再继续。随后以勾选式问答按顺序确认 developer_id、是否启用 GitHub 集成、github_sync(off/local/collab/full)、agent_teams、code_review、worktree_isolation、auto_memory。接着创建目录并写入 配置.json 与 状态.json,最后执行 dashboard 保活与项目注册:bash ${CLAUDE_PLUGIN_ROOT}/scripts/cx-dashboard-ensure.sh 与 bash ${CLAUDE_PLUGIN_ROOT}/scripts/cx-dashboard-bridge.sh --project-root "$PROJECT_ROOT" --display-name "$(basename "$PROJECT_ROOT")"。
约束与限制:目录与文档命名允许中文,JSON 字段保持英文;feature 运行时状态置于 功能/<中文标题>/状态.json,current_feature 始终保存稳定 slug;hooks 由插件 hooks/hooks.json 提供,不再复制到项目目录,初始化不再写入 .claude/settings.json;运行时 hook 只读取项目级 配置.json 与 feature 级 状态.json。dashboard 若 prompt_state=accepted 但 service_running=false,须如实提示“接入已记录,但面板暂未成功启动”。其余细节暂未提供。