@waoooo/claude-skills 1.0.0

package/skills/specs-review/SKILL.md

@@ -0,0 +1,370 @@
+# Skill: specs-review
+
+## 🚨 重要：这是 AI 推理型 Skill
+
+**执行方式**：
+1. 读取开发规范文件（README.md, tasks.json, verification.json）
+2. 生成审查提示词
+3. **使用 Bash 工具调用 CCB 命令**：
+   ```
+   Bash(ask gemini "审查提示词")
+   Bash(ask codex "审查提示词")
+   ```
+4. 等待 30 秒
+5. **使用 Bash 工具获取回复**：
+   ```
+   Bash(pend gemini)
+   Bash(pend codex)
+   ```
+6. 解析回复并汇总结果
+7. 生成报告
+
+**禁止**：
+- ❌ 不要只输出文本
+- ❌ 不要自己单独评估
+
+**必须**：
+- ✅ 必须使用 Bash 工具调用 `ask` 和 `pend` 命令
+- ✅ 必须等待并解析回复
+
+---
+
+## 功能
+
+多模型会审开发规范（specs/ 目录）质量，确保任务列表、验证规则、开发规范的完整性和可执行性。
+
+## 何时调用
+
+- spec-generate 完成后（步骤 11）
+- 需要验证开发规范质量时
+- 开始执行前的最后检查
+
+## 输入
+
+- `jobId` - Job ID（例如：2026-02-10-1520-pricing-system）
+- `specsPath` - specs/ 目录路径（例如：exports/jobs/2026-02-10-1520-pricing-system/specs/）
+
+## 输出
+
+保存到 `exports/jobs/<job-id>/reviews/specs-review/` 目录：
+- `claude.json` - Claude 的审查结果
+- `gemini.json` - Gemini 的审查结果
+- `codex.json` - Codex 的审查结果
+- `summary.md` - 汇总报告（Markdown 格式）
+
+## 审查内容
+
+### 1. tasks.json（任务列表）
+- 任务是否覆盖所有需求？
+- 任务粒度是否合适？
+- 任务依赖关系是否正确？
+- 任务顺序是否合理？
+- 预计工时是否合理？
+
+### 2. verification.json（验证规则）
+- 验证命令是否完整？
+- 验证标准是否明确？
+- 是否覆盖所有关键功能？
+- 是否包含性能/安全测试？
+- 验证命令是否可执行？
+
+### 3. README.md（开发规范）
+- 开发规范是否清晰？
+- 技术栈说明是否完整？
+- 目录结构是否合理？
+- 开发流程是否明确？
+- 注意事项是否充分？
+
+## 审查者
+
+**⚠️ 重要：使用 Claude Code Bridge (ccb) 工具进行多模型会审**
+
+### 调用方式
+
+参考 `openspec-review` Skill 的调用方式，审查内容改为：
+
+```
+请审查开发规范: exports/jobs/<job-id>/specs/
+
+审查维度：
+1. tasks.json - 任务列表是否完整合理？
+2. verification.json - 验证规则是否充分？
+3. README.md - 开发规范是否清晰？
+
+请 Codex 和 Gemini 也分别审查，然后汇总结果。
+```
+
+## 执行步骤
+
+### 1. 读取 specs/ 文件
+
+```bash
+# 读取 3 个文件（progress.json 不需要审查）
+cat exports/jobs/<job-id>/specs/tasks.json
+cat exports/jobs/<job-id>/specs/verification.json
+cat exports/jobs/<job-id>/specs/README.md
+```
+
+### 2. 并行调用 4 个模型
+
+为每个模型生成相同的审查提示词：
+
+```
+你是一个资深的软件工程师，请审查以下开发规范的质量。
+
+## 审查维度
+
+### 1. tasks.json（任务列表）
+- 任务是否覆盖所有需求？
+- 任务粒度是否合适（不要太大也不要太小）？
+- 任务依赖关系是否正确？
+- 任务顺序是否合理？
+- 预计工时是否合理？
+
+### 2. verification.json（验证规则）
+- 验证命令是否完整？
+- 验证标准是否明确？
+- 是否覆盖所有关键功能？
+- 是否包含性能/安全测试？
+- 验证命令是否可执行（命令格式正确）？
+
+### 3. README.md（开发规范）
+- 开发规范是否清晰？
+- 技术栈说明是否完整？
+- 目录结构是否合理？
+- 开发流程是否明确？
+- 注意事项是否充分？
+
+## 审查内容
+
+### tasks.json
+{tasks_content}
+
+### verification.json
+{verification_content}
+
+### README.md
+{readme_content}
+
+## 请提供
+
+1. **总体评分**（1-10）
+2. **审查结果**：approved / approved_with_suggestions / rejected
+3. **具体问题列表**（如果有）
+   - 文件：tasks.json / verification.json / README.md
+   - 问题类型：critical / medium / low
+   - 问题描述
+   - 建议修改方案
+
+请以 JSON 格式返回结果。
+```
+
+### 3. 收集审查结果
+
+```json
+{
+  "jobId": "2026-02-10-1520-pricing-system",
+  "reviewedAt": "2026-02-11T03:20:00Z",
+  "status": "approved",
+  
+  "reviews": [
+    {
+      "reviewer": "claude-sonnet-4",
+      "score": 9.0,
+      "status": "approved",
+      "findings": []
+    },
+    {
+      "reviewer": "gpt-4",
+      "score": 8.5,
+      "status": "approved",
+      "findings": [
+        {
+          "file": "verification.json",
+          "type": "suggestion",
+          "severity": "low",
+          "message": "建议添加 E2E 测试验证",
+          "suggestion": "添加 pnpm test:e2e 到 preMergeChecks"
+        }
+      ]
+    },
+    {
+      "reviewer": "claude-opus-4",
+      "score": 8.0,
+      "status": "approved",
+      "findings": [
+        {
+          "file": "tasks.json",
+          "type": "suggestion",
+          "severity": "low",
+          "message": "任务 5 的预计工时可能偏低",
+          "suggestion": "建议从 4h 调整为 6h"
+        }
+      ]
+    },
+    {
+      "reviewer": "gemini-2.0-flash-thinking",
+      "score": 9.0,
+      "status": "approved",
+      "findings": []
+    }
+  ],
+  
+  "summary": {
+    "overallScore": 8.625,
+    "passRate": 1.0,
+    "status": "approved",
+    "criticalIssues": 0,
+    "mediumIssues": 0,
+    "suggestions": 2,
+    "recommendation": "可以继续执行"
+  }
+}
+```
+
+### 4. 生成汇总报告
+
+```markdown
+# 开发规范审查报告
+
+**Job ID**: 2026-02-10-1520-pricing-system  
+**审查时间**: 2026-02-11 03:20:00  
+**总体评分**: 8.625/10  
+**通过率**: 100% (4/4)  
+**状态**: ✅ 通过
+
+---
+
+## 审查结果
+
+### ✅ Claude Sonnet 4 (9.0/10)
+- ✅ 任务列表完整合理
+- ✅ 验证规则覆盖充分
+- ✅ 开发规范清晰明确
+
+### ✅ GPT-4 (8.5/10)
+- ✅ 整体质量良好
+- 💡 建议添加 E2E 测试验证
+
+### ✅ Claude Opus 4 (8.0/10)
+- ✅ 规范完整可执行
+- 💡 任务 5 的预计工时可能偏低，建议调整
+
+### ✅ Gemini 2.0 Flash Thinking (9.0/10)
+- ✅ 开发规范质量优秀
+- ✅ 无明显问题
+
+---
+
+## 建议
+
+1. **低优先级**: 添加 E2E 测试验证到 verification.json
+2. **低优先级**: 调整任务 5 的预计工时（4h → 6h）
+
+---
+
+## 结论
+
+✅ **可以继续执行**
+
+开发规范质量优秀，可以直接开始执行开发任务。
+建议采纳以上 2 个低优先级建议以进一步提升质量。
+```
+
+### 5. 输出结果
+
+将 3 个模型的审查结果保存到：
+```
+exports/jobs/<job-id>/reviews/specs-review/
+├── claude.json       # Claude 的审查结果
+├── gemini.json       # Gemini 的审查结果
+├── codex.json        # Codex 的审查结果
+└── summary.md        # 汇总报告（Markdown 格式）
+```
+
+**注意**：
+- 每个模型的结果单独保存为 JSON 文件
+- summary.md 包含所有模型的结果和统计信息
+- 决策逻辑由 Agent 根据 CLAUDE.md 中的规则执行
+
+## 使用示例
+
+### 示例 1：全部通过
+
+```
+Agent 调用 specs-review:
+  输入:
+  - jobId: 2026-02-10-1520-pricing-system
+  - specsPath: exports/jobs/2026-02-10-1520-pricing-system/specs/
+
+执行:
+  🔧 步骤 1: 读取 specs/ 文件
+  ⏳ 读取: tasks.json, verification.json, README.md
+
+  🔧 步骤 2: 并行调用 4 个模型
+  ⏳ Claude Sonnet 4: 审查中...
+  ⏳ GPT-4: 审查中...
+  ⏳ Claude Opus 4: 审查中...
+  ⏳ Gemini 2.0: 审查中...
+
+  🔧 步骤 3: 汇总结果
+  ✅ 通过率: 100% (4/4)
+  ✅ 总体评分: 8.625/10
+
+显示结果:
+  ✅ 开发规范会审通过
+
+  📊 审查结果:
+  - Claude Sonnet 4: 9.0/10 ✅
+  - GPT-4: 8.5/10 ✅
+  - Claude Opus 4: 8.0/10 ✅
+  - Gemini 2.0: 9.0/10 ✅
+
+  💡 建议:
+  1. 添加 E2E 测试验证
+  2. 调整任务 5 的预计工时
+
+  📄 详细报告:
+  - review-specs.json
+  - review-specs-summary.md
+
+  💡 下一步:
+  可以继续生成全局视图和规划文档
+```
+
+## 错误处理
+
+### 错误 1：specs/ 文件不完整
+
+```
+❌ 错误: specs/ 文件不完整
+🔍 原因: 缺少 tasks.json 或 verification.json 或 README.md
+
+💡 建议:
+1. 检查 specs/ 目录
+2. 重新运行 spec-generate
+```
+
+### 错误 2：验证命令格式错误
+
+```
+⚠️  警告: 验证命令可能无法执行
+🔍 原因: verification.json 中的命令格式不正确
+
+💡 建议:
+1. 检查命令格式
+2. 确认命令在 package.json 中存在
+```
+
+## 注意事项
+
+1. **不审查 progress.json** - 这是动态文件，初始状态固定
+2. **并行调用** - 4 个模型同时调用，提高效率
+3. **可执行性检查** - 特别关注验证命令是否可执行
+4. **工时合理性** - 检查预计工时是否符合任务复杂度
+5. **覆盖完整性** - 确保任务覆盖所有需求
+
+## 相关文件
+
+- `exports/jobs/<job-id>/reviews/review-specs.json`
+- `exports/jobs/<job-id>/reviews/review-specs-summary.md`