claude-code-workflow 6.1.3 → 6.2.1

package/.claude/skills/command-guide/guides/examples.md

@@ -1,537 +0,0 @@
-# Usage Examples
-
-Comprehensive examples of command-guide skill in action across all 5 operation modes.
-
----
-
-## Mode 1: Command Search 🔍
-
-### Example 1: Keyword Search
-
-**User**: "搜索包含 'execute' 的命令"
-
-**Skill Response**:
-```
-找到 4 个相关命令：
-
-1. **cli:execute** (高级)
-   描述: Auto-execution of implementation tasks with YOLO permissions
-   参数: [--agent] [--tool codex|gemini|qwen] [--enhance] description or task-id
-   场景: implementation
-
-2. **task:execute** (中级)
-   描述: Execute tasks with appropriate agents and context-aware orchestration
-   参数: task-id
-   场景: implementation
-
-3. **workflow:execute** (中级)
-   描述: Coordinate agents for existing workflow tasks with automatic discovery
-   参数: [--resume-session="session-id"]
-   场景: implementation
-
-4. **codex-execute** (高级)
-   描述: Automated task decomposition and execution with Codex
-   参数: task description or task-id
-   场景: implementation
-
-💡 相关命令: workflow:plan, task:create
-📖 详细文档: [Implementation Commands](workflow-patterns.md#implementation)
-```
-
----
-
-### Example 2: Category Search
-
-**User**: "cli 类别下有哪些命令？"
-
-**Skill Response**:
-```
-CLI 类别包含 9 个命令：
-
-**核心命令** (6个):
-- cli:analyze - Quick codebase analysis
-- cli:chat - Direct codebase interaction
-- cli:execute - Auto-execution with YOLO
-- cli:cli-init - Initialize CLI tool configs
-- cli:codex-execute - Codex-powered execution
-- cli:discuss-plan - Multi-model planning discussion
-
-**模式命令** (3个):
-- cli:mode:plan - Project planning mode
-- cli:mode:code-analysis - Deep code analysis mode
-- cli:mode:bug-diagnosis - Bug diagnosis mode
-
-📚 使用指南: [CLI Tools Guide](cli-tools-guide.md)
-```
-
----
-
-### Example 3: Use-Case Search
-
-**User**: "planning 相关的命令有哪些？"
-
-**Skill Response**:
-```
-Planning 场景包含 8 个命令：
-
-**核心规划**:
-1. workflow:plan (高级) - 5阶段规划工作流
-2. cli:mode:plan (高级) - 项目规划和架构分析
-3. workflow:tdd-plan (高级) - TDD 规划工作流
-
-**任务分解**:
-4. task:breakdown (中级) - 智能任务分解
-5. workflow:tools:task-generate (中级) - 生成任务 JSON
-
-**架构设计**:
-6. workflow:brainstorm:system-architect (中级) - 系统架构师头脑风暴
-7. workflow:brainstorm:api-designer (中级) - API 设计师头脑风暴
-
-**评估验证**:
-8. workflow:action-plan-verify (中级) - 规划质量验证
-
-💡 常见工作流: Plan → Verify → Execute
-📖 模式参考: [Workflow Patterns](workflow-patterns.md#planning-workflow)
-```
-
----
-
-## Mode 2: Smart Recommendations 🤖
-
-### Example 1: After Planning
-
-**User**: "执行完 /workflow:plan 后下一步做什么？"
-
-**Skill Response**:
-```
-推荐的后续步骤：
-
-**🎯 主要选择**:
-1. **/workflow:execute** - 开始执行规划的任务
-   ✅ 这是最常见的下一步
-   作用: 实际执行 workflow:plan 生成的任务
-
-**📋 可选步骤**:
-2. **/workflow:action-plan-verify** - 验证规划质量
-   作用: 在执行前检查规划的一致性和完整性
-   建议: 重要项目建议先验证
-
-3. **/workflow:status** - 查看规划状态
-   作用: 查看生成的任务和当前进度
-
-**📚 完整工作流模式**:
-Plan → Verify (可选) → Execute → Review
-
-详见: [Planning Workflow Pattern](workflow-patterns.md#planning-execution)
-```
-
----
-
-### Example 2: After Execution
-
-**User**: "workflow:execute 执行完成后，推荐做什么？"
-
-**Skill Response**:
-```
-推荐的后续步骤：
-
-**🎯 主要选择**:
-1. **/workflow:review** - 审查实现结果
-   ✅ 检查代码质量、安全性、架构
-   参数: [--type=quality|security|architecture]
-
-**📊 可选步骤**:
-2. **/workflow:status** - 查看执行状态
-   作用: 确认所有任务都已完成
-
-3. **/workflow:test-gen** - 生成测试
-   作用: 为实现的功能创建测试用例
-
-4. **/workflow:session:complete** - 完成会话
-   作用: 标记工作流已完成，归档经验
-
-**🔄 如果需要修改**:
-- /task:replan - 重新规划某个任务
-- /workflow:resume - 恢复工作流
-
-详见: [Execution Review Pattern](workflow-patterns.md#execution-review)
-```
-
----
-
-## Mode 3: Full Documentation 📖
-
-### Example 1: Command Parameters
-
-**User**: "/workflow:plan 的参数是什么？"
-
-**Skill Response**:
-```
-# workflow:plan
-
-**描述**: Orchestrate 5-phase planning workflow with quality gate, executing commands and passing context between phases
-
-**参数**:
-```bash
-/workflow:plan [--agent] [--cli-execute] "text description"|file.md
-```
-
-**参数说明**:
-- `--agent` (可选): 使用 agent 模式执行规划
-- `--cli-execute` (可选): 允许在规划阶段执行 CLI 命令
-- `"text description"`: 任务描述文本
-- `file.md`: 或者提供任务描述文件路径
-
-**使用场景**: planning
-**难度级别**: 高级
-
-**使用示例**:
-```bash
-# 基本用法
-/workflow:plan "实现用户认证功能"
-
-# 使用 agent 模式
-/workflow:plan --agent "重构支付模块"
-
-# 从文件读取
-/workflow:plan --agent feature-spec.md
-
-# 允许 CLI 执行
-/workflow:plan --cli-execute "添加搜索功能"
-```
-
-**执行流程**:
-1. 上下文收集
-2. 概念规划
-3. 实现规划
-4. 任务生成
-5. 质量验证
-
-**相关命令**:
-- workflow:execute - 执行规划的任务
-- workflow:action-plan-verify - 验证规划质量
-- workflow:status - 查看规划状态
-
-**详细文档**: ../../commands/workflow/plan.md
-```
-
----
-
-## Mode 4: Beginner Onboarding 🎓
-
-### Example 1: Complete Beginner
-
-**User**: "我是新手，如何开始使用工作流系统？"
-
-**Skill Response**:
-```
-欢迎使用 Claude DMS3 工作流系统！🎉
-
-## 🚀 快速开始（3 步）
-
-### Step 1: 了解核心命令（Top 5）
-
-1. **/workflow:plan** - 规划一个功能或任务
-   用法: /workflow:plan "你想做的事情"
-
-2. **/workflow:execute** - 执行规划的任务
-   用法: /workflow:execute
-
-3. **/cli:execute** - 快速自动执行
-   用法: /cli:execute "实现XXX功能"
-
-4. **/task:create** - 创建单个任务
-   用法: /task:create "任务标题"
-
-5. **/enhance-prompt** - 优化你的提示词
-   用法: /enhance-prompt "你的想法"
-
-### Step 2: 尝试第一个工作流
-
-```bash
-# 1. 规划一个简单功能
-/workflow:plan "添加用户登录功能"
-
-# 2. 执行规划
-/workflow:execute
-
-# 3. 审查结果
-/workflow:review
-```
-
-### Step 3: 学习资源
-
-📖 **必读指南**:
-- [5分钟快速开始](getting-started.md)
-- [常见工作流模式](workflow-patterns.md)
-
-🛠️ **工具指南**:
-- [CLI 工具使用](cli-tools-guide.md)
-- [问题排查](troubleshooting.md)
-
-💡 **下一步建议**:
-1. 阅读 getting-started.md（5分钟）
-2. 尝试上面的第一个工作流
-3. 探索更多命令: 询问 "常用命令有哪些"
-
-有问题随时问 "CCW-help"！
-```
-
----
-
-### Example 2: Intermediate User
-
-**User**: "常用命令有哪些？"
-
-**Skill Response**:
-```
-## 核心命令列表（Top 14）
-
-### 🎯 工作流管理 (5个)
-1. workflow:plan - 5阶段规划
-2. workflow:execute - 执行任务
-3. workflow:review - 审查实现
-4. workflow:tdd-plan - TDD 规划
-5. workflow:test-gen - 生成测试
-
-### 🛠️ CLI 工具 (3个)
-6. cli:execute - 自动执行
-7. cli:mode:plan - 规划模式
-8. cli:analyze - 代码分析
-
-### 📋 任务管理 (3个)
-9. task:create - 创建任务
-10. task:execute - 执行任务
-11. task:breakdown - 分解任务
-
-### 🔧 实用工具 (2个)
-12. enhance-prompt - 提示词增强
-13. version - 版本信息
-
-### 💡 使用频率
-- **每天**: workflow:plan, workflow:execute, cli:execute
-- **经常**: task:create, enhance-prompt
-- **按需**: workflow:review, test-gen, tdd-plan
-
-📚 详细文档: [Index Structure](index-structure.md#essential-commands)
-```
-
----
-
-## Mode 5: Issue Reporting 📝
-
-### Example 1: Bug Report
-
-**User**: "CCW-issue"
-
-**Skill (Interactive)**:
-```
-请选择问题类型：
-1. 🐛 Bug 报告
-2. ✨ 功能请求
-3. ❓ 问题咨询
-```
-
-**User**: "1"
-
-**Skill**:
-```
-好的，我将帮您创建 Bug 报告。请回答以下问题：
-
-1. 简要描述问题：
-```
-
-**User**: "/workflow:plan 执行后没有生成任务文件"
-
-**Skill**:
-```
-2. 您执行的完整命令是什么？
-```
-
-**User**: "/workflow:plan '添加登录功能'"
-
-**Skill**:
-```
-3. 期望的结果是什么？
-```
-
-**User**: "应该在 .workflow/ 目录生成 task.json"
-
-**Skill**:
-```
-4. 实际发生了什么？
-```
-
-**User**: "命令执行了但没有生成文件"
-
-**Skill**:
-```
-✅ Bug 报告已生成！
-
-文件路径: templates/.generated/bug-2025-01-06-123456.md
-
---- 报告内容 ---
-# Bug 报告
-
-## 问题描述
-/workflow:plan 执行后没有生成任务文件
-
-## 执行的命令
-```bash
-/workflow:plan '添加登录功能'
-```
-
-## 期望行为
-应该在 .workflow/ 目录生成 task.json
-
-## 实际行为
-命令执行了但没有生成文件
-
-## 环境信息
-- 操作系统: Windows
-- 报告日期: 2025-01-06
-- 相关命令: /workflow:plan
-
----
-
-**下一步操作**:
-1. 复制以上内容到 GitHub Issues
-2. 或使用: gh issue create -F templates/.generated/bug-2025-01-06-123456.md
-
-需要更多帮助？使用 "CCW-help"
-```
-
----
-
-### Example 2: Feature Request
-
-**User**: "我想提个功能建议"
-
-**Skill (Interactive)**:
-```
-请选择问题类型：
-1. 🐛 Bug 报告
-2. ✨ 功能请求
-3. ❓ 问题咨询
-```
-
-**User**: "2"
-
-**Skill**:
-```
-好的，功能请求。请描述：
-
-1. 您希望添加什么功能？
-```
-
-**User**: "希望 /workflow:plan 能自动估算任务时间"
-
-**Skill**:
-```
-2. 这个功能解决什么问题？
-```
-
-**User**: "帮助更好地规划项目进度和资源分配"
-
-**Skill**:
-```
-3. 具体的使用场景是什么？（可选）
-```
-
-**User**: "规划大型项目时，能看到预计完成时间"
-
-**Skill**:
-```
-✅ 功能请求已生成！
-
-文件路径: templates/.generated/feature-2025-01-06-123457.md
-
---- 内容预览 ---
-# 功能请求
-
-## 功能概述
-希望 /workflow:plan 能自动估算任务时间
-
-## 问题背景
-帮助更好地规划项目进度和资源分配
-
-## 使用场景
-规划大型项目时，能看到预计完成时间
-
-## 优先级
-- [ ] 高 - 严重影响工作效率
-- [x] 中 - 有明显改善但有变通方案
-- [ ] 低 - 锦上添花
-
----
-
-可以复制到 GitHub 提交，或使用:
-gh issue create -F templates/.generated/feature-2025-01-06-123457.md
-```
-
----
-
-## Edge Cases & Error Handling
-
-### Case 1: No Results Found
-
-**User**: "搜索 xyz 命令"
-
-**Skill**:
-```
-❌ 未找到包含 "xyz" 的命令
-
-💡 建议：
-1. 尝试更广泛的关键词（如 "plan", "execute", "test"）
-2. 按类别浏览：workflow, cli, memory, task
-3. 查看所有常用命令：询问 "常用命令"
-4. 需要帮助：使用 "CCW-help"
-
-📚 快速参考：[All Commands Index](index-structure.md#all-commands)
-```
-
----
-
-### Case 2: Ambiguous Query
-
-**User**: "命令"
-
-**Skill**:
-```
-您想了解什么？请选择：
-
-1. 🔍 搜索特定命令
-2. 🤖 获取命令推荐
-3. 📖 查看命令文档
-4. 🎓 新手入门指导
-5. 📝 报告问题或建议
-
-或者直接说出具体需求，例如：
-- "搜索 planning 命令"
-- "执行完 /workflow:plan 下一步做什么"
-- "/task:create 怎么用"
-```
-
----
-
-### Case 3: Multiple Matches
-
-**User**: "execute 命令"
-
-**Skill**:
-```
-找到多个相关命令，请选择您需要的：
-
-1. **cli:execute** - CLI 自动执行（推荐新手）
-2. **task:execute** - 执行单个任务
-3. **workflow:execute** - 执行整个工作流
-
-或者询问：
-- "cli:execute 的详细文档"
-- "三者有什么区别"
-- "我该用哪个"
-```
-
----
-
-**Last Updated**: 2025-01-06