feat: 增强问题报告和诊断模板，添加执行流程强调和隐私保护指南

2026-02-05 01:50:27 +08:00 · 2025-11-06 15:40:00 +08:00
parent 958567e35a
commit 5aa1b75e95
5 changed files with 453 additions and 20 deletions
--- a/.claude/skills/command-guide/SKILL.md
+++ b/.claude/skills/command-guide/SKILL.md
@@ -78,15 +78,26 @@ Comprehensive command guide for Claude DMS3 workflow system covering 69 commands

 **When**: User wants to report issue or request feature

-**Triggers**: **"CCW-issue"**, **"CCW-help"**, "报告 bug", "功能建议", "问题咨询"
+**Triggers**: **"CCW-issue"**, **"CCW-help"**, "报告 bug", "功能建议", "问题咨询", "交互式诊断"

 **Process**:
-1. Use AskUserQuestion to confirm type (bug/feature/question)
-2. Collect required information interactively
-3. Select appropriate template (`templates/issue-{type}.md`)
-4. Generate filled template and save/display
+1. Use AskUserQuestion to confirm type (diagnosis/bug/feature/question)
+2. Collect required information interactively with **execution flow emphasis**
+3. Select appropriate template:
+   - `issue-diagnosis.md` - Full diagnostic workflow with decision tree
+   - `issue-bug.md` - Bug report with complete command history
+   - `issue-feature.md` - Feature request with current workflow analysis
+   - `issue-question.md` - Question with detailed attempt history
+4. Generate filled template with privacy-protected command history
+5. Save/display with troubleshooting guidance

-**Example**: "CCW-issue" → Interactive Q&A → Generates GitHub issue template
+**Example**: "CCW-issue" → Interactive Q&A → Generates GitHub issue template with full execution context
+
+**🆕 Enhanced Features**:
+- Complete command history with privacy protection
+- Interactive diagnostic checklists
+- Decision tree navigation (diagnosis template)
+- Execution environment capture

 ---

@@ -117,11 +128,18 @@ All command metadata is stored in JSON indexes for fast querying:

 ## 🛠️ Issue Templates

-Generate standardized GitHub issue templates:
+Generate standardized GitHub issue templates with **execution flow emphasis**:

- **[Bug Report](templates/issue-bug.md)** - Report command errors or system bugs
- **[Feature Request](templates/issue-feature.md)** - Suggest new features or improvements
- **[Question](templates/issue-question.md)** - Ask usage questions or request help
+- **[Interactive Diagnosis](templates/issue-diagnosis.md)** - 🆕 Comprehensive diagnostic workflow with decision tree, checklists, and full command history
+- **[Bug Report](templates/issue-bug.md)** - Report command errors with complete execution flow and environment details
+- **[Feature Request](templates/issue-feature.md)** - Suggest improvements with current workflow analysis and pain points
+- **[Question](templates/issue-question.md)** - Ask usage questions with detailed attempt history and context
+
+**All templates now include**:
+- ✅ Complete command history sections (with privacy protection)
+- ✅ Execution environment details
+- ✅ Interactive problem-locating checklists
+- ✅ Structured troubleshooting guidance

 Templates are auto-populated during Mode 5 (Issue Reporting) interaction.

@@ -174,6 +192,12 @@ Team members get latest indexes via `git pull`.

 ---

-**Version**: 1.1.0
+**Version**: 1.2.0 (Issue templates enhanced with execution flow emphasis)
 **Last Updated**: 2025-11-06
 **Maintainer**: Claude DMS3 Team
+
+**Changelog v1.2.0**:
+- ✅ Added Interactive Diagnosis template with decision tree
+- ✅ Enhanced all templates with complete command history sections
+- ✅ Added privacy protection guidelines for sensitive information
+- ✅ Integrated execution flow emphasis across all issue templates
--- a/.claude/skills/command-guide/templates/issue-bug.md
+++ b/.claude/skills/command-guide/templates/issue-bug.md
@@ -10,10 +10,51 @@ labels: bug

 <!-- 简要描述遇到的问题 -->

-## 执行的命令
+## 完整执行流程
+
+### 执行环境

 ```bash
-<!-- 粘贴执行的命令 -->
+# 工作目录
+# [填写您的工作目录]
+
+# 相关环境变量（如适用）
+# [如：CLAUDE_WORKFLOW_SESSION]
+```
+
+### 完整命令历史
+
+<!-- ⚠️ 隐私提示: 请删除或替换敏感信息（API密钥、密码、真实路径、用户名等） -->
+
+```bash
+# 命令 1 - [描述此命令的目的]
+# [粘贴命令]
+
+# 输出:
+# [粘贴输出，删除敏感信息]
+
+# 命令 2 - [描述此命令的目的]
+# [粘贴命令]
+
+# 输出:
+# [粘贴输出，删除敏感信息]
+
+# 问题出现在这个命令 ⬇️
+# 命令 3 - [问题命令]
+# [粘贴命令]
+
+# 错误输出:
+# [粘贴完整错误信息]
+```
+
+**隐私保护**:
+- ✅ 保留: 命令名称、参数结构、错误代码
+- ❌ 移除: API密钥、密码、真实路径、个人信息
+
+### 触发问题的具体命令
+
+```bash
+<!-- 单独列出触发问题的命令，以便快速重现 -->
 ```

 ## 期望行为
--- a/.claude/skills/command-guide/templates/issue-diagnosis.md
+++ b/.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 种解决方案（第五步）
+- [ ] 已清晰总结核心问题（第六步）
+- [ ] 已附加必要的系统信息和日志
+
+---
+
+**诊断日期**: <!-- 自动填充 -->
+**提交人**: <!-- 自动填充 -->
--- a/.claude/skills/command-guide/templates/issue-feature.md
+++ b/.claude/skills/command-guide/templates/issue-feature.md
@@ -14,6 +14,39 @@ labels: enhancement

 <!-- 描述当前的痛点或限制，这个功能将解决什么问题？ -->

+### 当前工作流程
+
+<!-- 描述您现在是如何完成相关任务的 -->
+
+**典型操作流程**:
+
+```bash
+# 步骤 1 - [描述当前做法]
+# [当前使用的命令或操作]
+
+# 步骤 2 - [描述当前做法]
+# [当前使用的命令或操作]
+
+# 步骤 3 - [描述当前做法]
+# [当前使用的命令或操作]
+```
+
+### 当前方案的痛点
+
+<!-- 列出当前方案的具体问题 -->
+
+- **痛点 1**: <!-- 具体描述 -->
+  - 影响: <!-- 如何影响效率 -->
+  - 频率: <!-- 多久遇到一次 -->
+
+- **痛点 2**:
+  - 影响:
+  - 频率:
+
+- **痛点 3**:
+  - 影响:
+  - 频率:
+
 ## 建议的解决方案

 <!-- 详细描述您建议的功能实现方式 -->
--- a/.claude/skills/command-guide/templates/issue-question.md
+++ b/.claude/skills/command-guide/templates/issue-question.md
@@ -10,21 +10,81 @@ labels: question

 <!-- 清楚地描述您的问题或困惑 -->

-## 当前情况
+## 当前情况与执行流程

 <!-- 描述您当前的情况和已尝试的方法 -->

-### 相关命令
+### 工作环境

 ```bash
-<!-- 如果与特定命令相关，请粘贴命令 -->
+# 工作目录
+# [填写您的工作目录]
+
+# 项目类型
+# [如：React应用、Node.js API、数据分析项目等]
 ```

-### 已尝试的方法
+### 完整执行流程

-1.
-2.
-3.
+<!-- ⚠️ 隐私提示: 请删除或替换敏感信息（API密钥、密码、真实路径、用户名等） -->
+
+#### 尝试 1
+
+**目的**: <!-- 您想实现什么 -->
+
+**执行的命令**:
+```bash
+# [粘贴命令]
+```
+
+**结果**: <!-- 成功/失败/部分成功 -->
+
+**输出/问题**:
+```bash
+# [粘贴输出或描述问题，删除敏感信息]
+```
+
+**您的困惑**: <!-- 在这一步您不确定什么 -->
+
+#### 尝试 2
+
+**目的**:
+
+**执行的命令**:
+```bash
+# [粘贴命令]
+```
+
+**结果**: <!-- 成功/失败/部分成功 -->
+
+**输出/问题**:
+```bash
+# [粘贴输出或描述问题]
+```
+
+**您的困惑**:
+
+#### 尝试 3
+
+**目的**:
+
+**执行的命令**:
+```bash
+# [粘贴命令]
+```
+
+**结果**: <!-- 成功/失败/部分成功 -->
+
+**输出/问题**:
+```bash
+# [粘贴输出或描述问题]
+```
+
+**您的困惑**:
+
+**隐私保护**:
+- ✅ 保留: 命令名称、参数结构
+- ❌ 移除: API密钥、密码、真实路径、个人信息

 ## 具体疑问