universal-dev-standards 3.5.1-beta.1 → 3.5.1-beta.11

package/bundled/locales/zh-CN/skills/claude-code/requirement-assistant/SKILL.md

@@ -0,0 +1,227 @@
+---
+source: skills/claude-code/requirement-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+name: requirement-assistant
+description: |
+  引導需求撰写、使用者故事建立与功能規格制定。
+  使用时机：撰写需求、使用者故事、問題单、功能規划。
+  关鍵字：requirement, user story, issue, feature, specification, 需求, 功能規划, 規格。
+---
+
+# 需求助手
+
+> **语言**: [English](../../../../../skills/claude-code/requirement-assistant/SKILL.md) | 简体中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-24
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+本 Skill 提供撰写清晰、完整且可执行需求的指導。
+
+## 快速參考
+
+### 使用者故事格式（INVEST）
+
+```
+作为 [角色]，
+我想要 [功能]，
+以便 [效益]。
+```
+
+### INVEST 原則
+
+| 原則 | 说明 | 应該問的問題 |
+|------|------|--------------|
+| **I**ndependent（獨立性） | 可以单獨交付 | 这是否依賴其他故事？ |
+| **N**egotiable（可協商性） | 細节可以討論 | 这是否太過具体規定？ |
+| **V**aluable（有价值性） | 提供使用者价值 | 这解决了什麼問題？ |
+| **E**stimable（可估算性） | 可以估算工作量 | 我們了解範圍嗎？ |
+| **S**mall（小型化） | 適合在一个衝刺內完成 | 我們可以拆分这个嗎？ |
+| **T**estable（可测试性） | 有明确的驗收标准 | 我們如何知道完成了？ |
+
+### 需求優先级
+
+| 優先级 | 标签 | 说明 |
+|--------|------|------|
+| P0 | 必須有 | 發布的关鍵需求 |
+| P1 | 应該有 | 重要但不阻塞 |
+| P2 | 可以有 | 可有可無 |
+| P3 | 不会有 | 超出範圍（本次發布） |
+
+## 详细指南
+
+完整标准請參考：
+- [需求撰写指南](./requirement-writing.md)
+- [需求检查清单](./requirement-checklist.md)
+
+## 快速範本
+
+### 簡单 Issue 範本
+
+```markdown
+## 問題
+[我們要解决什麼問題？]
+
+## 建议解决方案
+[我們应該如何解决？]
+
+## 驗收标准
+- [ ] [标准 1]
+- [ ] [标准 2]
+- [ ] [标准 3]
+```
+
+### 功能需求範本
+
+```markdown
+## 摘要
+[一行描述]
+
+## 动机
+[为什麼需要这个？誰会受益？]
+
+## 详细描述
+[功能的完整描述]
+
+## 驗收标准
+- [ ] [可衡量的标准 1]
+- [ ] [可衡量的标准 2]
+
+## 超出範圍
+- [这个功能不包含什麼]
+```
+
+### 错误回报範本
+
+```markdown
+## 描述
+[错误的簡要描述]
+
+## 重現步骤
+1. [步骤 1]
+2. [步骤 2]
+3. [步骤 3]
+
+## 预期行为
+[应該發生什麼]
+
+## 实际行为
+[实际發生什麼]
+
+## 環境
+- 作业系统：[例如：Windows 11]
+- 版本：[例如：v1.2.3]
+```
+
+## 驗收标准指南
+
+### 好的驗收标准
+
+- **具体的**：清晰、無歧義
+- **可衡量的**：可以验证通過/失败
+- **可实現的**：技術上可行
+- **相关的**：与需求相关
+- **可测试的**：可以为其编写测试
+
+### 範例
+
+**好的範例**：
+```markdown
+- [ ] 使用者可以上传最大 10MB 的文件
+- [ ] 系统在第 95 百分位數內 500ms 內响应
+- [ ] 上传失败时顯示错误消息
+```
+
+**不好的範例**：
+```markdown
+- [ ] 系统应該很快  # 無法衡量
+- [ ] 使其使用者友善  # 太模糊
+- [ ] 修復错误        # 没有具体标准
+```
+
+## 需求完整性检查清单
+
+撰写需求时，确保涵蓋：
+
+- [ ] **什麼**：功能的清晰描述
+- [ ] **为什麼**：商业价值/解决的問題
+- [ ] **誰**：目標使用者/角色
+- [ ] **何时**：優先级/时间表
+- [ ] **如何**：高阶方法（如果已知）
+- [ ] **驗收**：完成标准
+- [ ] **範圍**：不包含什麼
+
+---
+
+## 设置檢测
+
+此 Skill 支援项目特定的需求範本。
+
+### 檢测順序
+
+1. 检查 `CONTRIBUTING.md` 中的「停用的 Skills」區段
+   - 如果此 Skill 在列表中，則此项目停用此 Skill
+2. 检查 `CONTRIBUTING.md` 中的「需求语言」區段
+3. 检查 `.github/ISSUE_TEMPLATE/` 目录
+4. 检查 `docs/templates/` 目录
+5. 如果未找到，**预设使用英文**并使用预设範本
+
+### 首次设置
+
+如果未找到範本：
+
+1. 詢問使用者：「此项目没有需求範本。我应該使用哪种语言？（English / 中文）」
+2. 使用者选择後，建议在 `CONTRIBUTING.md` 中记录：
+
+```markdown
+## 需求语言
+
+此项目使用 **[选择的选项]** 撰写需求和 issues。
+<!-- 选项：English | 中文 -->
+```
+
+3. 根据项目类型建议適當的範本
+
+### 设置範例
+
+在项目的 `CONTRIBUTING.md` 中：
+
+```markdown
+## 需求语言
+
+此项目使用 **English** 撰写需求和 issues。
+<!-- 选项：English | 中文 -->
+
+### Issue 範本位置
+`.github/ISSUE_TEMPLATE/`
+```
+
+---
+
+## 相关标准
+
+- [規格驅动开发](../../core/spec-driven-development.md)
+- [簽入标准](../../core/checkin-standards.md)
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2025-12-24 | 新增：标准區段（目的、相关标准、版本历史、授权） |
+
+---
+
+## 授权
+
+本 Skill 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
+
+**來源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-CN/skills/claude-code/requirement-assistant/requirement-checklist.md

@@ -0,0 +1,325 @@
+---
+source: skills/claude-code/requirement-assistant/requirement-checklist.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+---
+
+# 需求完整性检查清单
+
+> **语言**: [English](../../../../../skills/claude-code/requirement-assistant/requirement-checklist.md) | 简体中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-24
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+本文件提供用於验证需求完整性和品质的检查清单。
+
+---
+
+## 快速检查清单
+
+在提交任何需求之前，請验证以下要点:
+
+| 项目 | 勾選 | 問題 |
+|------|:-----:|----------|
+| 問題 | [ ] | 我們要解决什麼問題？ |
+| 使用者 | [ ] | 誰会從中受益？ |
+| 价值 | [ ] | 为什麼这很重要？ |
+| 範圍 | [ ] | 包含和排除什麼？ |
+| 标准 | [ ] | 我們如何知道已完成？ |
+| 優先级 | [ ] | 这有多緊急？ |
+
+---
+
+## 按需求类型的详细检查清单
+
+### 功能需求检查清单
+
+#### 1. 問題定義
+
+- [ ] 問題陳述清楚
+- [ ] 識别目前的痛点
+- [ ] 量化影響（如可能）
+- [ ] 了解根本原因
+
+#### 2. 使用者情境
+
+- [ ] 識别目標使用者/角色
+- [ ] 描述使用者目標
+- [ ] 记录目前的替代方案
+- [ ] 繪制使用者旅程（如複雜）
+
+#### 3. 解决方案描述
+
+- [ ] 描述功能（非实作）
+- [ ] 概述使用者互动
+- [ ] 陳述预期結果
+- [ ] 定義成功指標
+
+#### 4. 驗收标准
+
+- [ ] 所有标准都可测试
+- [ ] 涵蓋正常路徑
+- [ ] 定義错误情境
+- [ ] 考慮邊界情况
+- [ ] 效能标准（如適用）
+
+#### 5. 範圍定義
+
+- [ ] 列出範圍內项目
+- [ ] 列出範圍外项目
+- [ ] 注明未來考慮事项
+- [ ] 識别依賴关系
+
+#### 6. 優先级与时间表
+
+- [ ] 分配優先级（P0-P3 或 MoSCoW）
+- [ ] 提供业务理由
+- [ ] 注明截止日期（如有）
+- [ ] 識别發布目標
+
+---
+
+### 错误报告检查清单
+
+#### 1. 描述
+
+- [ ] 標題清晰且具体
+- [ ] 描述簡潔
+- [ ] 陳述影響/嚴重性
+
+#### 2. 重現
+
+- [ ] 步骤已编号
+- [ ] 步骤可重現
+- [ ] 列出先决条件
+- [ ] 提供测试数据（如需要）
+
+#### 3. 行为
+
+- [ ] 描述预期行为
+- [ ] 描述实际行为
+- [ ] 差異清楚
+
+#### 4. 证据
+
+- [ ] 附加截图（如 UI）
+- [ ] 包含错误日誌（如可用）
+- [ ] 提供堆疊追蹤（如崩潰）
+
+#### 5. 環境
+
+- [ ] 作业系统和版本
+- [ ] 浏览器和版本（如网页）
+- [ ] 应用程序版本
+- [ ] 相关配置
+
+#### 6. 分类
+
+- [ ] 分配嚴重性
+- [ ] 分配優先级
+- [ ] 識别元件/區域
+- [ ] 連結相关問題
+
+---
+
+### 技術任务检查清单
+
+#### 1. 情境
+
+- [ ] 为什麼需要这个？
+- [ ] 它解决什麼問題？
+- [ ] 什麼觸發了这个任务？
+
+#### 2. 技術細节
+
+- [ ] 描述方法
+- [ ] 列出受影響的元件
+- [ ] 注明数据庫变更
+- [ ] 注明 API 变更
+
+#### 3. 範圍
+
+- [ ] 將变更什麼？
+- [ ] 將不会变更什麼？
+- [ ] 处理向後相容性
+
+#### 4. 标准
+
+- [ ] 完成定義清楚
+- [ ] 定義测试需求
+- [ ] 識别文件需求
+
+#### 5. 風險
+
+- [ ] 識别技術風險
+- [ ] 注明緩解策略
+- [ ] 回滾计画（如部署）
+
+---
+
+## INVEST 验证
+
+使用此方法验证使用者故事:
+
+### Independent（獨立）
+
+- [ ] 可以在没有其他故事的情况下交付
+- [ ] 没有阻塞依賴关系
+- [ ] 可以自由排定優先级
+
+**如果否**: 考慮与依賴故事合併或重新定義範圍。
+
+### Negotiable（可協商）
+
+- [ ] 实作細节未鎖定
+- [ ] 有技術討論空间
+- [ ] 專注於「做什麼」，而非「如何做」
+
+**如果否**: 移除实作細节，專注於結果。
+
+### Valuable（有价值）
+
+- [ ] 为使用者/利害关系人提供价值
+- [ ] 解决真实問題
+- [ ] 好处清楚
+
+**如果否**: 重新考慮是否应該执行。
+
+### Estimable（可估计）
+
+- [ ] 团队可以估计工作量
+- [ ] 了解範圍
+- [ ] 没有重大未知數
+
+**如果否**: 首先需要探索/研究任务。
+
+### Small（小型）
+
+- [ ] 可以在一个 sprint 內完成
+- [ ] 通常 1-5 天的工作量
+- [ ] 单一連貫的工作部分
+
+**如果否**: 拆分成更小的故事。
+
+### Testable（可测试）
+
+- [ ] 清楚的驗收标准
+- [ ] 可以编写自动化测试
+- [ ] 完成定義明确
+
+**如果否**: 添加具体、可衡量的标准。
+
+---
+
+## 驗收标准品质检查
+
+对於每个驗收标准:
+
+| 品质 | 勾選 | 範例 |
+|---------|:-----:|---------|
+| 具体 | [ ] | "登入按鈕为藍色 (#007bff)" 而非 "按鈕看起來不錯" |
+| 可衡量 | [ ] | "响应 < 200ms" 而非 "快速响应" |
+| 可达成 | [ ] | 技術上可行 |
+| 相关 | [ ] | 与需求相关 |
+| 可测试 | [ ] | 可以编写测试案例 |
+
+### 常見問題
+
+| 問題 | 不良範例 | 良好範例 |
+|-------|-------------|--------------|
+| 過於模糊 | "系统运作良好" | "系统在 500ms 內回传 200 OK" |
+| 主觀 | "UI 使用者友善" | "使用者可以在 3 次点擊內完成結帳" |
+| 缺少邊界情况 | "使用者可以上传文件" | "使用者可以上传 1-10MB 文件；較大文件顯示错误" |
+| 实作細节 | "使用 Redis 快取" | "儀表板在 1 秒內载入" |
+
+---
+
+## 最終审查检查清单
+
+在提交开发之前：
+
+### 内容品质
+
+- [ ] 標題清楚且具描述性
+- [ ] 描述完整
+- [ ] 没有模糊的语言
+- [ ] 没有未陳述的假设
+- [ ] 技術術語已解釋
+
+### 完整性
+
+- [ ] 所有必填欄位已填写
+- [ ] 驗收标准已定義
+- [ ] 範圍邊界清楚
+- [ ] 依賴项已列出
+- [ ] 優先级已分配
+
+### 一致性
+
+- [ ] 遵循团队範本
+- [ ] 一致的術語
+- [ ] 已連結到相关项目
+- [ ] 标签正确应用
+
+### 准备开发
+
+- [ ] 团队可以估算工作量
+- [ ] 没有阻塞的問題
+- [ ] 利害关系人批准（如果需要）
+- [ ] 设计資产已准备（如果是 UI）
+
+---
+
+## 检查結果
+
+**需求標題**：___________________________
+
+**检查者**：___________________________
+
+**日期**：___________________________
+
+| 區段 | 完成 | 备註 |
+|------|:----:|------|
+| 問題定義 | [ ] | |
+| 使用者情境 | [ ] | |
+| 解决方案描述 | [ ] | |
+| 驗收标准 | [ ] | |
+| 範圍定義 | [ ] | |
+| 優先级 | [ ] | |
+| INVEST 验证 | [ ] | |
+
+**准备开发**：[ ] 是  [ ] 否
+
+**行动项目**：
+- ___________________________
+- ___________________________
+
+---
+
+## 相关标准
+
+- [需求撰写指南](./requirement-writing.md)
+- [規格驅动开发](../../../core/spec-driven-development.md)
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2025-12-24 | 新增：标准區段（目的、相关标准、版本历史、授权） |
+
+---
+
+## 授权
+
+本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
+
+**來源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)