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

package/bundled/locales/zh-CN/skills/claude-code/methodology-system/SKILL.md

@@ -0,0 +1,131 @@
+---
+source: ../../../../../skills/claude-code/methodology-system/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-12
+status: experimental
+---
+
+# 方法論系统 Skill
+
+> **Language**: [English](../../../../../skills/claude-code/methodology-system/SKILL.md) | 简体中文
+
+> [!WARNING]
+> **实驗性功能 / Experimental Feature**
+>
+> 此功能正在積極开发中，可能在 v4.0 中有重大变更。
+> This feature is under active development and may change significantly in v4.0.
+
+**版本**: 1.0.0
+**最後更新**: 2026-01-12
+
+---
+
+## 概述
+
+方法論系统讓採用此规范的项目能夠选择、配置并遵循特定的开发方法論。內建支援 TDD、BDD、SDD 和 ATDD，并可建立自订方法論。
+
+---
+
+## 功能
+
+### 核心功能
+
+1. **方法論选择** - 從內建方法論中选择或建立自订方法論
+2. **阶段追蹤** - 追蹤當前开发阶段，提供阶段特定的引導
+3. **检查点系统** - 在关鍵时刻自动提醒和验证
+4. **检查清单** - 每个阶段都有必須完成的检查项目
+5. **AI 引導** - 根据當前阶段提供上下文感知的 AI 引導
+
+### 內建方法論
+
+| 方法論 | 说明 | 阶段 |
+|--------|------|------|
+| **TDD** | 测试驅动开发 | 紅燈 → 綠燈 → 重構 |
+| **BDD** | 行为驅动开发 | 探索 → 制定 → 自动化 → 活文件 |
+| **SDD** | 規格驅动开发 | 提案 → 审查 → 实作 → 验证 → 歸檔 |
+| **ATDD** | 驗收测试驅动开发 | 工作坊 → 提煉 → 开发 → 展示 |
+
+---
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `/methodology` | 顯示當前方法論状态 |
+| `/methodology status` | 顯示當前阶段和检查清单 |
+| `/methodology switch <id>` | 切换到不同方法論 |
+| `/methodology phase [name]` | 顯示或变更當前阶段 |
+| `/methodology checklist` | 顯示當前阶段检查清单 |
+| `/methodology skip` | 跳過當前阶段（会有警告） |
+| `/methodology list` | 列出可用方法論 |
+| `/methodology create` | 建立自订方法論 |
+
+---
+
+## 配置
+
+在 `.standards/manifest.json` 中配置方法論：
+
+```json
+{
+  "methodology": {
+    "active": "tdd",
+    "available": ["tdd", "bdd", "sdd", "atdd"],
+    "config": {
+      "checkpointsEnabled": true,
+      "reminderIntensity": "suggest",
+      "skipLimit": 3
+    }
+  }
+}
+```
+
+### 配置选项
+
+| 选项 | 类型 | 预设值 | 说明 |
+|------|------|--------|------|
+| `active` | string | null | 當前啟用的方法論 ID |
+| `available` | string[] | all | 可用的方法論清单 |
+| `checkpointsEnabled` | boolean | true | 是否啟用检查点提醒 |
+| `reminderIntensity` | string | "suggest" | 提醒強度：suggest、warn、block |
+| `skipLimit` | number | 3 | 連續跳過幾次後顯示警告 |
+
+---
+
+## AI 行为
+
+當方法論啟用时，AI 会：
+
+1. **顯示阶段指示器** - 使用表情符号標示當前阶段（如 🔴 RED）
+2. **提供阶段引導** - 根据當前阶段建议適當的行动
+3. **追蹤检查清单** - 自动追蹤和更新检查项目状态
+4. **顯示检查点** - 在阶段转换或大量变更时提醒用戶
+5. **建议提交** - 根据变更累積量建议適當的提交时机
+
+---
+
+## 自订方法論
+
+可以建立自订方法論來符合团队需求：
+
+1. 使用 `/methodology create` 啟动互动式建立精靈
+2. 或手动在 `.standards/methodologies/` 建立 YAML 文件
+
+詳見 [建立自订方法論](create-methodology.md)。
+
+---
+
+## 相关文件
+
+- [命令文档](../commands/methodology.md) - `/methodology` 命令详细文档
+- [执行时引導](runtime.md) - AI 行为規格
+- [建立自订方法論](create-methodology.md) - 建立指南
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2026-01-12 | 初始方法論系统 |

package/bundled/locales/zh-CN/skills/claude-code/methodology-system/create-methodology.md

@@ -0,0 +1,350 @@
+---
+source: ../../../../../skills/claude-code/methodology-system/create-methodology.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-12
+status: experimental
+---
+
+# 建立自订方法論指南
+
+> **Language**: [English](../../../../../skills/claude-code/methodology-system/create-methodology.md) | 简体中文
+
+> [!WARNING]
+> **实驗性功能 / Experimental Feature**
+>
+> 此功能正在積極开发中，可能在 v4.0 中有重大变更。
+> This feature is under active development and may change significantly in v4.0.
+
+**版本**: 1.0.0
+**最後更新**: 2026-01-12
+
+---
+
+## 概述
+
+本指南幫助您为团队或项目建立自订开发方法論。自订方法論储存在 `.standards/methodologies/` 目录中，并遵循与內建方法論相同的 YAML 结构。
+
+---
+
+## 互动式建立精靈
+
+使用 `/methodology create` 啟动互动式精靈：
+
+### 步骤 1：基本信息
+
+```
+╔════════════════════════════════════════════════╗
+║         建立自订方法論                          ║
+╠════════════════════════════════════════════════╣
+║                                                ║
+║  您的方法論名称是什麼？                         ║
+║  > 我的团队工作流                               ║
+║                                                ║
+║  簡短描述：                                     ║
+║  > 我們团队的迭代开发流程，包含規划和审查阶段   ║
+║                                                ║
+║  ID（自动产生）: my-team-workflow               ║
+║                                                ║
+╚════════════════════════════════════════════════╝
+```
+
+### 步骤 2：定義阶段
+
+```
+╔════════════════════════════════════════════════╗
+║         定義阶段 (1/?)                          ║
+╠════════════════════════════════════════════════╣
+║                                                ║
+║  阶段 1：                                       ║
+║  ─────────────────────────────────────         ║
+║  名称：規划                                     ║
+║  描述：規划实作方法                             ║
+║  预估时间：15-30 分鐘                           ║
+║  表情符号：📋                                   ║
+║                                                ║
+║  检查清单项目（每行一项）：                     ║
+║  在必填项目前加上 *                             ║
+║  ─────────────────────────────────────         ║
+║  * 需求已理解                                   ║
+║  * 设计方法已审查                               ║
+║  相依性已識别                                   ║
+║                                                ║
+║  什麼觸發離開此阶段？                           ║
+║  > 用戶确认規划完成                             ║
+║                                                ║
+║  離開後的下一个阶段？                           ║
+║  > 实作                                         ║
+║                                                ║
+║  [新增另一个阶段] [阶段定義完成]                ║
+║                                                ║
+╚════════════════════════════════════════════════╝
+```
+
+### 步骤 3：配置检查点
+
+```
+╔════════════════════════════════════════════════╗
+║         配置检查点                              ║
+╠════════════════════════════════════════════════╣
+║                                                ║
+║  选择检查点提醒：                               ║
+║  ─────────────────────────────────────         ║
+║  [x] 在阶段转换时提醒                           ║
+║  [x] 跳過 3 次簽入後警告                        ║
+║  [ ] 变更超過 200 行後提醒                      ║
+║  [ ] 30 分鐘没有提交後提醒                      ║
+║                                                ║
+║  提醒強度：                                     ║
+║  ( ) 建议 - 溫和提醒                            ║
+║  (•) 警告 - 更明顯                              ║
+║  ( ) 嚴格 - 阻止直到处理                        ║
+║                                                ║
+╚════════════════════════════════════════════════╝
+```
+
+### 步骤 4：审查并储存
+
+```
+╔════════════════════════════════════════════════╗
+║         审查方法論                              ║
+╠════════════════════════════════════════════════╣
+║                                                ║
+║  名称：我的团队工作流                           ║
+║  ID：my-team-workflow                           ║
+║                                                ║
+║  阶段：                                         ║
+║  ─────────────────────────────────────         ║
+║  1. 📋 規划                                     ║
+║     └─ 检查清单：3 项（2 项必填）               ║
+║  2. 💻 实作                                     ║
+║     └─ 检查清单：4 项（3 项必填）               ║
+║  3. 👀 审查                                     ║
+║     └─ 检查清单：3 项（2 项必填）               ║
+║                                                ║
+║  检查点：2 个啟用                               ║
+║  強度：警告                                     ║
+║                                                ║
+║  [储存] [编辑] [取消]                           ║
+║                                                ║
+╚════════════════════════════════════════════════╝
+
+方法論已建立！
+
+储存到：.standards/methodologies/my-team-workflow.methodology.yaml
+
+啟用：/methodology switch my-team-workflow
+```
+
+---
+
+## 手动建立
+
+您也可以手动建立方法論文件：
+
+### 1. 建立目录
+
+```bash
+mkdir -p .standards/methodologies
+```
+
+### 2. 建立 YAML 文件
+
+建立 `.standards/methodologies/my-workflow.methodology.yaml`：
+
+```yaml
+$schema: "https://raw.githubusercontent.com/anthropics/universal-dev-standards/main/methodologies/methodology-schema.json"
+id: my-workflow
+name: My Custom Workflow
+nameZh: 我的自订工作流
+version: 1.0.0
+description: A custom development workflow for our team
+
+phases:
+  - id: plan
+    name: Planning
+    nameZh: 規划
+    description: Plan the implementation approach
+    duration: "15-30 minutes"
+    emoji: "📋"
+    checklist:
+      - id: requirements-clear
+        text: Requirements are clearly understood
+        textZh: 需求已清楚理解
+        required: true
+    triggers:
+      exit:
+        - condition: user_confirms_plan_complete
+          nextPhase: implement
+```
+
+### 3. 啟用方法論
+
+```bash
+/methodology switch my-workflow
+```
+
+---
+
+## Schema 參考
+
+### 必填欄位
+
+| 欄位 | 类型 | 说明 |
+|------|------|------|
+| `id` | string | 唯一識别码（小写、連字号） |
+| `name` | string | 顯示名称 |
+| `version` | string | 語意化版本 |
+| `phases` | array | 至少一个阶段 |
+
+### 阶段欄位
+
+| 欄位 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `id` | string | 是 | 阶段識别码 |
+| `name` | string | 是 | 顯示名称 |
+| `description` | string | 是 | 此阶段的说明 |
+| `checklist` | array | 否 | 验证项目 |
+| `triggers` | object | 否 | 进入/離開条件 |
+| `guidance` | object | 否 | AI 提示 |
+| `duration` | string | 否 | 预估时间 |
+| `emoji` | string | 否 | 视覺指示器 |
+
+---
+
+## 最佳实踐
+
+### 1. 保持阶段專注
+
+每个阶段应有明确、单一的目的。如果一个阶段有超過 5-6 个检查项目，考慮拆分。
+
+### 2. 使用有意義的 ID
+
+```yaml
+# 好的
+id: code-review
+id: integration-test
+
+# 避免
+id: phase1
+id: step-a
+```
+
+### 3. 使检查清单可操作
+
+```yaml
+# 好的
+text: 测试涵蓋邊界情况
+text: 错误处理已实作
+
+# 避免
+text: 程序码很好
+text: 一切正常
+```
+
+### 4. 提供有幫助的引導
+
+在阶段引導中包含实用提示：
+
+```yaml
+guidance:
+  prompt: |
+    ## 审查阶段
+
+    重点領域：
+    - 安全漏洞
+    - 效能影響
+    - API 契約变更
+
+    {{ checklist | format_checklist }}
+```
+
+### 5. 考慮本地化
+
+始終为雙語团队提供 `nameZh`、`textZh`、`promptZh`。
+
+---
+
+## 範例
+
+### 熱修復工作流
+
+```yaml
+id: hotfix
+name: Hotfix Workflow
+nameZh: 熱修復工作流
+phases:
+  - id: reproduce
+    name: Reproduce Issue
+    nameZh: 重現問題
+    checklist:
+      - id: issue-reproduced
+        text: Issue reproduced locally
+        textZh: 問題已在本地重現
+        required: true
+  - id: fix
+    name: Apply Fix
+    nameZh: 应用修復
+    checklist:
+      - id: minimal-fix
+        text: Fix is minimal and targeted
+        textZh: 修復是最小且針对性的
+        required: true
+  - id: verify
+    name: Verify Fix
+    nameZh: 验证修復
+    checklist:
+      - id: issue-resolved
+        text: Original issue is resolved
+        textZh: 原始問題已解决
+        required: true
+```
+
+### 功能旗標工作流
+
+```yaml
+id: feature-flag
+name: Feature Flag Development
+nameZh: 功能旗標开发
+phases:
+  - id: design-flag
+    name: Design Flag
+    nameZh: 设计旗標
+    checklist:
+      - id: flag-named
+        text: Flag has descriptive name
+        textZh: 旗標有描述性名称
+        required: true
+  - id: implement-behind-flag
+    name: Implement Behind Flag
+    nameZh: 在旗標後实作
+    checklist:
+      - id: default-off
+        text: Flag defaults to off
+        textZh: 旗標预设为关閉
+        required: true
+  - id: gradual-rollout
+    name: Gradual Rollout
+    nameZh: 漸进式推出
+    checklist:
+      - id: metrics-monitored
+        text: Metrics being monitored
+        textZh: 正在監控指標
+        required: true
+  - id: cleanup
+    name: Cleanup
+    nameZh: 清理
+    checklist:
+      - id: flag-removed
+        text: Flag code removed after full rollout
+        textZh: 完全推出後移除旗標程序码
+        required: true
+```
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2026-01-12 | 初始建立指南 |