@tinkcarlos/skillora 0.2.0

package/.claude/skills/product-requirements/references/requirement-decomposition-protocol.md

@@ -0,0 +1,291 @@
+# 需求分解协议 (Requirement Decomposition Protocol)
+
+> **核心原则**: 显性需求是起点，隐性需求是关键，系统思维是方法。
+
+---
+
+## 需求分解流程
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  需求分解流程                                                    │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                  │
+│  Step 1: 快速三问                                               │
+│  ├─ 用户要什么？→ 真实目标                                      │
+│  ├─ 有什么约束？→ 技术/时间/资源                                │
+│  └─ 最简方案？→ 最小改动                                        │
+│                                                                  │
+│  Step 2: 显性需求收集                                           │
+│  ├─ 5W1H 问题框架                                               │
+│  └─ 用户原话记录                                                │
+│                                                                  │
+│  Step 3: 隐性需求挖掘                                           │
+│  ├─ 场景推演法                                                  │
+│  ├─ 痛点分析法                                                  │
+│  ├─ 最佳实践对比法                                              │
+│  └─ 边界情况法                                                  │
+│                                                                  │
+│  Step 4: 需求分类与优先级                                       │
+│  ├─ MoSCoW 分类                                                 │
+│  └─ RICE 评分                                                   │
+│                                                                  │
+│  Step 5: 输出需求分解报告                                       │
+│                                                                  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Step 1: 快速三问
+
+### 问题模板
+
+```markdown
+## 快速三问分析
+
+### Q1: 用户要什么？
+**表面需求**: [用户说的]
+**真实目标**: [用户真正想解决的问题]
+**判断依据**: [为什么认为这是真实目标]
+
+### Q2: 有什么约束？
+| 约束类型 | 具体约束 | 影响 |
+|----------|----------|------|
+| 技术栈 | [...] | [...] |
+| 时间 | [...] | [...] |
+| 资源 | [...] | [...] |
+| 其他 | [...] | [...] |
+
+### Q3: 最简方案？
+**最小改动方案**: [描述]
+**为什么是最简**: [理由]
+**风险评估**: [潜在风险]
+```
+
+### 清晰度判断
+
+| 清晰度 | 判断标准 | 处理方式 |
+|--------|----------|----------|
+| ≥80% | 目标明确，约束清晰，方案可行 | 直接执行 |
+| 50-80% | 部分不确定，需要选择 | 方案对比，请求选择 |
+| <50% | 大量不确定，无法判断 | 苏格拉底式提问 |
+
+---
+
+## Step 2: 显性需求收集
+
+### 5W1H 问题框架
+
+| 维度 | 问题 | 目的 | 示例 |
+|------|------|------|------|
+| **What** | 要做什么？ | 明确目标 | "需要一个用户登录功能" |
+| **Why** | 为什么需要？ | 理解动机 | "为了保护用户数据" |
+| **Who** | 谁会使用？ | 确定用户群 | "所有注册用户" |
+| **When** | 什么时候触发？ | 定义场景 | "访问受保护页面时" |
+| **Where** | 在哪里使用？ | 确定上下文 | "Web 端和移动端" |
+| **How** | 如何工作？ | 理解预期 | "邮箱密码登录" |
+
+### 显性需求记录模板
+
+```markdown
+## 显性需求记录
+
+### REQ-001: [需求名称]
+- **描述**: [需求描述]
+- **用户原话**: "[用户的原话]"
+- **5W1H**:
+  - What: [...]
+  - Why: [...]
+  - Who: [...]
+  - When: [...]
+  - Where: [...]
+  - How: [...]
+- **优先级**: P0/P1/P2
+- **来源标签**: `[USER]`
+```
+
+---
+
+## Step 3: 隐性需求挖掘
+
+### 方法 1: 场景推演法
+
+```
+用户场景 → 可能的操作 → 可能的问题 → 隐含需求
+```
+
+**示例**:
+```markdown
+### 场景推演: 用户登录
+
+**场景**: 用户打开应用，需要登录
+**可能操作**:
+1. 输入邮箱密码
+2. 点击登录按钮
+3. 等待验证
+
+**可能问题**:
+1. 忘记密码 → 隐含需求: 密码重置功能
+2. 输入错误 → 隐含需求: 错误提示
+3. 网络超时 → 隐含需求: 超时处理
+
+**推导的隐性需求**:
+- `[INFERRED]` 密码重置功能 (推导依据: 用户可能忘记密码)
+- `[INFERRED]` 输入验证和错误提示 (推导依据: 用户可能输入错误)
+- `[INFERRED]` 网络超时处理 (推导依据: 网络不稳定场景)
+```
+
+### 方法 2: 痛点分析法
+
+```markdown
+### 痛点分析
+
+| 痛点 | 影响 | 频率 | 隐含需求 |
+|------|------|------|----------|
+| 登录流程繁琐 | 用户流失 | 高 | 简化登录流程 |
+| 密码要求不明确 | 注册失败 | 中 | 密码强度提示 |
+| 无记住登录 | 重复登录 | 高 | 记住登录状态 |
+```
+
+### 方法 3: 最佳实践对比法
+
+```markdown
+### 最佳实践对比
+
+| 实践 | 来源 | 当前状态 | 差距 | 隐含需求 |
+|------|------|----------|------|----------|
+| OAuth 登录 | 行业标准 | 无 | 缺失 | 第三方登录 |
+| 2FA | 安全标准 | 无 | 缺失 | 双因素认证 |
+| 登录日志 | 安全实践 | 无 | 缺失 | 登录审计 |
+```
+
+### 方法 4: 边界情况法
+
+```markdown
+### 边界情况分析
+
+#### 输入边界
+| 边界情况 | 预期行为 | 隐含需求 |
+|----------|----------|----------|
+| 空邮箱 | 提示必填 | 输入验证 |
+| 无效邮箱格式 | 提示格式错误 | 格式验证 |
+| 超长密码 | 截断或提示 | 长度限制 |
+
+#### 环境边界
+| 边界情况 | 预期行为 | 隐含需求 |
+|----------|----------|----------|
+| 网络断开 | 提示网络错误 | 离线处理 |
+| 服务器错误 | 友好错误页 | 错误处理 |
+| 并发登录 | 策略处理 | 会话管理 |
+
+#### 业务边界
+| 边界情况 | 预期行为 | 隐含需求 |
+|----------|----------|----------|
+| 账号锁定 | 提示锁定原因 | 锁定机制 |
+| 密码过期 | 强制修改 | 密码策略 |
+| 首次登录 | 引导流程 | 新用户引导 |
+```
+
+---
+
+## Step 4: 需求分类与优先级
+
+### MoSCoW 分类
+
+| 分类 | 定义 | 示例 |
+|------|------|------|
+| **Must** | 必须有，没有就不能发布 | 基本登录功能 |
+| **Should** | 应该有，重要但不阻塞 | 密码重置 |
+| **Could** | 可以有，锦上添花 | 第三方登录 |
+| **Won't** | 不做，明确排除 | 生物识别登录 |
+
+### RICE 评分
+
+| 需求 | Reach | Impact | Confidence | Effort | Score | 优先级 |
+|------|-------|--------|------------|--------|-------|--------|
+| 基本登录 | 100% | 3 | 100% | 2 | 150 | P0 |
+| 密码重置 | 30% | 2 | 90% | 1 | 54 | P1 |
+| 第三方登录 | 50% | 2 | 80% | 3 | 27 | P2 |
+
+**Score = (Reach × Impact × Confidence) / Effort**
+
+---
+
+## Step 5: 需求分解报告模板
+
+```markdown
+# 需求分解报告
+
+## 基本信息
+- **项目/功能**: [名称]
+- **分解日期**: YYYY-MM-DD
+- **清晰度评估**: [X]%
+
+## 快速三问分析
+[Step 1 的输出]
+
+## 显性需求
+| ID | 描述 | 用户原话 | 优先级 |
+|----|------|----------|--------|
+| REQ-001 | [...] | "[...]" | P0 |
+| REQ-002 | [...] | "[...]" | P1 |
+
+## 隐性需求
+| ID | 描述 | 挖掘方法 | 推导依据 | 优先级 |
+|----|------|----------|----------|--------|
+| REQ-101 | [...] | 场景推演 | [...] | P1 |
+| REQ-102 | [...] | 痛点分析 | [...] | P2 |
+
+## 需求分类 (MoSCoW)
+### Must (必须)
+- REQ-001: [...]
+- REQ-002: [...]
+
+### Should (应该)
+- REQ-101: [...]
+
+### Could (可以)
+- REQ-102: [...]
+
+### Won't (不做)
+- [明确排除的需求]
+
+## 待确认事项
+1. [待确认事项1]
+2. [待确认事项2]
+
+## 下一步
+- [ ] 进入 Phase 2: 带答案提问
+```
+
+---
+
+## 优化需求特殊处理
+
+### 优化需求分解流程
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  优化需求分解流程                                                │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                  │
+│  Step 0.5: 分析现有代码 (MANDATORY)                             │
+│  ├─ 读取相关代码文件                                            │
+│  ├─ 理解当前实现                                                │
+│  ├─ 识别问题点                                                  │
+│  └─ 映射影响范围                                                │
+│                                                                  │
+│  Step 1-5: 标准分解流程                                         │
+│  └─ 在分解报告中增加"现状分析"章节                              │
+│                                                                  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### 现状分析检查清单
+
+- [ ] 相关代码文件已读取
+- [ ] 当前实现逻辑已理解
+- [ ] 问题点已识别并记录
+- [ ] 影响范围已映射
+- [ ] 现状 vs 目标差距已明确

package/.claude/skills/product-requirements/references/user-story-examples.md

@@ -0,0 +1,297 @@
+# User Story Examples
+
+Real-world examples of well-written user stories with acceptance criteria.
+
+---
+
+## User Story Format
+
+### Standard Format
+```
+As a [user type],
+I want to [action/goal],
+So that [benefit/value].
+```
+
+### Extended Format (INVEST Criteria)
+- **I**ndependent - Can be developed separately
+- **N**egotiable - Details can be discussed
+- **V**aluable - Delivers value to user
+- **E**stimable - Can estimate effort
+- **S**mall - Completable in one sprint
+- **T**estable - Has clear acceptance criteria
+
+---
+
+## Example Stories by Domain
+
+### Authentication
+
+#### US-AUTH-001: User Registration
+```
+As a new visitor,
+I want to create an account with my email,
+So that I can access personalized features.
+
+Acceptance Criteria:
+- [ ] Registration form has email, password, confirm password fields
+- [ ] Email must be valid format and unique
+- [ ] Password must be 8+ chars with 1 number and 1 special char
+- [ ] Confirm password must match password
+- [ ] Submit button disabled until all validations pass
+- [ ] Success: redirect to welcome page with confirmation email sent
+- [ ] Error: show inline field errors
+```
+
+#### US-AUTH-002: User Login
+```
+As a registered user,
+I want to log in with my credentials,
+So that I can access my account.
+
+Acceptance Criteria:
+- [ ] Login form has email and password fields
+- [ ] "Remember me" checkbox available
+- [ ] "Forgot password" link available
+- [ ] Show loading state during authentication
+- [ ] Success: redirect to dashboard or intended page
+- [ ] Wrong credentials: show "Invalid email or password" (no specific field)
+- [ ] Account locked: show lock message with unlock instructions
+- [ ] Rate limit after 5 failed attempts in 15 minutes
+```
+
+#### US-AUTH-003: Password Reset
+```
+As a user who forgot my password,
+I want to reset it via email,
+So that I can regain access to my account.
+
+Acceptance Criteria:
+- [ ] "Forgot password" page has email input
+- [ ] Always show "Check your email" (even for non-existent emails - security)
+- [ ] Email contains secure, time-limited reset link (24 hours)
+- [ ] Reset page validates password strength
+- [ ] Cannot reuse last 5 passwords
+- [ ] Success: auto-login and redirect to dashboard
+- [ ] Expired link: show "Link expired" with option to request new one
+```
+
+---
+
+### E-Commerce
+
+#### US-CART-001: Add to Cart
+```
+As a shopper,
+I want to add products to my cart,
+So that I can purchase multiple items together.
+
+Acceptance Criteria:
+- [ ] "Add to Cart" button on product page and listing
+- [ ] Can select quantity before adding (default 1)
+- [ ] Button shows loading state during add
+- [ ] Success: show "Added to cart" toast with "View Cart" link
+- [ ] Cart icon in header shows item count badge
+- [ ] If item already in cart, increase quantity
+- [ ] Out of stock: button shows "Out of Stock" (disabled)
+- [ ] Low stock: show "Only X left" warning
+- [ ] Guest users can add to cart (stored in localStorage)
+```
+
+#### US-CART-002: Cart Management
+```
+As a shopper,
+I want to view and modify my cart,
+So that I can review before checkout.
+
+Acceptance Criteria:
+- [ ] Cart page shows all items with image, name, price, quantity
+- [ ] Can change quantity with +/- buttons or direct input
+- [ ] Can remove items with "Remove" button
+- [ ] Quantity changes update totals immediately
+- [ ] Show subtotal, shipping estimate, tax, total
+- [ ] Empty cart shows empty state with "Continue Shopping" CTA
+- [ ] Save cart for logged-in users across sessions
+- [ ] Show "Item removed" with "Undo" option (5 seconds)
+```
+
+#### US-CHECKOUT-001: Checkout Flow
+```
+As a shopper with items in cart,
+I want to complete my purchase,
+So that I can receive my products.
+
+Acceptance Criteria:
+- [ ] Multi-step checkout: Shipping → Payment → Review → Confirm
+- [ ] Progress indicator shows current step
+- [ ] Shipping: address form with validation
+- [ ] Can save address for future orders
+- [ ] Shipping method selection with prices and delivery estimates
+- [ ] Payment: credit card form (PCI compliant) or PayPal
+- [ ] Review: show all details before final confirm
+- [ ] Terms acceptance checkbox required
+- [ ] Success: confirmation page with order number, email sent
+- [ ] Payment failure: return to payment step with error
+- [ ] Can go back to previous steps without losing data
+```
+
+---
+
+### Dashboard
+
+#### US-DASH-001: Overview Dashboard
+```
+As a logged-in user,
+I want to see a summary of my activity,
+So that I can quickly understand my status.
+
+Acceptance Criteria:
+- [ ] Show personalized greeting with user name
+- [ ] Key metrics cards: [metric 1], [metric 2], [metric 3]
+- [ ] Recent activity list (last 10 items)
+- [ ] Quick action buttons for common tasks
+- [ ] Data refreshes on page load
+- [ ] "Refresh" button for manual refresh
+- [ ] Loading skeletons during data fetch
+- [ ] Error state with retry option
+- [ ] Empty states for users with no data
+```
+
+#### US-DASH-002: Data Filtering
+```
+As a dashboard user,
+I want to filter data by date range,
+So that I can analyze specific time periods.
+
+Acceptance Criteria:
+- [ ] Date range picker with presets (Today, 7 days, 30 days, Custom)
+- [ ] Custom range allows start and end date selection
+- [ ] Cannot select future dates or end before start
+- [ ] Filter applies to all dashboard components
+- [ ] URL updates with filter params (shareable)
+- [ ] Filter persists on page refresh
+- [ ] "Reset" button returns to default (30 days)
+- [ ] Show selected range in filter UI
+```
+
+---
+
+### Content Management
+
+#### US-CMS-001: Create Content
+```
+As a content creator,
+I want to create and publish content,
+So that I can share information with users.
+
+Acceptance Criteria:
+- [ ] Rich text editor with formatting options
+- [ ] Can add images, videos, links
+- [ ] Auto-save draft every 30 seconds
+- [ ] Manual save button always available
+- [ ] Preview mode shows published appearance
+- [ ] Can save as draft or publish immediately
+- [ ] Publish can be scheduled for future date/time
+- [ ] SEO fields: title, description, keywords
+- [ ] Slug auto-generated from title, editable
+- [ ] Validation before publish (title required, min length)
+```
+
+#### US-CMS-002: Edit Content
+```
+As a content creator,
+I want to edit existing content,
+So that I can keep information up to date.
+
+Acceptance Criteria:
+- [ ] Edit page loads with all existing content
+- [ ] Shows last modified date and author
+- [ ] Auto-save during editing
+- [ ] Can revert to previous published version
+- [ ] Version history available
+- [ ] "Unsaved changes" warning when navigating away
+- [ ] Concurrent edit detection with warning
+- [ ] Can unpublish content (returns to draft)
+```
+
+---
+
+### Settings
+
+#### US-SET-001: Profile Settings
+```
+As a user,
+I want to update my profile information,
+So that my account reflects current details.
+
+Acceptance Criteria:
+- [ ] Can update: name, email, avatar, phone
+- [ ] Email change requires verification
+- [ ] Avatar upload with crop/resize
+- [ ] Image formats: JPG, PNG, max 5MB
+- [ ] Changes save on field blur (auto-save)
+- [ ] Success: show "Saved" indicator
+- [ ] Error: show inline error, don't lose input
+- [ ] "Delete account" option with confirmation
+```
+
+#### US-SET-002: Notification Preferences
+```
+As a user,
+I want to control my notifications,
+So that I only receive relevant updates.
+
+Acceptance Criteria:
+- [ ] Toggle for each notification type
+- [ ] Group by channel: Email, Push, In-app
+- [ ] "Enable all" / "Disable all" options
+- [ ] Some notifications mandatory (cannot disable)
+- [ ] Changes save immediately
+- [ ] Show "Saved" confirmation
+- [ ] Frequency options where applicable (immediate, daily digest)
+```
+
+---
+
+## Anti-Patterns to Avoid
+
+### Too Vague
+```
+❌ As a user, I want the app to be better.
+
+✅ As a returning user, I want the homepage to remember my preferences, so that I don't have to reconfigure settings each visit.
+```
+
+### Too Technical
+```
+❌ As a developer, I want to implement Redux, so that state management is centralized.
+
+✅ As a user, I want my shopping cart to persist across browser sessions, so that I don't lose items if I close the browser.
+```
+
+### Too Large (Epic, not Story)
+```
+❌ As a user, I want a complete e-commerce checkout, so that I can buy products.
+
+✅ Break into: US-001 Add to cart, US-002 View cart, US-003 Enter shipping, US-004 Enter payment, US-005 Confirm order
+```
+
+### Missing Value
+```
+❌ As a user, I want a red button.
+
+✅ As a user, I want a prominent "Emergency Contact" button, so that I can quickly get help in urgent situations.
+```
+
+---
+
+## Story Sizing Guide
+
+| Size | Effort | Examples |
+|------|--------|----------|
+| XS | <2 hours | Text change, color update, simple validation |
+| S | 2-4 hours | New form field, simple API integration |
+| M | 1-2 days | New page, complex form, new component |
+| L | 3-5 days | Feature with multiple pages, complex logic |
+| XL | 1+ week | Should be broken down into smaller stories |
+