@tinkcarlos/skillora 0.2.0

package/.claude/skills/product-requirements/references/plan-execution-protocol.md

@@ -0,0 +1,334 @@
+# 计划执行协议 (Plan Execution Protocol)
+
+> **核心原则**: 计划是锚点，偏离必须批准，上下文必须隔离。
+
+---
+
+## 🔴 为什么需要计划执行协议？
+
+```
+❌ 无协议的执行问题:
+- 目标漂移: 开始做 A，最后变成做 B
+- 范围膨胀: 小任务变成大工程
+- 上下文污染: 调用其他 Skill 后忘记原始目标
+- 无法追踪: 不知道完成了多少，还剩多少
+
+✅ 有协议的执行优势:
+- 目标锚定: 始终记住原始目标
+- 范围控制: 严格按计划执行
+- 上下文隔离: 调用其他 Skill 不影响主流程
+- 进度可见: 清晰知道当前状态
+```
+
+---
+
+## 计划锚点机制
+
+### 锚点结构
+
+```markdown
+## 🔒 计划锚点 (Plan Anchor)
+
+### 不可变信息 (Immutable)
+- **需求文档**: [路径]
+- **成功标准**: [从需求文档提取]
+- **计划版本**: [版本号]
+- **创建时间**: [时间]
+
+### 当前状态 (Mutable)
+- **当前任务**: T[X]
+- **已完成**: [T1, T2, ...]
+- **待完成**: [T3, T4, ...]
+- **阻塞项**: [如有]
+```
+
+### 锚点使用规则
+
+| 时机 | 动作 |
+|------|------|
+| 开始执行 | 输出完整锚点 |
+| 每个任务开始 | 引用锚点，确认当前任务 |
+| 每个任务完成 | 更新锚点状态 |
+| 调用其他 Skill 前 | 输出锚点确认 |
+| 调用其他 Skill 后 | 重新读取锚点 |
+| 发现偏离 | 对照锚点，停止并询问 |
+
+---
+
+## 任务执行流程
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  任务执行流程                                                    │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                  │
+│  1. 读取计划锚点                                                │
+│     └─ 确认当前任务 T[X]                                        │
+│                                                                  │
+│  2. 检查任务依赖                                                │
+│     ├─ 依赖已完成 → 继续                                        │
+│     └─ 依赖未完成 → 先完成依赖                                  │
+│                                                                  │
+│  3. 执行任务                                                    │
+│     ├─ 需要其他 Skill → 进入委托流程                            │
+│     └─ 不需要 → 直接执行                                        │
+│                                                                  │
+│  4. 任务完成检查                                                │
+│     ├─ 检查是否符合需求                                         │
+│     ├─ 检查是否在范围内                                         │
+│     └─ 更新计划状态                                             │
+│                                                                  │
+│  5. 进入下一任务                                                │
+│     └─ 重复步骤 1-4                                             │
+│                                                                  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Skill 委托协议
+
+### 委托进入模板
+
+```markdown
+---
+## 🔄 技能委托通知
+
+### 主上下文锚点确认
+- **需求文档**: [路径]
+- **当前计划任务**: T[X] - [任务描述]
+- **成功标准**: [...]
+
+### 委托详情
+- **目标 Skill**: `[skill-name]`
+- **委托目的**: [为什么需要这个 Skill]
+- **范围限定**:
+  - ✅ 允许: [具体允许的操作]
+  - ❌ 禁止: [明确禁止的操作]
+- **退出条件**: [什么标志完成]
+- **预计步骤**: [X] 步
+
+### 约束传递
+- 保持现有代码风格
+- 不引入计划外依赖
+- 最小改动原则
+
+---
+⏱️ 开始委托任务...
+```
+
+### 委托执行中监控
+
+```markdown
+## ⚠️ 范围警戒 (Scope Guard)
+
+每完成一个步骤，检查：
+1. 这一步是否直接服务于计划任务 T[X]？
+2. 是否在预定范围内？
+3. 是否有"顺便做点其他事"的冲动？
+
+🚨 如果发现超出范围：
+1. 立即停止当前工作
+2. 记录超出范围的发现
+3. 询问用户是否需要单独处理
+4. 返回主上下文继续执行
+```
+
+### 委托退出模板
+
+```markdown
+---
+## ✅ 委托任务完成
+
+### 完成情况
+- **目标达成**: ✅ / ❌
+- **范围遵守**: ✅ / ❌ (如超出，说明原因)
+- **产出物**: [创建/修改的文件列表]
+
+### 超出范围发现 (如有)
+[记录发现但未处理的问题，建议后续单独处理]
+
+### 返回主上下文
+- **继续任务**: T[X+1] 或 T[X] (如未完成)
+- **计划状态更新**: [更新内容]
+
+---
+🔄 返回计划执行主上下文
+```
+
+---
+
+## 偏离检测与处理
+
+### 偏离类型
+
+| 类型 | 定义 | 检测方法 |
+|------|------|----------|
+| 目标漂移 | 当前动作与计划任务无关 | 对比当前动作 vs T[X] |
+| 范围膨胀 | 做了计划外的事情 | 检查是否在任务范围内 |
+| 上下文丢失 | 忘记原始目标 | 无法回答"当前任务是什么" |
+| 优先级错乱 | 跳过高优先级任务 | 检查任务依赖关系 |
+
+### 偏离处理流程
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  偏离检测与处理                                                  │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                  │
+│  检测到偏离                                                      │
+│       ↓                                                          │
+│  立即停止当前动作                                                │
+│       ↓                                                          │
+│  输出偏离警报                                                    │
+│  ┌──────────────────────────────────────────────────────────┐   │
+│  │ ⚠️ 检测到偏离计划                                        │   │
+│  │                                                          │   │
+│  │ 计划任务: T[X] - [任务描述]                              │   │
+│  │ 当前动作: [实际在做的事情]                               │   │
+│  │ 偏离类型: [目标漂移/范围膨胀/...]                        │   │
+│  │                                                          │   │
+│  │ 选项:                                                    │   │
+│  │ A. 回到计划任务 T[X]                                     │   │
+│  │ B. 将当前动作加入计划 (需要批准)                         │   │
+│  │ C. 记录发现，稍后处理                                    │   │
+│  └──────────────────────────────────────────────────────────┘   │
+│       ↓                                                          │
+│  等待用户决策                                                    │
+│       ↓                                                          │
+│  根据用户选择继续                                                │
+│                                                                  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 计划变更协议
+
+### 变更触发条件
+
+| 条件 | 处理 |
+|------|------|
+| 发现新需求 | 记录 → 询问是否加入计划 |
+| 任务无法完成 | 分析原因 → 调整计划 |
+| 依赖变化 | 重新评估任务顺序 |
+| 用户要求变更 | 更新计划 → 重新确认 |
+
+### 变更流程
+
+```markdown
+## 📝 计划变更请求
+
+### 变更原因
+[为什么需要变更]
+
+### 变更内容
+- **原计划**: [原任务/顺序]
+- **新计划**: [新任务/顺序]
+
+### 影响分析
+- 受影响任务: [列表]
+- 预计影响: [时间/范围]
+
+### 请求确认
+是否批准此变更？
+```
+
+---
+
+## Skill 编排矩阵
+
+### 从 product-requirements 调用
+
+| 触发条件 | 调用 Skill | 范围约束 | 返回条件 |
+|----------|------------|----------|----------|
+| UI 开发任务 | `frontend-design` | 仅计划内 UI 组件 | UI 完成 |
+| 发现阻塞性 Bug | `bug-fixing` | 仅阻塞当前任务的 Bug | Bug 修复 |
+| 代码开发完成 | `code-review` | 仅本次变更的代码 | 审查通过 |
+| 需要测试 | `test-driven-development` | 仅计划内测试用例 | 测试通过 |
+| 需要 API 开发 | `fullstack-developer` | 仅计划内 API | API 完成 |
+| 验证完成 | `verification-before-completion` | 验证计划内任务 | 验证通过 |
+
+### 调用链示例
+
+```
+product-requirements (主)
+    │
+    ├── T1: UI 开发
+    │   └── 委托 frontend-design
+    │       └── 返回 product-requirements
+    │
+    ├── T2: API 开发
+    │   └── 委托 fullstack-developer
+    │       └── 返回 product-requirements
+    │
+    ├── T3: 集成测试
+    │   └── 委托 test-driven-development
+    │       └── 返回 product-requirements
+    │
+    └── T4: 代码审查
+        └── 委托 code-review
+            ├── 发现 Bug → 委托 bug-fixing
+            │   └── 返回 code-review
+            └── 返回 product-requirements
+```
+
+---
+
+## 执行日志模板
+
+```markdown
+## 执行日志
+
+### 会话信息
+- **开始时间**: [时间]
+- **需求文档**: [路径]
+- **计划版本**: [版本]
+
+### 任务执行记录
+
+#### T1: [任务描述]
+- **开始**: [时间]
+- **状态**: ✅ 完成 / ❌ 失败 / ⏸️ 暂停
+- **委托**: [如有] `skill-name`
+- **产出**: [文件列表]
+- **备注**: [如有]
+
+#### T2: [任务描述]
+- ...
+
+### 偏离记录 (如有)
+| 时间 | 偏离类型 | 处理方式 |
+|------|----------|----------|
+| [...] | [...] | [...] |
+
+### 计划变更记录 (如有)
+| 时间 | 变更内容 | 批准状态 |
+|------|----------|----------|
+| [...] | [...] | [...] |
+
+### 会话总结
+- **完成任务**: [X]/[Y]
+- **下次继续**: T[Z]
+- **待处理**: [如有]
+```
+
+---
+
+## 检查清单
+
+### 执行前
+- [ ] 计划锚点已建立
+- [ ] 任务依赖已检查
+- [ ] 成功标准已明确
+
+### 执行中
+- [ ] 每个任务开始前引用锚点
+- [ ] 委托前输出委托通知
+- [ ] 委托后返回主上下文
+- [ ] 偏离时立即停止并询问
+
+### 执行后
+- [ ] 所有任务状态已更新
+- [ ] 执行日志已记录
+- [ ] 偏离/变更已记录

package/.claude/skills/product-requirements/references/plan-generation-protocol.md

@@ -0,0 +1,264 @@
+# 计划生成协议 (Plan Generation Protocol)
+
+> **核心原则**: 计划必须锚定需求文档，任务必须可验证，检查点必须明确。
+
+---
+
+## 计划生成流程
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  计划生成流程                                                    │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                  │
+│  Step 1: 提取需求文档关键信息                                   │
+│  ├─ 成功标准                                                    │
+│  ├─ 功能需求列表                                                │
+│  └─ 优先级排序                                                  │
+│                                                                  │
+│  Step 2: 任务分解                                               │
+│  ├─ 将需求转化为可执行任务                                      │
+│  ├─ 识别任务依赖关系                                            │
+│  └─ 分配涉及的 Skill                                            │
+│                                                                  │
+│  Step 3: 建立计划锚点                                           │
+│  ├─ 锚定需求文档                                                │
+│  ├─ 定义成功标准                                                │
+│  └─ 设置计划版本                                                │
+│                                                                  │
+│  Step 4: 定义检查点                                             │
+│  ├─ 每个任务的验证条件                                          │
+│  └─ 阶段性验证点                                                │
+│                                                                  │
+│  Step 5: 输出开发计划                                           │
+│                                                                  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 计划结构模板
+
+```markdown
+## 开发计划
+
+### 计划锚点 (Plan Anchor)
+
+#### 不可变信息
+- **需求文档**: [路径]
+- **成功标准**:
+  - [标准1: 从需求文档提取]
+  - [标准2: 从需求文档提取]
+- **计划版本**: 1.0
+- **创建时间**: YYYY-MM-DD
+
+#### 范围定义
+- **包含**: [本计划要完成的]
+- **不包含**: [明确排除的]
+
+---
+
+### 任务列表
+
+| ID | 任务 | 描述 | 依赖 | 涉及 Skill | 优先级 | 状态 |
+|----|------|------|------|------------|--------|------|
+| T1 | [任务名] | [简要描述] | - | `skill-name` | P0 | pending |
+| T2 | [任务名] | [简要描述] | T1 | `skill-name` | P0 | pending |
+| T3 | [任务名] | [简要描述] | T1 | `skill-name` | P1 | pending |
+| T4 | [任务名] | [简要描述] | T2,T3 | `skill-name` | P1 | pending |
+
+---
+
+### 任务详情
+
+#### T1: [任务名]
+- **描述**: [详细描述]
+- **对应需求**: REQ-XXX
+- **涉及 Skill**: `skill-name`
+- **预期产出**: [文件/功能]
+- **验证条件**: [如何验证完成]
+- **范围约束**:
+  - ✅ 允许: [...]
+  - ❌ 禁止: [...]
+
+#### T2: [任务名]
+- ...
+
+---
+
+### 检查点 (Checkpoints)
+
+| 检查点 | 触发条件 | 验证内容 | 通过标准 |
+|--------|----------|----------|----------|
+| CP1 | T1 完成后 | [验证内容] | [通过标准] |
+| CP2 | T2 完成后 | [验证内容] | [通过标准] |
+| CP3 | 所有任务完成 | 整体验收 | 所有成功标准满足 |
+
+---
+
+### 风险与缓解
+
+| 风险 | 可能性 | 影响 | 缓解措施 |
+|------|--------|------|----------|
+| [风险1] | 高/中/低 | 高/中/低 | [措施] |
+| [风险2] | 高/中/低 | 高/中/低 | [措施] |
+```
+
+---
+
+## 任务分解原则
+
+### 任务粒度
+
+| 粒度 | 特征 | 适用场景 |
+|------|------|----------|
+| 太粗 | 无法在 1 次会话完成 | 需要进一步分解 |
+| 合适 | 1-3 次会话可完成 | 理想粒度 |
+| 太细 | 几分钟就能完成 | 可以合并 |
+
+### 任务命名规范
+
+```
+[动词] + [对象] + [限定条件]
+
+示例:
+- 创建用户登录表单组件
+- 实现密码重置 API 端点
+- 添加登录状态持久化
+- 修复登录超时处理
+```
+
+### 任务依赖识别
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  依赖类型                                                        │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                  │
+│  1. 技术依赖                                                    │
+│     └─ 后端 API 必须先于前端集成                                │
+│                                                                  │
+│  2. 数据依赖                                                    │
+│     └─ 数据库表必须先于数据访问层                               │
+│                                                                  │
+│  3. 逻辑依赖                                                    │
+│     └─ 基础功能必须先于高级功能                                 │
+│                                                                  │
+│  4. 测试依赖                                                    │
+│     └─ 功能实现必须先于测试编写                                 │
+│                                                                  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Skill 分配指南
+
+### Skill 选择矩阵
+
+| 任务类型 | 推荐 Skill | 说明 |
+|----------|------------|------|
+| UI 组件开发 | `frontend-design` | 前端界面相关 |
+| API 开发 | `fullstack-developer` | 后端接口相关 |
+| 数据库变更 | `database-migration` | 数据模型相关 |
+| Bug 修复 | `bug-fixing` | 问题修复相关 |
+| 测试编写 | `test-driven-development` | 测试相关 |
+| 代码审查 | `code-review` | 质量检查 |
+| 完成验证 | `verification-before-completion` | 最终验证 |
+
+### 强制 Skill 调用
+
+| 时机 | 必须调用 | 原因 |
+|------|----------|------|
+| 代码开发完成 | `code-review` | 质量保证 |
+| 声称任务完成 | `verification-before-completion` | 防止遗漏 |
+| 发现 Bug | `bug-fixing` | 规范修复 |
+
+---
+
+## 检查点设计
+
+### 检查点类型
+
+| 类型 | 触发时机 | 验证内容 |
+|------|----------|----------|
+| 任务检查点 | 单个任务完成 | 任务产出符合预期 |
+| 阶段检查点 | 一组相关任务完成 | 阶段目标达成 |
+| 最终检查点 | 所有任务完成 | 整体成功标准满足 |
+
+### 检查点验证模板
+
+```markdown
+## 检查点验证: CP[X]
+
+### 触发条件
+- 任务 T[X] 已完成
+
+### 验证内容
+1. [验证项1]
+2. [验证项2]
+3. [验证项3]
+
+### 验证结果
+- [ ] 验证项1: ✅ 通过 / ❌ 失败
+- [ ] 验证项2: ✅ 通过 / ❌ 失败
+- [ ] 验证项3: ✅ 通过 / ❌ 失败
+
+### 结论
+- **通过**: 继续下一任务
+- **失败**: [失败原因] → [处理方式]
+```
+
+---
+
+## 优化需求计划特殊处理
+
+### 优化计划模板
+
+```markdown
+## 优化计划
+
+### 计划锚点
+- **需求文档**: [路径]
+- **现状分析**: [需求文档中的现状分析章节]
+- **优化目标**: [从需求文档提取]
+
+### 影响范围
+| 模块 | 影响程度 | 变更类型 |
+|------|----------|----------|
+| [模块1] | 高/中/低 | 修改/新增/删除 |
+
+### 任务列表
+| ID | 任务 | 现状 | 目标 | 涉及 Skill |
+|----|------|------|------|------------|
+| T1 | [...] | [...] | [...] | `skill-name` |
+
+### 回归风险
+| 风险 | 影响模块 | 缓解措施 |
+|------|----------|----------|
+| [风险1] | [...] | 添加回归测试 |
+```
+
+---
+
+## 计划验证清单
+
+### 计划完成前必须通过
+
+- [ ] 计划锚点已建立
+- [ ] 所有任务有明确描述
+- [ ] 任务依赖关系已识别
+- [ ] 每个任务有涉及 Skill
+- [ ] 每个任务有验证条件
+- [ ] 检查点已定义
+- [ ] 范围边界已明确
+- [ ] 风险已识别
+
+### 常见问题自查
+
+| 问题 | 检查方法 | 修复方式 |
+|------|----------|----------|
+| 任务太粗 | 无法在 1 次会话完成 | 进一步分解 |
+| 依赖缺失 | 任务顺序不合理 | 补充依赖关系 |
+| 检查点缺失 | 无法验证完成 | 添加检查点 |
+| 范围模糊 | 不知道什么不做 | 明确排除项 |

package/.claude/skills/product-requirements/references/prioritization-frameworks.md

@@ -0,0 +1,80 @@
+# Prioritization Frameworks
+
+详细的优先级框架说明，用于 MVP 定义和功能排序。
+
+## RICE Framework
+
+**公式**: `RICE Score = (Reach × Impact × Confidence) ÷ Effort`
+
+| 维度 | 定义 | 评分标准 |
+|------|------|----------|
+| **Reach** | 影响用户数量 | 每季度/月影响的用户数 |
+| **Impact** | 影响程度 | 0.25(微小) / 0.5(低) / 1(中) / 2(高) / 3(巨大) |
+| **Confidence** | 置信度 | 50%(直觉) / 80%(有数据) / 100%(强验证) |
+| **Effort** | 工作量 | 人周/人月 |
+
+**最佳实践**:
+- 只有"强定量+定性"数据时才用 80% 置信度
+- 定期重新评分（每周 Top 10，每月全量）
+- 保留 10-20% 容量用于新发现
+
+## MoSCoW Framework
+
+| 分类 | 定义 | 容量建议 |
+|------|------|----------|
+| **Must-have** | 没有就不能发布 | ≤60% |
+| **Should-have** | 重要但可延后 | ~20% |
+| **Could-have** | 锦上添花 | ~20% (缓冲) |
+| **Won't-have** | 明确不做 | 记录防止范围蔓延 |
+
+**最佳实践**:
+- Must-have 不超过 60% 容量
+- Should-have 设定时间承诺（如 GA 后 30 天内）
+- 明确记录 Won't-have 防止范围蔓延
+
+## ICE Scoring
+
+**公式**: `ICE = Impact + Confidence + Ease` (各 1-10 分)
+
+| 维度 | 定义 |
+|------|------|
+| **Impact** | 对目标指标的影响 |
+| **Confidence** | 对预估的信心 |
+| **Ease** | 实现难度（越容易分越高） |
+
+**最佳实践**:
+- 团队统一定义"5分"的含义
+- 每个条目附带一行假设说明
+- 频繁重新评分，作为工作列表
+
+## Kano Model
+
+| 类型 | 特征 | 策略 |
+|------|------|------|
+| **Basic (Must-be)** | 缺失会不满，有了不惊喜 | 必须满足 |
+| **Performance (Linear)** | 越多越好 | 持续优化 |
+| **Attractive (Delighter)** | 没有不失望，有了很惊喜 | 差异化竞争 |
+| **Indifferent** | 有无都无所谓 | 不投入 |
+
+**应用方法**:
+1. 设计问卷：功能存在/不存在时的感受
+2. 结合定性访谈验证
+3. 与 RICE 配合：Delighter 通常高 Impact 低 Reach
+
+## 框架选择指南
+
+| 场景 | 推荐框架 |
+|------|----------|
+| 比较不同类型的工作项 | RICE |
+| 发布范围规划 | MoSCoW |
+| 快速增长实验 | ICE |
+| 理解用户满意度 | Kano |
+| MVP 定义 | MoSCoW + RICE |
+
+## 参考来源
+
+- [Prioritization Techniques: RICE, MoSCoW, ICE, Kano](https://www.getproductpeople.com/blog/prioritization-techniques-rice-moscow-ice-kano)
+- [8 Product Backlog Prioritization Techniques](https://www.resolution.de/post/product-backlog-prioritization-techniques)
+- [MoSCoW: Framework for Effective Prioritization](https://craft.io/blog/moscow-the-simple-framework-for-effective-prioritization/)
+
+检索日期: 2026-01-16