Claude-Code-Workflow/docs/CCW-CODEX-COMMANDS-SKILLS-GUIDE.md

CCW / Codex 命令与 Skill 完整指南

Who（谁来用）: 项目开发者 - 使用 Claude Code 或 Codex CLI 进行代码开发、审查、调试、规划的开发人员

---

一、CCW CLI 命令

1.1 核心命令

命令	用途	示例
ccw view	启动 Dashboard 服务器	ccw view --port 3456
ccw stop	停止服务器	ccw stop --force
ccw cli	统一 CLI 工具执行	ccw cli -p "..." --tool gemini
ccw session	会话生命周期管理	ccw session list
ccw issue	Issue 生命周期管理	ccw issue create --title "..."
ccw memory	上下文跟踪	ccw memory search --query "..."
ccw team	团队消息总线	ccw team status --session-id <id>

1.2 CLI 执行命令详解

基础语法

ccw cli -p "<PROMPT>" --tool <tool> --mode <mode> [options]

三种执行模式

模式	权限	用途	工具支持
analysis	只读	代码审查、架构分析、模式发现	全部
write	创建/修改/删除	功能实现、Bug修复、代码重构	全部
review	只读（Git感知）	代码变更审查	codex 专用

CLI 工具配置 (~/.claude/cli-tools.json)

{
  "tools": {
    "gemini": { "enabled": true, "primaryModel": "gemini-2.5-pro", "tags": ["分析", "Debug"] },
    "qwen": { "enabled": true, "primaryModel": "coder-model" },
    "codex": { "enabled": true, "primaryModel": "gpt-5.2" },
    "claude": { "enabled": true, "primaryModel": "sonnet" },
    "opencode": { "enabled": true, "primaryModel": "opencode/glm-4.7-free" }
  }
}

CLI 子命令

# 列出所有执行
ccw cli show --all

# 流式输出（stderr）
ccw cli watch <id> --timeout 120

# 获取执行结果
ccw cli output <id>              # 最终结果
ccw cli output <id> --verbose    # 完整元数据
ccw cli output <id> --raw        # 原始输出

CLI 核心选项

选项	说明
-p, --prompt <text>	提示文本
-f, --file <file>	从文件读取提示
--tool <tool>	工具选择 (gemini/qwen/codex/claude)
--mode <mode>	执行模式 (analysis/write/review)
--model <model>	模型覆盖
--cd <path>	工作目录
--includeDirs <dirs>	额外目录（逗号分隔）
--rule <template>	模板规则名称
--resume [id]	恢复会话（空=最近）
--id <id>	执行 ID（推荐指定）
--yes	自动模式

目录配置

# 单额外目录
ccw cli -p "CONTEXT: @**/* @../shared/**/*" \
  --cd src/auth --includeDirs ../shared

# 多额外目录
ccw cli -p "..." --cd src/auth --includeDirs ../shared,../types,../utils

1.3 Codex Review 命令

重要约束: 目标标志 (--uncommitted, --base, --commit) 和 [PROMPT] 互斥

# 方式1: 带提示（审查未提交）
ccw cli -p "聚焦安全漏洞" --tool codex --mode review

# 方式2: 目标标志（无提示）
ccw cli --tool codex --mode review --uncommitted     # 未提交更改
ccw cli --tool codex --mode review --base main       # 与 main 对比
ccw cli --tool codex --mode review --commit abc123   # 特定提交

# ❌ 无效组合（互斥）
ccw cli -p "review" --tool codex --mode review --uncommitted

---

二、模板规则（--rule）

2.1 分析模板

模板	用途
analysis-assess-security-risks	安全风险评估
analysis-diagnose-bug-root-cause	Bug 根因诊断
analysis-review-architecture	架构审查
analysis-analyze-code-patterns	代码模式分析
analysis-review-code-quality	代码质量审查
analysis-analyze-performance	性能分析
analysis-trace-code-execution	执行追踪

2.2 规划模板

模板	用途
planning-plan-architecture-design	架构设计规划
planning-breakdown-task-steps	任务步骤分解
planning-design-component-spec	组件规格设计
planning-plan-migration-strategy	迁移策略规划

2.3 开发模板

模板	用途
development-implement-feature	功能实现
development-refactor-codebase	代码重构
development-generate-tests	测试生成
development-implement-component-ui	UI 组件实现
development-debug-runtime-issues	运行时调试

---

三、Claude Slash Commands

3.1 Workflow 命令

命令	阶段	用途
/workflow:lite-plan	5	快速任务规划（explore → clarify → plan → confirm → handoff）
/workflow-plan	4	正式规划（explore → analyze → plan → verify）
/workflow-execute	6+	执行工作流（session → tasks → commit）
/workflow-tdd-plan	6	TDD 规划（Red-Green-Refactor）
/workflow-test-fix	5	测试生成与修复管道
/workflow:debug-with-file	5	假设驱动调试
/workflow:brainstorm-with-file	4	4视角并行头脑风暴
/workflow:analyze-with-file	4	协作分析（带文档）
/workflow:refactor-cycle	4	重构循环
/workflow:integration-test-cycle	4	集成测试循环

3.2 Issue 命令

命令	用途
/issue:new	创建新 Issue
/issue:discover	发现潜在问题
/issue:discover-by-prompt	通过提示发现问题
/issue:plan	规划解决方案
/issue:queue	形成执行队列
/issue:execute	执行方案队列
/issue:convert-to-plan	转换为规划工件

3.3 DDD 命令

命令	用途
/ddd:auto	文档驱动自动化（chain）
/ddd:plan	文档驱动规划
/ddd:execute	文档驱动执行
/ddd:scan	扫描代码库构建文档
/ddd:index-build	构建文档索引
/ddd:doc-generate	生成完整文档树
/ddd:doc-refresh	增量更新文档
/ddd:sync	任务后同步
/ddd:update	增量索引更新

3.4 Session 命令

命令	用途
/workflow:session:start	启动工作流会话
/workflow:session:resume	恢复最近会话
/workflow:session:list	列出所有会话
/workflow:session:sync	同步到 specs
/workflow:session:complete	完成会话

3.5 Spec 命令

命令	用途
/workflow:spec:setup	初始化项目级配置
/workflow:spec:add	添加规格/约束

3.6 UI Design 命令

命令	用途
/workflow:ui-design:explore-auto	UI 设计自动工作流
/workflow:ui-design:imitate-auto	UI 模仿自动工作流
/workflow:ui-design:style-extract	提取设计样式
/workflow:ui-design:layout-extract	提取布局
/workflow:ui-design:animation-extract	提取动画
/workflow:ui-design:codify-style	代码化样式
/workflow:ui-design:design-sync	同步设计系统
/workflow:ui-design:import-from-code	从代码导入设计
/workflow:ui-design:generate	组装 UI 原型
/workflow:ui-design:reference-page-generator	生成参考页面

3.7 Memory 命令

命令	用途
/memory:prepare	准备记忆上下文
/memory:style-skill-memory	生成 Skill 记忆包

3.8 IDAW 命令

命令	用途
/idaw:add	添加 IDAW 任务
/idaw:run	执行 IDAW 任务链
/idaw:run-coordinate	IDAW 协调器
/idaw:resume	恢复 IDAW 会话
/idaw:status	查看 IDAW 状态

3.9 CLI 命令

命令	用途
/cli:cli-init	初始化 CLI 配置
/cli:codex-review	Codex 代码审查

3.10 其他命令

命令	用途
/ccw	主工作流协调器
/ccw-coordinator	命令协调工具
/flow-create	Flow 模板生成器
/workflow:clean	智能代码清理
/workflow:roadmap-with-file	战略路线图规划
/workflow:collaborative-plan-with-file	协作规划
/workflow:unified-execute-with-file	统一执行引擎
/workflow:debug-with-file	调试工作流
/workflow:brainstorm-with-file	头脑风暴
/workflow:analyze-with-file	协作分析

---

四、CCW Skills（41 个）

4.1 Workflow Skills（9 个）

Skill	阶段	触发	用途
workflow-plan	4	"workflow-plan", 正式规划	4阶段规划（explore → analyze → plan → verify）
workflow-execute	6+	"workflow-execute", 执行	Agent 执行编排，延迟加载阶段文件
workflow-lite-plan	5	"lite-plan", 快速任务	轻量级规划（explore → clarify → plan → confirm → handoff）
workflow-lite-execute	-	"lite-execute"	轻量级执行，支持多模式输入
workflow-tdd-plan	6	"tdd", "TDD"	6阶段 TDD 规划（Red-Green-Refactor）
workflow-test-fix	5	"test-fix"	测试生成与执行管道
workflow-multi-cli-plan	-	"multi-cli"	多 CLI 协作规划（Gemini/Codex/Claude）
workflow-skill-designer	-	"skill-designer"	元技能，生成新的 workflow skills

4.2 Team Skills（21 个）

生命周期

Skill	角色	用途
team-lifecycle-v4	7+	完整生命周期：specification → planning → implementation → testing → review
team-planex	4	规划+执行 wave pipeline
team-roadmap-dev	5	分阶段执行，对齐路线图

质量保障

Skill	角色	用途
team-review	3	代码审查管道：scanner → reviewer → fixer
team-quality-assurance	5	完整 QA：scout → strategist → generator → executor → analyst
team-testing	4	测试管道：strategist → generator → executor → analyst

优化

Skill	角色	用途
team-arch-opt	4	架构优化：analyze → optimize → verify
team-perf-opt	4	性能优化：profile → strategy → implement → benchmark
team-tech-debt	4	技术债务：scan → assess → plan → fix
team-ux-improve	5	UX 改进：scan → diagnose → design → implement → test

开发

Skill	角色	用途
team-frontend	4+	前端开发团队
team-frontend-debug	3+	前端调试（Chrome DevTools MCP）
team-iterdev	3	迭代开发（Generator-Critic 循环）
team-issue	5	Issue 解决：explore → plan → review → marshal → implement

分析与设计

Skill	角色	用途
team-ultra-analyze	4	深度分析：explore → analyze → discuss → synthesize
team-brainstorm	4	头脑风暴（Generator-Critic 循环）
team-uidesign	4	UI 设计：research → tokens → audit → implement

协调

Skill	角色	用途
team-coordinate	动态	通用协调，动态角色生成
team-executor	-	轻量级执行，无分析阶段
team-edict	多部门	三省六部架构

其他

Skill	用途
team-designer	元技能，生成团队 skills
team-lifecycle	Codex 完整生命周期

4.3 Utility Skills（11 个）

Skill	阶段	触发	用途
review-code	6维度	"review"	6维度代码审查（正确性、可读性、性能、安全、测试、架构）
review-cycle	3模式	"review-cycle"	统一审查（session/module/fix 模式）
skill-tuning	-	"tuning", "诊断"	Skill 诊断和调优
skill-simplify	3	"simplify"	Skill 简化（完整性验证）
skill-generator	5	"create skill", "new skill"	元技能，创建新 skills
command-generator	5	"create command", "new command"	命令文件生成器
spec-generator	6	"spec"	规格文档生成器
memory-capture	2	"memory", "记忆"	记忆捕获（compact/tips 模式）
memory-manage	5	"CLAUDE.md"	CLAUDE.md 更新和文档生成
brainstorm	2	"brainstorm", "头脑风暴"	双模式头脑风暴
ccw-help	-	"help", "帮助"	命令帮助系统

---

五、Team Skills 架构

5.1 协调器 + Worker 模式

// SKILL.md 是路由器
if (hasFlag('--role <name>')) {
  // Worker 模式
  Read(`roles/<name>/role.md`)
  execute Phase 2-4
} else {
  // Coordinator 模式
  Read('roles/coordinator/role.md')
  spawn workers
}

5.2 Worker 生成模板

Agent({
  subagent_type: "team-worker",
  team_name: "planex",
  name: "<role>",
  run_in_background: true,
  prompt: `## Role Assignment
role: <role>
role_spec: ~  or <project>/.claude/skills/team-planex/roles/<role>/role.md
session: <session-folder>
session_id: <session-id>
inner_loop: true`
})

5.3 消息总线通信

mcp__ccw-tools__team_msg({
  operation: "log",
  session_id: sessionId,
  from: role,
  type: "state_update",
  data: { 
    status: "task_complete", 
    task_id: "...", 
    ref: "..." 
  }
})

5.4 会话目录结构

.workflow/.team/<PREFIX>-<slug>-<date>/
├── team-session.json     # 会话状态 + 角色注册
├── artifacts/            # 交付物
├── evidence/             # 调试证据
├── wisdom/               # 跨任务知识
└── .msg/                 # 消息总线存储

---

六、Codex Skills

6.1 核心 Skills

Skill	触发	用途
team-lifecycle	/team-lifecycle <task>	5阶段管道（requirements → init → tasks → coordination → report）
parallel-dev-cycle	/parallel-dev-cycle TASK="..."	4专家并行（RA, EP, CD, VAS）
analyze-with-file	/analyze-with-file TOPIC="..."	协作分析，带文档讨论
brainstorm-with-file	/brainstorm-with-file TOPIC="..."	4视角并行分析
debug-with-file	/debug-with-file BUG="..."	假设驱动调试
review-cycle	/review-cycle <target>	多维代码审查 + 修复
workflow-test-fix-cycle	/workflow-test-fix-cycle <tests>	测试-修复循环

6.2 专用 Skills

Skill	触发	用途
clean	/clean	代码清理
memory-compact	/memory-compact	记忆压缩
issue-discover	/issue-discover	问题发现
session-sync	/session-sync	会话同步
spec-add	/spec-add	添加规格
spec-setup	/spec-setup	设置规格

---

七、Skill 执行模式

7.1 Sequential 模式（固定顺序）

Phase 01 → Phase 02 → Phase 03 → ... → Phase N

适用: 流水线任务、阶段间强依赖、固定输出结构

文件: phases/01-*.md, phases/02-*.md, ...

7.2 Autonomous 模式（状态驱动）

Orchestrator → 读取状态 → 选择 Action → 执行 → 更新状态

适用: 交互式任务、阶段间无强依赖、需动态响应

文件: phases/orchestrator.md, phases/actions/*.md, phases/state-schema.md

---

八、通用参数

8.1 自动模式（-y/--yes）

所有命令支持跳过确认：

/workflow-execute --yes
/issue:new -y "问题描述"
/team-planex --yes "任务描述"

8.2 会话恢复（--resume）

# 恢复最近会话
/workflow-execute --resume

# 恢复特定会话
/workflow-execute --resume="WFS-auth"

8.3 角色指定（--role）

# Team Skills 角色路由
/team-lifecycle-v4 --role coordinator
/team-lifecycle-v4 --role planner

---

九、使用示例

9.1 分析任务（安全模式）

# 安全审计
ccw cli -p "PURPOSE: 识别认证模块的安全漏洞
TASK: • 扫描注入漏洞 • 检查认证绕过 • 评估会话管理
MODE: analysis
CONTEXT: @src/auth/**/*
EXPECTED: 安全报告（严重级别 + 文件位置 + 修复建议）" \
  --tool gemini --mode analysis --rule analysis-assess-security-risks

# 架构审查
ccw cli -p "..." --tool gemini --mode analysis --rule analysis-review-architecture

# 代码模式分析
ccw cli -p "..." --tool gemini --mode analysis --rule analysis-analyze-code-patterns

9.2 实现任务（写入模式）

# 功能实现
ccw cli -p "PURPOSE: 实现 API 限流
TASK: • 创建滑动窗口中间件 • Redis 后端 • 按路由配置
MODE: write
CONTEXT: @src/middleware/**/*
EXPECTED: 生产代码 + 测试 + 配置示例" \
  --tool gemini --mode write --rule development-implement-feature

# Bug 修复
ccw cli -p "..." --tool gemini --mode analysis --rule analysis-diagnose-bug-root-cause

# 代码重构
ccw cli -p "..." --tool gemini --mode write --rule development-refactor-codebase

9.3 Codex 代码审查

# 审查未提交更改（带焦点）
ccw cli -p "聚焦安全漏洞和错误处理" --tool codex --mode review

# 审查特定提交
ccw cli --tool codex --mode review --commit abc123

# 审查分支差异
ccw cli --tool codex --mode review --base main

9.4 工作流执行

# 交互式执行
/workflow-execute

# 自动模式
/workflow-execute --yes

# 自动提交
/workflow-execute --with-commit

# 恢复会话
/workflow-execute --resume-session="WFS-auth"

9.5 团队协作

# 启动团队工作流
/team-planex --yes "实现用户认证系统"

# 角色分配（自动）
# coordinator: 协调任务分发
# planner: 生成规划方案
# executor: 执行具体任务
# reviewer: 审查执行结果

---

十、相关资源

• CLI Tools 使用规范
• Skill 设计规范
• 命令到 Skill 转换
• 编码哲学
• OMO 命令速查一页纸