claude-code-workflow 6.2.1 → 6.2.3

package/.claude/skills/command-guide/templates/issue-bug.md

@@ -0,0 +1,104 @@
+---
+name: Bug 报告
+about: 报告命令执行问题或系统错误
+labels: bug
+---
+
+# Bug 报告
+
+## 问题描述
+
+<!-- 简要描述遇到的问题 -->
+
+## 完整执行流程
+
+### 执行环境
+
+```bash
+# 工作目录
+# [填写您的工作目录]
+
+# 相关环境变量（如适用）
+# [如：CLAUDE_WORKFLOW_SESSION]
+```
+
+### 完整命令历史
+
+<!-- ⚠️ 隐私提示: 请删除或替换敏感信息（API密钥、密码、真实路径、用户名等） -->
+
+```bash
+# 命令 1 - [描述此命令的目的]
+# [粘贴命令]
+
+# 输出:
+# [粘贴输出，删除敏感信息]
+
+# 命令 2 - [描述此命令的目的]
+# [粘贴命令]
+
+# 输出:
+# [粘贴输出，删除敏感信息]
+
+# 问题出现在这个命令 ⬇️
+# 命令 3 - [问题命令]
+# [粘贴命令]
+
+# 错误输出:
+# [粘贴完整错误信息]
+```
+
+**隐私保护**:
+- ✅ 保留: 命令名称、参数结构、错误代码
+- ❌ 移除: API密钥、密码、真实路径、个人信息
+
+### 触发问题的具体命令
+
+```bash
+<!-- 单独列出触发问题的命令，以便快速重现 -->
+```
+
+## 期望行为
+
+<!-- 描述您期望的结果是什么 -->
+
+## 实际行为
+
+<!-- 描述实际发生的情况，包括错误信息 -->
+
+## 复现步骤
+
+1.
+2.
+3.
+
+## 环境信息
+
+- **操作系统**: Windows / Mac / Linux
+- **OS 版本**:
+- **Claude Code 版本**:
+- **相关命令**:
+- **相关文件路径**:
+
+## 错误日志
+
+```
+<!-- 如有错误信息或日志，请粘贴在这里 -->
+```
+
+## 额外上下文
+
+<!-- 任何其他有助于理解问题的信息，如：
+- 是否是首次执行此命令
+- 之前是否成功执行过
+- 最近是否修改过配置或文件
+- 相关的 workflow session ID（如适用）
+-->
+
+## 可能的解决方案（可选）
+
+<!-- 如果您有任何想法或建议，请在这里描述 -->
+
+---
+
+**报告日期**: <!-- 自动填充 -->
+**报告人**: <!-- 自动填充 -->

package/.claude/skills/command-guide/templates/issue-diagnosis.md

@@ -0,0 +1,275 @@
+---
+name: 交互式诊断
+about: 通过结构化流程快速定位问题
+labels: diagnosis
+---
+
+# 交互式诊断模板
+
+> 本模板通过结构化的问题引导，帮助您快速定位问题根源。请按顺序完成各个部分。
+
+## 📋 第一步：问题分类
+
+<!-- 选择最符合您情况的问题类型（可多选） -->
+
+- [ ] 命令执行失败或报错
+- [ ] 命令执行成功但结果不符合预期
+- [ ] 不知道该使用哪个命令
+- [ ] 配置或环境问题
+- [ ] 工作流程问题
+- [ ] 性能或超时问题
+- [ ] 其他: __________
+
+## 📜 第二步：完整执行流程记录
+
+> **关键**: 详细记录您的完整操作历史，这是快速定位问题的基础
+
+### 2.1 执行环境
+
+```bash
+# 当前工作目录
+pwd
+
+# 相关环境变量（如适用）
+echo $CLAUDE_WORKFLOW_SESSION
+echo $PROJECT_ROOT
+```
+
+**工作目录**: <!-- 填写您的工作目录路径 -->
+**相关环境变量**: <!-- 如有，请填写 -->
+
+### 2.2 完整命令历史
+
+<!-- 请按时间顺序列出您执行的所有相关命令 -->
+<!-- ⚠️ 隐私提示: 请删除或替换敏感信息，如：API密钥、密码、真实路径、用户名等 -->
+
+```bash
+# 命令 1 - [简短描述此命令的目的]
+# 示例: /workflow:plan --agent "implement user authentication"
+
+# 输出/结果:
+# [请粘贴输出，注意删除敏感信息]
+
+# 命令 2 - [简短描述此命令的目的]
+
+
+# 输出/结果:
+
+
+# 命令 3 - [简短描述此命令的目的]
+
+
+# 输出/结果:
+
+```
+
+**隐私保护指南**:
+- ✅ 可以包含: 命令名称、参数结构、错误代码
+- ❌ 应该移除: API密钥、密码、真实文件路径、个人身份信息
+- 💡 替换示例:
+  - `/real/path/project` → `/path/to/project`
+  - `user@email.com` → `user@example.com`
+  - `sk-abc123xyz` → `sk-***`
+
+### 2.3 相关文件状态
+
+<!-- 如果问题涉及特定文件，请说明文件状态 -->
+
+- **涉及的文件路径**:
+- **文件是否存在**: [ ] 是 / [ ] 否
+- **文件权限**: <!-- 如果相关 -->
+- **最近修改时间**: <!-- 如果相关 -->
+
+## 🔍 第三步：交互式问题定位
+
+### 3.1 命令执行问题诊断
+
+<!-- 如果您的问题涉及命令执行，请完成此检查清单 -->
+
+#### 基础检查
+- [ ] 命令名称拼写正确
+- [ ] 所有必需参数都已提供
+- [ ] 参数格式符合文档要求
+- [ ] 路径使用正确的格式（Windows/Linux）
+- [ ] 具有执行命令所需的权限
+
+#### 环境检查
+- [ ] 在正确的目录下执行命令
+- [ ] 相关依赖工具已安装（如 git, node, gemini, codex）
+- [ ] 环境变量配置正确
+- [ ] 没有其他进程占用相关资源
+
+#### 上下文检查
+- [ ] Workflow session 状态正常（如适用）
+- [ ] 相关配置文件存在且格式正确
+- [ ] 前置步骤已完成
+- [ ] 没有冲突的并发操作
+
+### 3.2 结果不符预期诊断
+
+<!-- 如果命令执行成功但结果不对，请回答以下问题 -->
+
+**期望结果**: <!-- 详细描述您期望看到什么 -->
+
+**实际结果**: <!-- 详细描述实际发生了什么 -->
+
+**差异分析**:
+- [ ] 结果格式不同
+- [ ] 内容缺失或多余
+- [ ] 数据内容错误
+- [ ] 文件生成位置错误
+- [ ] 其他: __________
+
+**可能原因**:
+- [ ] 对命令功能的理解有误
+- [ ] 参数配置不当
+- [ ] 输入数据格式问题
+- [ ] 工作流状态不匹配
+- [ ] 其他: __________
+
+### 3.3 使用方法不确定诊断
+
+<!-- 如果您不确定应该使用什么命令或如何使用，请回答 -->
+
+**您想要实现的目标**: <!-- 用一句话描述 -->
+
+**您已经查看的文档**:
+- [ ] getting-started.md
+- [ ] workflow-patterns.md
+- [ ] cli-tools-guide.md
+- [ ] 特定命令文档: __________
+- [ ] 其他: __________
+
+**您已经尝试的方法**:
+1.
+2.
+3.
+
+**具体的困惑点**:
+- [ ] 不知道用哪个命令
+- [ ] 不理解参数含义
+- [ ] 不清楚执行顺序
+- [ ] 不知道如何组合使用
+- [ ] 其他: __________
+
+## 🔄 第四步：决策树导航
+
+```mermaid
+graph TD
+    A[开始诊断] --> B{命令是否执行?}
+    B -->|是| C{结果是否符合预期?}
+    B -->|否| D{是否有错误信息?}
+
+    C -->|是| E[可能是理解偏差<br/>查看文档核对预期]
+    C -->|否| F{结果是部分正确?}
+
+    D -->|是| G[根据错误信息分类]
+    D -->|否| H[检查命令拼写和语法]
+
+    F -->|是| I[检查参数配置]
+    F -->|否| J[检查输入数据和环境]
+
+    G --> K{错误类型?}
+    K -->|权限错误| L[检查文件权限和执行权限]
+    K -->|文件未找到| M[检查路径和工作目录]
+    K -->|参数错误| N[核对命令文档]
+    K -->|超时错误| O[检查网络和资源]
+
+    E --> P[参考: getting-started.md]
+    I --> Q[参考: cli-tools-guide.md]
+    J --> R[参考: troubleshooting.md]
+    L --> S[检查清单 3.1 - 基础检查]
+    M --> S
+    N --> Q
+    O --> T[参考: troubleshooting.md - 性能问题]
+```
+
+**根据决策树，您的问题可能属于**: <!-- 填写决策树的最终节点 -->
+
+## 💡 第五步：自助解决尝试
+
+<!-- 根据上述诊断结果，尝试以下解决方案 -->
+
+### 已尝试的解决方案
+
+#### 尝试 1:
+- **方案**: <!-- 描述您尝试的解决方案 -->
+- **结果**: [ ] 成功 / [ ] 失败 / [ ] 部分成功
+- **详细说明**: <!-- 详细说明结果 -->
+
+#### 尝试 2:
+- **方案**:
+- **结果**: [ ] 成功 / [ ] 失败 / [ ] 部分成功
+- **详细说明**:
+
+#### 尝试 3:
+- **方案**:
+- **结果**: [ ] 成功 / [ ] 失败 / [ ] 部分成功
+- **详细说明**:
+
+## 📞 第六步：寻求帮助
+
+<!-- 如果自助解决未成功，请完成此部分以便他人协助 -->
+
+### 核心问题总结
+
+<!-- 基于以上所有信息，用 1-2 句话总结您的核心问题 -->
+
+### 卡住的具体环节
+
+<!-- 在整个流程中，您具体卡在哪一步？ -->
+
+### 最重要的疑问
+
+<!-- 如果只能问一个问题，您最想知道什么？ -->
+
+### 紧急程度
+
+- [ ] 紧急 - 阻碍关键工作进展
+- [ ] 重要 - 影响工作效率但有临时方案
+- [ ] 一般 - 希望改进但不紧急
+
+## 📎 附加信息
+
+### 系统信息
+
+- **操作系统**: Windows / Mac / Linux
+- **OS 版本**:
+- **Claude Code 版本**:
+- **相关工具版本**:
+  - Git:
+  - Node:
+  - Gemini CLI:
+  - Codex:
+  - 其他:
+
+### 相关文件
+
+<!-- 如果有相关的配置文件、日志文件或错误截图，请说明 -->
+
+- [ ] 命令输出日志
+- [ ] 配置文件内容
+- [ ] 错误截图
+- [ ] Workflow session 文件
+- [ ] 其他: __________
+
+### 参考链接
+
+<!-- 相关的 issue、文档链接或其他参考资料 -->
+
+---
+
+## ✅ 提交前检查清单
+
+提交此诊断前，请确认：
+
+- [ ] 已完整填写"完整执行流程记录"（第二步）
+- [ ] 已完成至少一个诊断清单（第三步）
+- [ ] 已尝试至少 2 种解决方案（第五步）
+- [ ] 已清晰总结核心问题（第六步）
+- [ ] 已附加必要的系统信息和日志
+
+---
+
+**诊断日期**: <!-- 自动填充 -->
+**提交人**: <!-- 自动填充 -->

package/.claude/skills/command-guide/templates/issue-feature.md

@@ -0,0 +1,97 @@
+---
+name: 功能请求
+about: 建议新功能或改进现有功能
+labels: enhancement
+---
+
+# 功能请求
+
+## 功能概述
+
+<!-- 简要描述您希望添加或改进的功能 -->
+
+## 问题背景
+
+<!-- 描述当前的痛点或限制，这个功能将解决什么问题？ -->
+
+### 当前工作流程
+
+<!-- 描述您现在是如何完成相关任务的 -->
+
+**典型操作流程**:
+
+```bash
+# 步骤 1 - [描述当前做法]
+# [当前使用的命令或操作]
+
+# 步骤 2 - [描述当前做法]
+# [当前使用的命令或操作]
+
+# 步骤 3 - [描述当前做法]
+# [当前使用的命令或操作]
+```
+
+### 当前方案的痛点
+
+<!-- 列出当前方案的具体问题 -->
+
+- **痛点 1**: <!-- 具体描述 -->
+  - 影响: <!-- 如何影响效率 -->
+  - 频率: <!-- 多久遇到一次 -->
+
+- **痛点 2**:
+  - 影响:
+  - 频率:
+
+- **痛点 3**:
+  - 影响:
+  - 频率:
+
+## 建议的解决方案
+
+<!-- 详细描述您建议的功能实现方式 -->
+
+## 使用场景
+
+<!-- 描述具体的使用场景和示例 -->
+
+### 场景 1:
+**情况**:
+**操作**:
+**期望结果**:
+
+### 场景 2（可选）:
+**情况**:
+**操作**:
+**期望结果**:
+
+## 预期效果
+
+<!-- 描述这个功能将如何改善工作流程或用户体验 -->
+
+## 参考示例（可选）
+
+<!-- 如果有类似功能的参考实现（其他工具、项目等），请提供链接或描述 -->
+
+## 替代方案（可选）
+
+<!-- 描述您考虑过的其他解决方案 -->
+
+## 优先级
+
+- [ ] 高 - 严重影响工作效率
+- [ ] 中 - 有明显改善但有变通方案
+- [ ] 低 - 锦上添花
+
+## 额外信息
+
+<!-- 任何其他相关信息，如：
+- 相关的命令或工作流
+- 技术实现建议
+- 可能的挑战或限制
+-->
+
+---
+
+**提交日期**: <!-- 自动填充 -->
+**提交人**: <!-- 自动填充 -->

package/.claude/skills/command-guide/templates/issue-question.md

@@ -0,0 +1,141 @@
+---
+name: 问题咨询
+about: 询问使用方法、最佳实践或寻求帮助
+labels: question
+---
+
+# 问题咨询
+
+## 问题描述
+
+<!-- 清楚地描述您的问题或困惑 -->
+
+## 当前情况与执行流程
+
+<!-- 描述您当前的情况和已尝试的方法 -->
+
+### 工作环境
+
+```bash
+# 工作目录
+# [填写您的工作目录]
+
+# 项目类型
+# [如：React应用、Node.js API、数据分析项目等]
+```
+
+### 完整执行流程
+
+<!-- ⚠️ 隐私提示: 请删除或替换敏感信息（API密钥、密码、真实路径、用户名等） -->
+
+#### 尝试 1
+
+**目的**: <!-- 您想实现什么 -->
+
+**执行的命令**:
+```bash
+# [粘贴命令]
+```
+
+**结果**: <!-- 成功/失败/部分成功 -->
+
+**输出/问题**:
+```bash
+# [粘贴输出或描述问题，删除敏感信息]
+```
+
+**您的困惑**: <!-- 在这一步您不确定什么 -->
+
+#### 尝试 2
+
+**目的**:
+
+**执行的命令**:
+```bash
+# [粘贴命令]
+```
+
+**结果**: <!-- 成功/失败/部分成功 -->
+
+**输出/问题**:
+```bash
+# [粘贴输出或描述问题]
+```
+
+**您的困惑**:
+
+#### 尝试 3
+
+**目的**:
+
+**执行的命令**:
+```bash
+# [粘贴命令]
+```
+
+**结果**: <!-- 成功/失败/部分成功 -->
+
+**输出/问题**:
+```bash
+# [粘贴输出或描述问题]
+```
+
+**您的困惑**:
+
+**隐私保护**:
+- ✅ 保留: 命令名称、参数结构
+- ❌ 移除: API密钥、密码、真实路径、个人信息
+
+## 具体疑问
+
+<!-- 详细说明您想要了解的内容 -->
+
+### 问题 1:
+
+
+### 问题 2（可选）:
+
+
+## 期望的解答
+
+<!-- 描述您期望获得什么样的帮助或解答 -->
+
+- [ ] 使用方法说明
+- [ ] 最佳实践建议
+- [ ] 示例代码或配置
+- [ ] 故障排除指导
+- [ ] 概念解释
+- [ ] 其他:
+
+## 上下文信息
+
+### 使用场景
+<!-- 描述您的具体使用场景 -->
+
+### 项目类型
+<!-- 如果相关，描述您的项目类型，如：Web 应用、API 服务、数据分析等 -->
+
+### 相关文档
+<!-- 列出您已经查看过的相关文档 -->
+
+- [ ] getting-started.md
+- [ ] workflow-patterns.md
+- [ ] cli-tools-guide.md
+- [ ] troubleshooting.md
+- [ ] 命令文档:
+- [ ] 其他:
+
+## 紧急程度
+
+- [ ] 紧急 - 阻碍当前工作
+- [ ] 一般 - 希望尽快了解
+- [ ] 不急 - 学习和改进目的
+
+## 额外信息
+
+<!-- 任何其他可能有助于理解或解答的信息 -->
+
+---
+
+**提问日期**: <!-- 自动填充 -->
+**提问人**: <!-- 自动填充 -->