zhuge-workflow 0.1.0

package/templates/claude/commands/developer/design-doc.md

@@ -0,0 +1,188 @@
+---
+description: 生成技术设计文档框架
+---
+
+根据以下信息，为「$ARGUMENTS」生成技术设计文档框架。
+
+请按照以下模板结构生成，根据实际需求填充内容：
+
+---
+
+# [功能名称] 设计文档
+
+作者：wwj
+版本：v1.0
+日期：[当前日期]
+状态：草稿
+
+---
+
+## 一、需求背景
+
+[简要描述功能的业务背景和目标]
+
+---
+
+## 二、核心原则
+
+<!-- [注释] 列出 3-5 条设计原则，指导后续设计决策 -->
+
+1. **原则1**：[说明]
+2. **原则2**：[说明]
+3. **原则3**：[说明]
+
+---
+
+## 三、术语定义（如需要）
+
+<!-- [注释] 如果有业务术语或技术术语需要统一，在此定义 -->
+
+| 术语 | 定义 | 说明 |
+|------|------|------|
+| [术语1] | [定义] | [说明] |
+
+---
+
+## 四、数据库设计
+
+### 4.1 新增/修改表
+
+```sql
+-- [表名] - [说明]
+CREATE TABLE / ALTER TABLE ...
+```
+
+### 4.2 字段说明
+
+| 字段 | 类型 | 位置 | 说明 |
+|------|------|------|------|
+| [字段名] | [类型] | [表名] | [说明] |
+
+---
+
+## 五、功能设计
+
+### 5.1 [功能模块1]
+
+#### 5.1.1 功能概述
+
+[功能描述]
+
+#### 5.1.2 界面设计
+
+<!-- [注释] 如有界面变化，用 ASCII 图或描述说明 -->
+
+| 操作 | 元素 | 说明 |
+|------|------|------|
+| 新增 | [元素] | [说明] |
+| 修改 | [元素] | [说明] |
+
+#### 5.1.3 处理逻辑
+
+```
+[流程说明或伪代码]
+```
+
+### 5.2 [功能模块2]
+
+[同上结构]
+
+---
+
+## 六、接口设计
+
+### 6.1 [接口名称]
+
+```
+[METHOD] /api/[path]
+
+请求参数：
+{
+  "field1": "type - 说明"
+}
+
+响应：
+{
+  "code": 200,
+  "message": "成功",
+  "data": { ... }
+}
+```
+
+**实现位置**：
+- Controller: `[文件路径]`
+- Service: `[文件路径]`
+
+---
+
+## 七、前端设计
+
+### 7.1 组件结构
+
+```
+[目录结构]
+```
+
+### 7.2 页面实现
+
+**文件位置**：`[文件路径]`
+
+```typescript
+// 关键代码片段
+```
+
+---
+
+## 八、影响范围评估
+
+### 8.1 代码改动范围
+
+| 模块 | 文件 | 改动类型 | 说明 |
+|------|------|---------|------|
+| [模块] | [文件] | 新增/修改 | [说明] |
+
+### 8.2 风险评估
+
+| 风险 | 影响 | 缓解措施 |
+|------|------|---------|
+| [风险] | [影响] | [措施] |
+
+---
+
+## 九、测试要点
+
+### 9.1 功能测试清单
+
+- [ ] [测试点1]
+- [ ] [测试点2]
+- [ ] [测试点3]
+
+### 9.2 测试用例
+
+| 测试用例 | 输入 | 预期结果 |
+|---------|------|---------|
+| [用例1] | [输入] | [预期] |
+
+---
+
+## 十、部署/迁移说明（如需要）
+
+### 10.1 数据库迁移
+
+```sql
+-- 迁移脚本
+```
+
+### 10.2 配置变更
+
+| 配置项 | 变更 | 说明 |
+|-------|------|------|
+| [配置] | [变更] | [说明] |
+
+---
+
+**文档版本历史**
+
+| 版本 | 日期 | 作者 | 说明 |
+|------|------|------|------|
+| v1.0 | [日期] | wwj | 初稿 |

package/templates/claude/commands/developer/requirement-doc.md

@@ -0,0 +1,150 @@
+---
+description: 生成需求文档框架
+---
+
+根据以下信息，为「$ARGUMENTS」生成需求文档框架。
+
+请按照以下模板结构生成，根据实际需求填充内容：
+
+---
+
+# [功能名称] 需求文档
+
+作者：wwj
+版本：v1.0
+日期：[当前日期]
+状态：草稿
+
+---
+
+## 一、背景
+
+<!-- [注释] 简要描述业务背景、问题或机会 -->
+
+[背景描述]
+
+**所有改动仅对 [范围] 生效，不影响 [其他范围]。**
+
+---
+
+## 二、功能清单
+
+| 序号 | 功能模块 | 功能点 | 优先级 |
+|------|---------|-------|--------|
+| 1 | [模块] | [功能点] | 高/中/低 |
+| 2 | [模块] | [功能点] | 高/中/低 |
+
+---
+
+## 三、[模块1名称]
+
+### 3.1 界面变化
+
+| 变化项 | 原显示 | 新显示 |
+|--------|-------|--------|
+| [变化项] | [原] | [新] |
+
+### 3.2 功能说明
+
+**[功能名称]**
+
+**触发条件**：[条件描述]
+
+**输入/模板字段**：
+
+| 字段名 | 是否必填 | 说明 |
+|--------|---------|------|
+| [字段] | 是/否 | [说明] |
+
+**处理规则**：
+- 规则1
+- 规则2
+
+---
+
+## 四、[模块2名称]
+
+### 4.1 界面术语变化
+
+| 系统原显示 | 新显示 |
+|-----------|--------|
+| [原] | [新] |
+
+### 4.2 新增字段
+
+| 字段 | 说明 |
+|------|------|
+| [字段] | [说明] |
+
+### 4.3 处理逻辑
+
+```
+[流程或规则描述]
+```
+
+**示例**：
+
+| 输入 | 处理 | 输出 |
+|------|------|------|
+| [输入] | [处理] | [输出] |
+
+---
+
+## 五、业务流程
+
+```
+┌─────────────────────────────────────────┐
+│              [流程名称]                   │
+├─────────────────────────────────────────┤
+│                                         │
+│   第一步：[步骤名称]                       │
+│   ┌─────────────────────────────────┐   │
+│   │ 1. [操作1]                       │   │
+│   │ 2. [操作2]                       │   │
+│   └─────────────────────────────────┘   │
+│                    ↓                     │
+│   第二步：[步骤名称]                       │
+│   ┌─────────────────────────────────┐   │
+│   │ 1. [操作1]                       │   │
+│   │ 2. [操作2]                       │   │
+│   └─────────────────────────────────┘   │
+│                                         │
+└─────────────────────────────────────────┘
+```
+
+---
+
+## 六、验收清单
+
+### 6.1 [模块1]
+
+- [ ] [验收点1]
+- [ ] [验收点2]
+
+### 6.2 [模块2]
+
+- [ ] [验收点1]
+- [ ] [验收点2]
+
+### 6.3 约束条件
+
+- [ ] [约束1，如"仅对XX生效"]
+- [ ] [约束2，如"不影响其他XX"]
+
+---
+
+## 七、非功能需求（如需要）
+
+| 需求类型 | 要求 |
+|---------|------|
+| 性能 | [要求] |
+| 兼容性 | [要求] |
+| 安全性 | [要求] |
+
+---
+
+**文档版本历史**
+
+| 版本 | 日期 | 作者 | 说明 |
+|------|------|------|------|
+| v1.0 | [日期] | wwj | 初稿 |

package/templates/claude/commands/developer/requirement-interrogate.md

@@ -0,0 +1,71 @@
+---
+description: 需求极刑审问，挖掘逻辑漏洞
+---
+
+你是一位**极度苛刻的高级系统架构师和产品总监**。你的任务不是帮用户完善需求，而是**挑战和质疑**。
+
+## 用户的原始需求
+
+「$ARGUMENTS」
+
+## 你的任务
+
+### 第一步：逻辑漏洞扫描
+
+无情地指出需求中的问题：
+- 逻辑不通的地方
+- 状态缺失（失败了怎么办？网断了怎么办？超时了怎么办？）
+- 权限定义模糊
+- 边界条件未定义
+
+### 第二步：数据流拷问
+
+针对核心功能，质问数据是如何流转的：
+- 数据从哪里来？存到哪里？
+- 并发场景怎么处理？
+- 数据一致性怎么保证？
+- 缓存策略是什么？
+
+### 第三步：生成深度调研问卷
+
+基于以上分析，生成《深度需求调研表》：
+- 问题必须具体
+- 给出 A/B/C 选项供选择
+- 标注哪些是必须回答的
+
+## 输出格式
+
+```markdown
+## 🔴 逻辑漏洞
+
+1. **[问题标题]**
+   - 问题描述：...
+   - 潜在风险：...
+
+## 🟡 数据流疑点
+
+1. **[疑点标题]**
+   - 当前理解：...
+   - 需要澄清：...
+
+## 📋 深度需求调研表
+
+### 必答问题
+
+**Q1：[问题]**
+- A. [选项A]
+- B. [选项B]
+- C. 其他（请说明）
+
+### 建议回答
+
+**Q2：[问题]**
+- A. [选项A]
+- B. [选项B]
+```
+
+## 重要提示
+
+- **不要**直接生成 PRD 或需求文档
+- **只**生成问卷和质疑
+- 用户回答问卷后，再使用 `/developer:requirement-doc` 生成正式需求文档

package/templates/claude/commands/developer/status.md

@@ -0,0 +1,55 @@
+---
+description: 显示当前加载的配置状态
+---
+
+显示当前 Claude Code 配置的加载状态，帮助诊断配置问题。
+
+## 输出格式
+
+```
+## 当前配置状态
+
+### Rules（始终生效）
+- claude-code-defensive.md - 防御性规则
+- ops-safety.md - 运维安全
+- doc-sync.md - 文档同步
+- bash-style.md - Bash 编写规范
+- lsp-usage.md - LSP 使用规则
+
+### Skills（按需加载）
+[根据本次会话操作的文件类型列出]
+- dotnet-dev（已触发：操作了 .cs 文件）
+- 或：暂无触发
+
+### LSP（语言服务器）
+[检查各 LSP 服务器状态]
+- csharp-ls: ✅ 可用 / ❌ 未安装
+- typescript-language-server: ✅ 可用 / ❌ 未安装
+
+### Commands（可用命令）
+设计：/developer:design-doc, /developer:design-checklist, /developer:requirement-doc,/developer:requirement-interrogate
+诊断：/developer:status
+```
+
+## 执行步骤
+
+1. 列出 `~/.claude/rules/` 下所有 `.md` 文件
+2. 检查本次会话是否触发了任何 Skill
+3. 检查 LSP 服务器安装状态（csharp-ls, typescript-language-server）
+4. 列出所有可用命令
+
+## LSP 检查命令
+
+```bash
+# Go
+which gopls
+
+# TypeScript
+which typescript-language-server
+
+# Python
+which pyright
+
+# Java (macOS)
+which jdtls
+```

package/templates/claude/rules/bash-style.md

@@ -0,0 +1,46 @@
+---
+paths:
+  - "**/*.sh"
+  - "**/Dockerfile"
+  - "**/Makefile"
+  - "**/*.yml"
+  - "**/*.yaml"
+  - "**/*.md"
+---
+# Bash 核心规范
+
+> 详细规范见 `skills/bash-style/`，操作 .sh/.md/Dockerfile 等文件时自动加载。
+
+---
+
+## 禁止行尾注释
+
+```bash
+# ❌ 错误
+curl -X POST https://api.example.com # 发送请求
+
+# ✅ 正确
+# 发送请求
+curl -X POST https://api.example.com
+```
+
+**适用范围**：.sh 脚本、Markdown 代码块、Dockerfile、Makefile
+
+---
+
+## 核心要点
+
+| 场景 | 规范 |
+|------|------|
+| 文件写入 | `sudo tee file > /dev/null << 'EOF'` |
+| Heredoc | 默认用 `<< 'EOF'`（禁止变量展开） |
+| 脚本头 | `#!/usr/bin/env bash` + `set -euo pipefail` |
+| 变量 | 用 `${var}` 包裹，设默认值 `${VAR:-default}` |
+
+---
+
+## 规则溯源
+
+```
+> 📋 本回复遵循：`bash-style.md` - [章节]
+```

package/templates/claude/rules/claude-code-defensive.md

@@ -0,0 +1,99 @@
+---
+paths: "**/*"
+---
+# Claude Code 防御性规则
+
+> 预防常见 AI 编码陷阱，基于社区最佳实践。
+
+---
+
+## 🚫 严格禁止
+
+### 1. 测试篡改（最严重）
+- ❌ 修改测试断言来适配错误实现
+- ❌ 删除或注释掉失败的测试
+- ✅ 测试失败时，修复实现代码
+
+### 2. 过度工程化
+- 新增功能控制在 3 个文件以内
+- 简单 if/else 优于复杂抽象
+- 不要创建"策略模式"、"工厂模式"等，除非明确需要
+
+### 3. 盲目修改代码
+修改前必须：搜索类似功能 → 检查调用点 → 了解影响范围
+
+### 4. 中途放弃任务
+- 创建 TODO 列表后，完成所有项目再停止
+- 遇到困难时请求帮助，不要直接放弃
+
+### 5. 幽灵代码
+- ❌ 用"注释掉旧实现"代替删除
+- ❌ 提交调试残留：`print`/`console.log`/`debugger`
+
+### 6. 主动创建文档
+只在明确要求时创建文档，不要主动生成中间总结、变更说明等
+
+### 7. 自动添加元数据
+- ❌ "Generated with Claude Code" 或类似标记
+- ❌ AI 生成声明、作者署名、自动时间戳
+
+### 8. Git远程操作
+- ❌ 执行Git Push等相关远程代码库操作
+
+---
+
+## ✅ 必须遵循
+
+### 1. Type-First（类型先行）
+编写业务逻辑前，先定义数据结构（Go: struct/interface, TS: interface/type, Java: DTO/VO）
+
+### 2. 复杂任务工作流
+**复杂任务**：超过 3 个步骤或涉及多个文件
+
+```
+步骤1: 说明计划 → 等待确认 ⏸️
+步骤2: 逐步实现 → 验证功能
+步骤3: 完成验证 → 所有测试通过
+```
+
+### 3. 检查清单
+**修改前**：搜索类似功能 / 了解现有模式 / 确认不破坏现有功能
+
+**提交前**：测试通过 / 无调试残留 / TODO 全部完成
+
+### 4. LSP 使用原则
+**优先用 LSP**：查找定义、查找引用、大型项目导航
+
+**不用 LSP（直接 Grep/Read）**：全文搜索、搜索注释/字符串、理解整体架构、查看文件结构
+
+**调用声明**：`> 🔍 LSP: gopls - Find References`
+
+---
+
+## 📂 大文件处理
+
+| 目的 | 方法 |
+|------|------|
+| 找特定内容 | `Grep: pattern="functionName"` |
+| 读特定区域 | `Read: offset=150, limit=50` |
+| 修改某处 | Grep 定位 → Read 上下文 → Edit |
+
+---
+
+## 🎯 决策原则
+
+```
+简单方案 > 复杂方案
+复用现有 > 创建新的
+直接实现 > 抽象封装
+```
+
+**问题排查**：复现 → 假设 → 验证（一次改一个变量） → 最小修复
+
+---
+
+## 规则溯源
+
+```
+> 📋 本回复遵循：`claude-code-defensive.md` - [章节]
+```

package/templates/claude/rules/doc-sync.md

@@ -0,0 +1,49 @@
+---
+paths: "**/*"
+---
+# 文档同步规则
+
+> 配置/结构变更时提醒更新相关文档。
+
+---
+
+## 触发条件
+
+| 变更类型 | 需要更新 |
+|---------|---------|
+| 新增/修改/删除 `commands/` | README.md（命令列表） |
+| 新增/修改/删除 `skills/` | README.md（技能列表） |
+| 新增/修改/删除 `rules/` | README.md（规则列表） |
+| 项目结构变更（新增/删除核心目录） | CLAUDE.md |
+| 技术栈变更（go.mod/package.json 主要依赖） | CLAUDE.md |
+| 构建/部署变更（启动脚本、Docker 配置） | CLAUDE.md |
+
+---
+
+## 提醒格式
+
+```
+检测到配置变更：
+- [变更描述]
+
+是否需要同步更新文档？
+1. 是，帮我更新
+2. 否，跳过
+```
+
+---
+
+## 不触发的情况
+
+- 普通业务代码修改
+- bug 修复
+- 现有模块内的功能调整
+- 测试代码变更
+
+---
+
+## 更新原则
+
+- 最小更新：只更新变更相关部分
+- 保持格式：遵循现有文档格式
+- 同步更新：相关文档一起更新

package/templates/claude/rules/ops-safety.md

@@ -0,0 +1,32 @@
+---
+paths: "**/*"
+---
+# 运维安全核心规则
+
+> 详细规范见 `skills/ops-safety/`，执行系统命令时自动加载。
+
+---
+
+## 系统级命令必须说明
+
+执行 sysctl/iptables/systemctl 等命令前，必须说明：
+- **影响范围** + **风险等级** + **回滚方案**
+
+---
+
+## 核心原则
+
+| 原则 | 说明 |
+|------|------|
+| 不扩散问题 | A 配置出问题，先恢复 A，不要改 B/C/D |
+| 最小改动 | 一次只改一个变量，验证后再下一步 |
+| 不动正常配置 | 用户说正常的配置，不要建议修改 |
+
+---
+
+## 禁止行为
+
+- ❌ 无风险说明的系统命令
+- ❌ 不完整的回滚方案
+- ❌ 未经确认执行高风险命令
+- ❌ 同时修改多个配置