universal-dev-standards 5.15.1 → 5.17.0

package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: methodology
+source: ../../../../skills/dev-methodology/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-06-02
+source_hash: d654ee51f713
+status: current
+scope: partial
+description: |
+  [UDS] /methodology: 选择并追踪开发方法论（SDD/BDD/TDD）。
+  Use when: 选择方法论、切换开发模式、查询当前方法论状态。
+  若要查询各阶段对应命令请用 /dev-workflow。
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[动作] [参数]"
+---
+
+# 方法论系统
+
+> **语言**: [English](../../../../skills/dev-methodology/SKILL.md) | 简体中文
+
+> [!WARNING]
+> **实验性功能**
+>
+> 此功能正在积极开发中，可能在 v4.0 中有重大变更。
+
+选择并管理当前项目启用的开发方法论。本技能专注于**选择使用哪种方法论**（SDD、BDD、TDD），并追踪所选方法论内的阶段进度。
+
+> **相关**：如需查询开发阶段对应的 UDS 命令，请改用 `/dev-workflow`。
+
+### 何时使用 `/methodology` 与 `/dev-workflow`
+
+| 场景 | `/methodology` | `/dev-workflow` |
+|------|---------------|-----------------|
+| 在 SDD / BDD / TDD 之间选择 | ✅ | ❌ |
+| 切换不同方法论 | ✅ | ❌ |
+| 追踪当前阶段进度 | ✅ | ❌ |
+| 找出某个任务该用的 UDS 命令 | ❌ | ✅ |
+| 取得新功能 / Bug 修复的逐步流程 | ❌ | ✅ |
+| 浏览 8 个开发阶段 | ❌ | ✅ |
+
+**两个独立系统：**
+- **System A：SDD** — 规格驱动开发（AI 时代，spec-first）
+- **System B：双循环 TDD** — BDD（外圈）+ TDD（内圈）（传统）
+
+**可选输入：** ATDD — 验收测试驱动开发（可馈入任一系统）
+
+## 动作
+
+| 动作 | 说明 |
+|------|------|
+| *(无)* / `status` | 显示当前阶段与检查清单 |
+| `switch <id>` | 切换到不同方法论 |
+| `phase [name]` | 显示或变更当前阶段 |
+| `checklist` | 显示当前阶段检查清单 |
+| `skip` | 跳过当前阶段（会出现警告） |
+| `list` | 列出可用方法论 |
+| `create` | 创建自定义方法论 |
+
+## 可用方法论
+
+| 系统 | ID | 工作流程 | 说明 |
+|------|-----|----------|------|
+| A: SDD | `sdd` | /sdd → 审查 → /derive-all → 实现 | 规格优先 |
+| B: BDD | `bdd` | Discovery → Formulation → Automation | 外部循环 |
+| B: TDD | `tdd` | Red → Green → Refactor | 内部循环 |
+| 输入 | `atdd` | Workshop → Examples → Tests | 验收测试驱动 |
+
+## 使用示例
+
+```bash
+/methodology                    # 显示当前状态
+/methodology switch sdd         # 切换至规格驱动开发
+/methodology phase green        # 移动到 GREEN 阶段（TDD）
+/methodology checklist          # 显示当前阶段检查清单
+/methodology list               # 列出所有可用方法论
+/methodology skip               # 跳过当前阶段（会出现警告）
+/methodology create             # 启动自定义方法论向导
+```
+
+## 配置
+
+方法论设置存储于 `.standards/manifest.json`：
+
+```json
+{
+  "methodology": {
+    "active": "sdd",
+    "available": ["tdd", "bdd", "sdd", "atdd"]
+  }
+}
+```
+
+## 下一步引导
+
+`/methodology` 完成后，AI 助手应依所选方法论建议下一步：
+
+> **方法论已设置。建议下一步：**
+> - SDD 方法论 → 执行 `/sdd` 创建规格 ⭐ **推荐**
+> - BDD 方法论 → 执行 `/bdd` 开始场景探索
+> - TDD 方法论 → 执行 `/tdd` 开始红绿重构
+> - ATDD 方法论 → 执行 `/atdd` 定义验收条件
+
+## 参考
+
+- 详细指南：[guide.md](./guide.md)
+
+## AI 代理行为
+
+> 完整的 AI 行为定义请参阅对应的命令文件：[`/methodology`](../../../../skills/commands/methodology.md#ai-agent-behavior--ai-代理行为)

package/bundled/locales/zh-CN/skills/dev-methodology/guide.md

@@ -0,0 +1,255 @@
+---
+source: ../../../../skills/dev-methodology/guide.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-06-02
+source_hash: a17742b81576
+status: current
+scope: partial
+description: |
+  管理并引导开发者完成进行中的开发方法论工作流。
+  适用场景：需要 TDD、BDD、SDD、ATDD 或自定义方法论工作流时。
+  关键词：方法论、工作流、TDD、BDD、SDD、ATDD、阶段、检查点、开发流程。
+---
+
+> [!WARNING]
+> **实验性功能 / 實驗性功能**
+>
+> 此功能正在积极开发中，可能在 v4.0 中有重大变更。
+> 此功能正在積極開發中，可能在 v4.0 中有重大變更。
+
+# 方法论系统 Skill
+
+> **语言**：English | [繁體中文](../../locales/zh-TW/skills/methodology-system/SKILL.md)
+
+**版本**：2.0.0
+**最后更新**：2026-01-25
+
+---
+
+## 概述
+
+方法论系统为采用 Universal Development Standards 的项目提供了一个管理开发方法论的统一框架。
+
+### 两个独立系统
+
+```
+┌────────────────────────────────────────────────────────────────────────────┐
+│                  Two Independent Methodology Systems                         │
+├────────────────────────────────────────────────────────────────────────────┤
+│                                                                            │
+│  System A: SDD (AI-Era Methodology)                                        │
+│  ─────────────────────────────────────                                     │
+│  /sdd → Review → /derive-all → Implementation → Verification               │
+│  Best for: New projects, AI-assisted development, greenfield features     │
+│                                                                            │
+│  System B: Double-Loop TDD (Traditional)                                   │
+│  ─────────────────────────────────────                                     │
+│  /bdd (Outer Loop) → /tdd (Inner Loop) → Demo                              │
+│  Best for: Legacy systems, manual development, established codebases      │
+│                                                                            │
+│  Optional Input: ATDD Workshop                                             │
+│  ─────────────────────────────────────                                     │
+│  Stakeholder collaboration that feeds into EITHER system                   │
+│                                                                            │
+└────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 支持的方法论
+
+**系统 A：SDD（规格驱动开发，Spec-Driven Development）**
+- 讨论 → 提案 → 评审 → 正向推导 → 实现 → 验证 → 归档
+- 以规格作为权威来源的 AI 原生工作流
+
+**系统 B：双循环 TDD**
+- **BDD**（外循环）- 发现 → 制定 → 自动化
+- **TDD**（内循环）- 红 → 绿 → 重构
+
+**可选输入**
+- **ATDD** - 验收测试驱动开发研讨会（可输入到任一系统）
+
+**自定义** - 用户自定义的方法论
+
+---
+
+## 功能特性
+
+### 1. 阶段感知引导
+
+AI 会自动追踪当前阶段并提供符合上下文的引导：
+
+```
+┌─────────────────────────────────────────────┐
+│ 📋 Current Methodology: TDD                  │
+│ 📍 Current Phase: 🔴 RED (1-5 min)           │
+│                                             │
+│ Checklist:                                  │
+│   ✅ Test describes behavior                │
+│   ✅ Test name is clear                     │
+│   ⬜ Test follows AAA pattern               │
+│   ⬜ Test fails when run                    │
+│                                             │
+│ Next: Write the test following AAA pattern  │
+└─────────────────────────────────────────────┘
+```
+
+### 2. 检查点提醒
+
+基于方法论触发条件的自动提醒：
+
+- **阶段转换**：阶段完成时建议提交（commit）
+- **累积警告**：变更超过阈值时发出警告
+- **跳过警告**：连续跳过检查后发出警示
+
+### 3. 方法论切换
+
+随着项目需求变化，在各方法论之间切换：
+
+```
+/methodology switch bdd
+```
+
+### 4. 自定义方法论支持
+
+在 `.standards/methodologies/` 中定义团队专属的工作流：
+
+```yaml
+id: my-team-workflow
+name: My Team Workflow
+phases:
+  - id: plan
+    name: Planning
+    checklist:
+      - id: requirements-clear
+        text: Requirements understood
+        required: true
+```
+
+---
+
+## 命令
+
+| 命令 | 说明 |
+|---------|-------------|
+| `/methodology` | 显示当前方法论状态 |
+| `/methodology switch <id>` | 切换到不同的方法论 |
+| `/methodology phase [phase]` | 显示或变更当前阶段 |
+| `/methodology checklist` | 显示当前阶段的检查清单 |
+| `/methodology skip` | 跳过当前阶段（带警告） |
+| `/methodology list` | 列出可用的方法论 |
+| `/methodology create` | 创建自定义方法论 |
+
+---
+
+## 配置
+
+方法论配置存储在 `.standards/manifest.json` 中：
+
+```json
+{
+  "methodology": {
+    "active": "tdd",
+    "available": ["tdd", "bdd", "sdd", "atdd"],
+    "config": {
+      "tdd": {
+        "checkpointsEnabled": true,
+        "reminderIntensity": "suggest",
+        "skipLimit": 3
+      }
+    }
+  }
+}
+```
+
+### 配置选项
+
+| 选项 | 取值 | 说明 |
+|--------|--------|-------------|
+| `active` | 方法论 id | 当前激活的方法论 |
+| `checkpointsEnabled` | `true`/`false` | 启用检查点提醒 |
+| `reminderIntensity` | `suggest`/`warning`/`strict` | 强制检查点的强度 |
+| `skipLimit` | 数字 | 发出警告前的连续跳过次数 |
+
+---
+
+## AI 行为
+
+### 检测
+
+1. 检查 `.standards/manifest.json` 中的 `methodology.active`
+2. 从以下位置加载方法论定义：
+   - 内置：`methodologies/{id}.methodology.yaml`
+   - 自定义：`.standards/methodologies/{id}.methodology.yaml`
+
+### 阶段追踪
+
+- 根据触发条件追踪当前阶段
+- 当满足退出条件时更新阶段
+- 提供阶段专属的引导与检查清单
+
+### 上下文关键词
+
+当检测到以下关键词时，AI 会自动激活方法论上下文：
+
+| 系统 | 方法论 | 关键词 |
+|--------|-------------|----------|
+| A: SDD | SDD | specification, spec first, proposal, derive tests, forward derivation |
+| B: 双循环 | BDD（外） | given when then, gherkin, cucumber, scenario, discovery |
+| B: 双循环 | TDD（内） | test first, red green refactor, failing test |
+| 输入 | ATDD | acceptance test, user story, product owner, workshop |
+
+---
+
+## 与其他标准的整合
+
+### 检入标准（Check-in Standards）
+
+当某个阶段完成时，方法论系统会与 `checkin-standards.md` 整合：
+
+```
+Phase GREEN completed.
+
+Changes:
+- Files: 3
+- Lines: +45 / -2
+
+Suggested commit:
+  test(auth): add login validation test
+  feat(auth): implement login validation
+
+[1] Commit now  [2] Continue working  [3] View changes
+```
+
+### 代码评审
+
+会根据当前激活的方法论增加额外的评审检查项：
+
+- **TDD**：测试遵循命名约定，每个测试只验证单一行为
+- **BDD**：声明式风格，可复用的步骤
+- **SDD**：变更与规格一致，无范围蔓延
+- **ATDD**：所有验收条件都有对应的测试
+
+---
+
+## 相关 Skill
+
+- [TDD Assistant](../tdd-assistant/SKILL.md) - 详细的 TDD 引导
+- [Spec-Driven Dev](../spec-driven-dev/SKILL.md) - SDD 工作流
+- [Code Review Assistant](../code-review-assistant/SKILL.md) - 评审整合
+
+---
+
+## 文件
+
+- [integrated-flow.md](./integrated-flow.md) - 两个系统的完整工作流指南
+- [runtime.md](./runtime.md) - AI 行为与运行时指南
+- [create-methodology.md](./create-methodology.md) - 自定义方法论创建向导
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|---------|------|---------|
+| 2.0.0 | 2026-01-25 | 重构为两个独立系统的架构 |
+| 1.0.0 | 2026-01-12 | 初始方法论系统 |

package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md

@@ -2,7 +2,8 @@
 source: ../../../../skills/dev-workflow-guide/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-03-24
+last_synced: 2026-06-02
+source_hash: 5bf83f0db544
 status: current
 description: |
   将软件开发阶段对应到 UDS 命令与技能。
@@ -32,13 +33,13 @@ V. Release ──► VI. Documentation ──► VII. Standards ──► VIII.
 
 | 阶段 | UDS 命令 | 用途 |
 |------|---------|------|
-| **I. 规划与设计** | `/brainstorm` `/requirement` `/sdd` `/reverse` | 需求、规格、逆向工程 |
-| **II. 测试驱动开发** | `/bdd` `/atdd` `/tdd` `/coverage` `/derive` | 先写测试再写代码 |
-| **III. 实现** | `/refactor` `/reverse` | 撰写与改善代码 |
-| **IV. 品质关卡** | `/checkin` `/review` | 提交前检查与代码审查 |
-| **V. 发布与提交** | `/commit` `/changelog` `/release` | 版本、提交、发布 |
-| **VI. 文档** | `/docs` `/docgen` `/struct` | 文档与项目结构 |
-| **VII. 工具与标准** | `/discover` `/testing` `/guide` `/git` | 参考指南 |
+| **I. 规划与设计** | `/brainstorm` `/requirement` `/sdd` `/reverse` `/api-design` `/database` | 需求、规格、API/DB 设计 |
+| **II. 测试驱动开发** | `/bdd` `/atdd` `/tdd` `/coverage` `/derive` `/ac-coverage` | 先写测试再写代码 |
+| **III. 实现** | `/refactor` `/reverse` `/migrate` `/durable` | 撰写、改善与迁移代码 |
+| **IV. 品质关卡** | `/checkin` `/review` `/security` `/scan` `/incident` | 品质、安全、事故响应 |
+| **V. 发布与提交** | `/commit` `/changelog` `/release` `/pr` `/ci-cd` | 版本、提交、PR、CI/CD |
+| **VI. 文档** | `/docs` `/docgen` | 文档与项目结构 |
+| **VII. 工具与标准** | `/discover` `/guide` `/metrics` `/audit` | 参考指南、指标、审计 |
 | **VIII. 进阶分析** | `/methodology` | 跨方法论工作流程 |
 
 ## 常见场景
@@ -54,7 +55,7 @@ V. Release ──► VI. Documentation ──► VII. Standards ──► VIII.
 | 步骤 | 命令 | 做什么 |
 |------|------|--------|
 | 1 | `/brainstorm` | 探索想法与方法 |
-| 2 | `/requirement` | 撰写用户故事 |
+| 2 | `/requirement` | 撰写用户故事（INVEST 准则） |
 | 3 | `/sdd` | 创建规格文件 |
 | 4 | `/derive` | 从规格产生测试骨架 |
 | 5 | `/tdd` | 用红绿重构循环实现 |
@@ -94,6 +95,38 @@ V. Release ──► VI. Documentation ──► VII. Standards ──► VIII.
 | 5 | `/checkin` | 验证品质关卡 |
 | 6 | `/commit` | 创建规范化提交 |
 
+### 场景 4：安全审查
+
+安全审查与漏洞修复的推荐流程：
+
+```
+/scan → /security → /checkin → /commit
+```
+
+| 步骤 | 命令 | 做什么 |
+|------|------|--------|
+| 1 | `/scan` | 执行自动化安全扫描（依赖项、密钥） |
+| 2 | `/security` | 深入安全审查（OWASP） |
+| 3 | `/checkin` | 验证品质关卡 |
+| 4 | `/commit` | 创建规范化提交 |
+
+### 场景 5：API 设计与实现
+
+设计与实现 API 的推荐流程：
+
+```
+/brainstorm → /api-design → /sdd → /derive → /tdd → /pr
+```
+
+| 步骤 | 命令 | 做什么 |
+|------|------|--------|
+| 1 | `/brainstorm` | 探索 API 方案 |
+| 2 | `/api-design` | 设计端点与 schema |
+| 3 | `/sdd` | 创建规格文件 |
+| 4 | `/derive` | 产生测试骨架 |
+| 5 | `/tdd` | 搭配测试实现 |
+| 6 | `/pr` | 创建 Pull Request |
+
 ## 使用方式
 
 ```bash
@@ -120,6 +153,8 @@ V. Release ──► VI. Documentation ──► VII. Standards ──► VIII.
 | `new-feature` | 场景：新功能开发 |
 | `bug-fix` | 场景：修复错误 |
 | `refactoring` | 场景：重构 |
+| `security` | 场景：安全审查 |
+| `api` | 场景：API 设计 |
 
 ## 工作流程行为
 
@@ -129,17 +164,41 @@ V. Release ──► VI. Documentation ──► VII. Standards ──► VIII.
 2. **阶段参数**：显示该阶段的详细指引，包含所有相关命令与示例
 3. **场景参数**：显示该场景的推荐逐步工作流程
 
+此技能会从 [workflow-phases.md](./workflow-phases.md) 读取详细的阶段信息。
+
 ## 下一步引导
 
 `/dev-workflow` 完成后，AI 助手应根据用户情况建议：
 
 > **工作流程已显示。建议下一步：**
-> - 新功能开发 → 执行 `/brainstorm` 探索想法
+> - 新功能开发 → 执行 `/brainstorm` 探索想法 ⭐ **推荐**
 > - 修复错误 → 执行 `/discover` 评估受影响区域
 > - 重构代码 → 执行 `/discover` 评估健康度
 > - 遗留系统 → 执行 `/reverse` 进行系统考古
+> - 安全审查 → 执行 `/scan` 扫描漏洞
+> - API 开发 → 执行 `/api-design` 设计端点
+> - 事故响应 → 执行 `/incident` 启动响应流程
 
 ## 参考
 
-- [详细阶段指南](./workflow-phases.md) - 完整的阶段参考
+- [详细阶段指南](./workflow-phases.md) - 完整的逐阶段参考
 - [日常工作流程指南](../../../../adoption/DAILY-WORKFLOW-GUIDE.md) - 综合日常工作流程指南
+- [功能开发工作流程](../workflows/feature-dev.yaml) - 自动化功能开发工作流程
+- [集成流程工作流程](../workflows/integrated-flow.yaml) - 完整的 ATDD/SDD/BDD/TDD 工作流程
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.1.0 | 2026-03-24 | 新增 11 个命令、2 个新场景（安全审查、API 设计） |
+| 1.0.0 | 2026-03-04 | 初始版本：8 个开发阶段、3 个场景、基于阶段的导航 |
+
+---
+
+## 许可证
+
+本技能依 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
+
+**来源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)