@waoooo/claude-skills 1.0.0

package/skills/openspec-review/SKILL.md

@@ -0,0 +1,513 @@
+# Skill: openspec-review
+
+## 🚨 重要：这是 AI 推理型 Skill
+
+**执行方式**：
+1. 读取 OpenSpec 文件（proposal.md, design.md, tasks.md）
+2. 生成审查提示词
+3. **使用 Bash 工具调用 CCB 命令**：
+   ```
+   Bash(ask gemini "审查提示词")
+   Bash(ask codex "审查提示词")
+   ```
+4. 等待 30 秒让模型处理
+5. **使用 Bash 工具获取回复**：
+   ```
+   Bash(pend gemini)
+   Bash(pend codex)
+   ```
+6. 解析回复中的 JSON 结果
+7. 汇总 3 个模型（Claude + Gemini + Codex）的审查结果
+8. 生成报告文件
+
+**禁止**：
+- ❌ 不要只输出"请 Gemini 帮我审查"文本
+- ❌ 不要自己单独评估
+- ❌ 不要跳过多模型会审
+
+**必须**：
+- ✅ 必须使用 Bash 工具调用 `ask` 命令
+- ✅ 必须使用 Bash 工具调用 `pend` 命令
+- ✅ 必须等待并解析其他模型的回复
+- ✅ 必须汇总 3 个模型的结果
+
+---
+
+## 功能
+
+多模型会审 OpenSpec 质量，确保需求文档、技术设计、任务列表的完整性和可行性。
+
+## 何时调用
+
+- MDX → OpenSpec 转换完成后（步骤 5）
+- 需要验证 OpenSpec 质量时
+- 开始开发前的最后检查
+
+## 输入
+
+- `changeId` - OpenSpec 提案 ID（例如：001-pricing-system）
+- `openspecPath` - OpenSpec 目录路径（例如：openspec/changes/001-pricing-system/）
+
+## 输出
+
+保存到 `exports/jobs/<job-id>/reviews/openspec-review/` 目录：
+- `claude.json` - Claude 的审查结果
+- `gemini.json` - Gemini 的审查结果
+- `codex.json` - Codex 的审查结果
+- `summary.md` - 汇总报告（Markdown 格式）
+
+## 审查标准
+
+### 问题严重程度
+
+- **Critical（严重）**: 阻塞性问题，必须修复才能继续
+  - 需求描述不清晰或缺失
+  - 技术方案不可行
+  - 任务拆分有严重错误
+  - 存在明显的逻辑错误
+
+- **Medium（中等）**: 重要问题，建议修复
+  - 需求描述不够完整
+  - 技术方案有风险
+  - 任务依赖关系不清晰
+  - 缺少关键的验收标准
+
+- **Low（轻微）**: 优化建议，可选修复
+  - 文档格式问题
+  - 描述可以更清晰
+  - 建议补充细节
+  - 优化建议
+
+### 单个模型的通过标准
+
+- Critical issues = 0
+- Medium issues ≤ 3
+- Overall score ≥ 7/10
+
+### 输出格式
+
+每个模型返回 JSON 格式：
+```json
+{
+  "model": "claude|gemini|codex",
+  "pass": true|false,
+  "score": 8.5,
+  "status": "approved|approved_with_suggestions|rejected",
+  "issues": {
+    "critical": [
+      {
+        "location": "proposal.md:42",
+        "message": "需求描述不清晰",
+        "suggestion": "建议补充具体的验收标准"
+      }
+    ],
+    "medium": [...],
+    "low": [...]
+  }
+}
+```
+
+---
+
+## 审查内容
+
+### 1. proposal.md（需求提案）
+- 需求是否清晰完整？
+- 目标是否明确？
+- 验收标准是否具体？
+- 关键词是否准确？
+
+### 2. design.md（技术设计）
+- 技术方案是否可行？
+- 架构设计是否合理？
+- 是否有技术风险？
+- 依赖关系是否正确？
+
+### 3. tasks.md（任务列表）
+- 任务拆分是否合理？
+- 任务粒度是否合适？
+- 任务依赖是否正确？
+- 是否有遗漏的任务？
+
+## 审查者
+
+**⚠️ 重要：使用 Claude Code Bridge (ccb) 工具进行多模型会审**
+
+### 前置条件
+
+确保 ccb 已安装并配置（参考项目 README）。
+
+### 调用方式
+
+**步骤 1：启动多模型协作环境**
+
+```bash
+# 启动 Claude + Codex + Gemini 三个模型
+ccb codex gemini claude
+```
+
+这会在终端分屏显示三个 AI 模型，每个模型独立运行。
+
+**步骤 2：在 Claude 中发起会审**
+
+在 Claude 窗格中输入会审请求：
+
+```
+请审查 OpenSpec: openspec/changes/001-pricing-system/
+
+审查维度：
+1. proposal.md - 需求是否清晰完整？
+2. design.md - 技术方案是否可行？
+3. tasks.md - 任务拆分是否合理？
+
+请 Codex 和 Gemini 也分别审查，然后汇总结果。
+```
+
+**步骤 3：跨模型协作**
+
+Claude 会使用 ccb 的 `/ask` 命令与其他模型通信：
+
+```bash
+# Claude 自动调用
+/ask codex "请审查 OpenSpec proposal.md..."
+/ask gemini "请审查 OpenSpec design.md..."
+```
+
+**步骤 4：收集审查结果**
+
+使用 `/pend` 命令获取其他模型的回复：
+
+```bash
+/pend codex    # 获取 Codex 的审查结果
+/pend gemini   # 获取 Gemini 的审查结果
+```
+
+**步骤 5：生成汇总报告**
+
+Claude 汇总所有模型的审查结果，生成：
+- `review-openspec.json` - 结构化审查数据
+- `review-openspec-summary.md` - 可读的汇总报告
+
+## 执行步骤
+
+### 1. 读取 OpenSpec 文件
+
+```bash
+# 读取 3 个文件
+cat openspec/changes/<change-id>/proposal.md
+cat openspec/changes/<change-id>/design.md
+cat openspec/changes/<change-id>/tasks.md
+```
+
+### 2. 并行调用 4 个模型
+
+为每个模型生成相同的审查提示词：
+
+```
+你是一个资深的产品和技术专家，请审查以下 OpenSpec 文档的质量。
+
+## 审查维度
+
+1. **需求完整性**（proposal.md）
+   - 需求是否清晰完整？
+   - 目标是否明确？
+   - 验收标准是否具体？
+
+2. **技术可行性**（design.md）
+   - 技术方案是否可行？
+   - 架构设计是否合理？
+   - 是否有技术风险？
+
+3. **任务合理性**（tasks.md）
+   - 任务拆分是否合理？
+   - 任务粒度是否合适？
+   - 任务依赖是否正确？
+
+## 审查内容
+
+### proposal.md
+{proposal_content}
+
+### design.md
+{design_content}
+
+### tasks.md
+{tasks_content}
+
+## 请提供
+
+1. **总体评分**（1-10）
+2. **审查结果**：approved / approved_with_suggestions / rejected
+3. **具体问题列表**（如果有）
+   - 问题类型：critical / medium / low
+   - 问题描述
+   - 建议修改方案
+
+请以 JSON 格式返回结果。
+```
+
+### 3. 收集审查结果
+
+```json
+{
+  "changeId": "001-pricing-system",
+  "reviewedAt": "2026-02-11T03:14:51Z",
+  "status": "approved_with_suggestions",
+  
+  "reviews": [
+    {
+      "reviewer": "claude-sonnet-4",
+      "score": 8.5,
+      "status": "approved",
+      "findings": [
+        {
+          "type": "suggestion",
+          "severity": "low",
+          "message": "建议补充多货币转换的边界情况处理",
+          "location": "proposal.md:42"
+        }
+      ]
+    },
+    {
+      "reviewer": "gpt-4",
+      "score": 9.0,
+      "status": "approved",
+      "findings": []
+    },
+    {
+      "reviewer": "claude-opus-4",
+      "score": 7.5,
+      "status": "approved_with_suggestions",
+      "findings": [
+        {
+          "type": "issue",
+          "severity": "medium",
+          "message": "任务 3 和任务 5 有依赖关系，但 tasks.md 中未标记",
+          "location": "tasks.md:15-20"
+        }
+      ]
+    },
+    {
+      "reviewer": "gemini-2.0-flash-thinking",
+      "score": 8.0,
+      "status": "approved",
+      "findings": [
+        {
+          "type": "suggestion",
+          "severity": "low",
+          "message": "pricing 能力依赖 payment，建议在 design.md 中说明",
+          "location": "design.md:30"
+        }
+      ]
+    }
+  ],
+  
+  "summary": {
+    "overallScore": 8.25,
+    "passRate": 1.0,
+    "status": "approved_with_suggestions",
+    "criticalIssues": 0,
+    "mediumIssues": 1,
+    "suggestions": 2,
+    "recommendation": "建议修订后继续"
+  }
+}
+```
+
+### 4. 生成汇总报告
+
+```markdown
+# OpenSpec 审查报告
+
+**提案**: 001-pricing-system  
+**审查时间**: 2026-02-11 03:14:51  
+**总体评分**: 8.25/10  
+**通过率**: 100% (4/4)  
+**状态**: ✅ 通过（有建议）
+
+---
+
+## 审查结果
+
+### ✅ Claude Sonnet 4 (8.5/10)
+- ✅ 目标清晰明确
+- ✅ 验收标准完整
+- 💡 建议补充多货币转换的边界情况处理
+
+### ✅ GPT-4 (9.0/10)
+- ✅ 技术方案可行
+- ✅ 无明显技术风险
+
+### ⚠️  Claude Opus 4 (7.5/10)
+- ✅ 任务粒度合适
+- ⚠️  任务 3 和任务 5 有依赖关系，但 tasks.md 中未标记
+- 💡 建议在 tasks.md 中添加依赖标记
+
+### ✅ Gemini 2.0 Flash Thinking (8.0/10)
+- ✅ 能力匹配正确
+- 💡 pricing 能力依赖 payment，建议在 design.md 中说明
+
+---
+
+## 建议
+
+1. **中优先级**: 在 tasks.md 中标记任务 3 和任务 5 的依赖关系
+2. **低优先级**: 补充多货币转换的边界情况处理
+3. **低优先级**: 在 design.md 中说明 pricing 依赖 payment
+
+---
+
+## 结论
+
+✅ **建议修订后继续**
+
+OpenSpec 整体质量良好，有 1 个中优先级问题需要修订。
+修订后可以继续执行后续流程。
+```
+
+### 5. 输出结果
+
+将 3 个模型的审查结果保存到：
+```
+exports/jobs/<job-id>/reviews/openspec-review/
+├── claude.json       # Claude 的审查结果
+├── gemini.json       # Gemini 的审查结果
+├── codex.json        # Codex 的审查结果
+└── summary.md        # 汇总报告（Markdown 格式）
+```
+
+**注意**：
+- 每个模型的结果单独保存为 JSON 文件
+- summary.md 包含所有模型的结果和统计信息
+- 决策逻辑由 Agent 根据 CLAUDE.md 中的规则执行
+
+## 使用示例
+
+### 示例 1：全部通过
+
+```
+Agent 调用 openspec-review:
+  输入:
+  - changeId: 001-pricing-system
+  - openspecPath: openspec/changes/001-pricing-system/
+
+执行:
+  🔧 步骤 1: 读取 OpenSpec 文件
+  ⏳ 读取: proposal.md, design.md, tasks.md
+
+  🔧 步骤 2: 并行调用 4 个模型
+  ⏳ Claude Sonnet 4: 审查中...
+  ⏳ GPT-4: 审查中...
+  ⏳ Claude Opus 4: 审查中...
+  ⏳ Gemini 2.0: 审查中...
+
+  🔧 步骤 3: 汇总结果
+  ✅ 通过率: 100% (4/4)
+  ✅ 总体评分: 8.25/10
+
+显示结果:
+  ✅ OpenSpec 会审通过
+
+  📊 审查结果:
+  - Claude Sonnet 4: 8.5/10 ✅
+  - GPT-4: 9.0/10 ✅
+  - Claude Opus 4: 7.5/10 ⚠️
+  - Gemini 2.0: 8.0/10 ✅
+
+  ⚠️  发现 1 个中优先级问题:
+  - 任务 3 和任务 5 有依赖关系，但 tasks.md 中未标记
+
+  💡 建议:
+  1. 在 tasks.md 中标记任务依赖关系
+  2. 补充多货币转换的边界情况处理
+
+  📄 详细报告:
+  - review-openspec.json
+  - review-openspec-summary.md
+
+  💡 下一步:
+  可以继续执行，或先修订 OpenSpec
+```
+
+### 示例 2：需要修订
+
+```
+Agent 调用 openspec-review:
+  输入:
+  - changeId: 002-complex-feature
+  - openspecPath: openspec/changes/002-complex-feature/
+
+执行:
+  🔧 步骤 1-3: 审查和汇总
+
+显示结果:
+  ❌ OpenSpec 会审未通过
+
+  📊 审查结果:
+  - Claude Sonnet 4: 5.0/10 ❌
+  - GPT-4: 6.0/10 ⚠️
+  - Claude Opus 4: 5.5/10 ❌
+  - Gemini 2.0: 6.5/10 ⚠️
+
+  ❌ 通过率: 0% (0/4)
+  ❌ 发现 3 个严重问题:
+  1. 需求描述不清晰，缺少验收标准
+  2. 技术方案不可行，存在循环依赖
+  3. 任务拆分过粗，无法执行
+
+  💡 建议:
+  必须修订 OpenSpec，解决以上问题后重新会审
+
+  📄 详细报告:
+  - review-openspec.json
+  - review-openspec-summary.md
+```
+
+## 错误处理
+
+### 错误 1：OpenSpec 文件不存在
+
+```
+❌ 错误: OpenSpec 文件不完整
+🔍 原因: 缺少 proposal.md 或 design.md 或 tasks.md
+
+💡 建议:
+1. 检查 OpenSpec 目录
+2. 确认所有必需文件存在
+3. 重新生成 OpenSpec
+```
+
+### 错误 2：模型调用失败
+
+```
+❌ 错误: 模型调用失败
+🔍 原因: Claude Sonnet 4 API 超时
+
+💡 建议:
+1. 重试调用
+2. 或使用 3 个模型的结果（降低通过阈值）
+```
+
+### 错误 3：审查结果格式错误
+
+```
+❌ 错误: 审查结果解析失败
+🔍 原因: GPT-4 返回的不是有效 JSON
+
+💡 建议:
+1. 重新调用 GPT-4
+2. 或手动解析结果
+```
+
+## 注意事项
+
+1. **并行调用** - 4 个模型同时调用，提高效率
+2. **超时处理** - 每个模型调用设置 60 秒超时
+3. **结果缓存** - 审查结果保存到 Job 的 reviews/ 目录
+4. **可重复** - 可以多次调用，每次生成新的审查报告
+5. **人工决策** - 最终是否修订由用户决定
+
+## 相关文件
+
+- `exports/jobs/<job-id>/reviews/review-openspec.json`
+- `exports/jobs/<job-id>/reviews/review-openspec-summary.md`

package/skills/pdf/LICENSE.txt

@@ -0,0 +1,30 @@
+© 2025 Anthropic, PBC. All rights reserved.
+
+LICENSE: Use of these materials (including all code, prompts, assets, files,
+and other components of this Skill) is governed by your agreement with
+Anthropic regarding use of Anthropic's services. If no separate agreement
+exists, use is governed by Anthropic's Consumer Terms of Service or
+Commercial Terms of Service, as applicable:
+https://www.anthropic.com/legal/consumer-terms
+https://www.anthropic.com/legal/commercial-terms
+Your applicable agreement is referred to as the "Agreement." "Services" are
+as defined in the Agreement.
+
+ADDITIONAL RESTRICTIONS: Notwithstanding anything in the Agreement to the
+contrary, users may not:
+
+- Extract these materials from the Services or retain copies of these
+  materials outside the Services
+- Reproduce or copy these materials, except for temporary copies created
+  automatically during authorized use of the Services
+- Create derivative works based on these materials
+- Distribute, sublicense, or transfer these materials to any third party
+- Make, offer to sell, sell, or import any inventions embodied in these
+  materials
+- Reverse engineer, decompile, or disassemble these materials
+
+The receipt, viewing, or possession of these materials does not convey or
+imply any license or right beyond those expressly granted above.
+
+Anthropic retains all right, title, and interest in these materials,
+including all copyrights, patents, and other intellectual property rights.