universal-dev-standards 4.2.0 → 5.0.0-beta.10

package/bundled/locales/zh-CN/skills/forward-derivation/SKILL.md

@@ -0,0 +1,62 @@
+---
+source: ../../../../skills/forward-derivation/SKILL.md
+source_version: 2.0.0
+translation_version: 2.0.0
+last_synced: 2026-02-10
+status: current
+description: |
+  从已批准的 SDD 规格生成衍生工件（BDD 场景、TDD 骨架、ATDD 表格）。
+  使用时机：从规格推导测试、生成 BDD/TDD/ATDD 工件。
+  关键字：derive, forward, BDD, TDD, ATDD, spec, 推演, 衍生, 规格, 场景。
+---
+
+# 正向推演
+
+> **语言**: [English](../../../../skills/forward-derivation/SKILL.md) | 简体中文
+
+从已批准的 SDD 规格生成衍生工件（BDD 场景、TDD 骨架、ATDD 表格）。
+
+## 子命令
+
+| 子命令 | 说明 | 输出 | Output |
+|--------|------|------|--------|
+| `all` | 生成 BDD + TDD（默认） | `.feature` + `.test.*` | `.feature` + `.test.*` |
+| `bdd` | 仅生成 BDD 场景 | `.feature` | `.feature` |
+| `tdd` | 仅生成 TDD 骨架 | `.test.*` | `.test.*` |
+| `atdd` | 生成 ATDD 测试表格 | `.md`（Markdown 表格） | `.md` (Markdown tables) |
+
+## 工作流程
+
+1. **读取规格** - 分析输入的 `SPEC-XXX.md` 文件
+2. **提取 AC** - 解析所有验收条件
+3. **生成工件** - 建立 BDD/TDD/ATDD 输出
+4. **验证** - 确保 AC 与生成项目之间的 1:1 对应
+
+## 防幻觉规则
+
+| 规则 | 说明 | Rule | Description |
+|------|------|------|-------------|
+| **1:1 对应** | 每个 AC 对应一个测试/场景 | 1:1 Mapping | Every AC has exactly one test/scenario |
+| **可追溯性** | 所有工件引用规格与 AC 编号 | Traceability | All artifacts reference Spec ID and AC ID |
+| **禁止捏造** | 不新增规格外的场景 | No Invention | Do not add scenarios not in the spec |
+
+## 生成工件标签
+
+| 标签 | 含义 | Tag | Meaning |
+|------|------|-----|---------|
+| `[Source]` | 直接来自规格 | Source | Direct content from spec |
+| `[Derived]` | 从来源转换 | Derived | Transformed from source |
+| `[Generated]` | AI 生成的结构 | Generated | AI-generated structure |
+| `[TODO]` | 需人工实现 | TODO | Requires human implementation |
+
+## 使用方式
+
+- `/derive all specs/SPEC-001.md` - 推演 BDD + TDD
+- `/derive bdd specs/SPEC-001.md` - 仅推演 BDD 场景
+- `/derive tdd specs/SPEC-001.md` - 仅推演 TDD 骨架
+- `/derive atdd specs/SPEC-001.md` - 推演 ATDD 表格
+
+## 参考
+
+- 详细指南：[guide.md](./guide.md)
+- 核心规范：[forward-derivation-standards.md](../../../../core/forward-derivation-standards.md)

package/bundled/locales/zh-CN/skills/forward-derivation/guide.md

@@ -0,0 +1,130 @@
+---
+scope: partial
+description: |
+  从已批准的 SDD 规格推导 BDD 场景和 TDD 测试骨架。
+  ATDD 验收测试表为可选输出，用于特殊需求。
+  使用时机：规格已批准、开始 BDD/TDD 实施、生成测试结构。
+  关键字：forward derivation, spec to test, BDD generation, TDD skeleton, test derivation, 正向推导, 规格转测试, 测试生成。
+source: ../../../../skills/forward-derivation/SKILL.md
+source_version: 2.0.0
+translation_version: 2.0.0
+last_synced: 2026-01-25
+status: current
+---
+
+# 正向推导指南
+
+> **语言**: [English](../../../../skills/forward-derivation/SKILL.md) | [繁體中文](../../../zh-TW/skills/forward-derivation/SKILL.md)
+
+**版本**: 2.0.0
+**最后更新**: 2026-01-25
+**适用范围**: Claude Code Skills
+
+> **核心标准**: 此技能实现[正向推导标准](../../../../core/forward-derivation-standards.md)。任何 AI 工具皆可参考核心标准取得完整方法论文档。
+
+---
+
+## 目的
+
+此技能引导您从已批准的 SDD 规格推导 BDD 场景和 TDD 测试骨架，并严格遵循反幻觉标准。
+
+> **注意**: ATDD 测试表为可选项，可通过 `/derive-atdd` 取得。BDD 场景本身已作为可执行验收测试，使 ATDD 表对大多数用例变得多余。
+
+正向推导是[反向工程](../reverse-engineer/SKILL.md)的对称对应：
+- **反向工程**: 代码 → 规格
+- **正向推导**: 规格 → 测试
+
+## 快速参考
+
+### 正向推导工作流程
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│              正向推导工作流程                                 │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1️⃣  SPEC 解析 (AI 自动化)                                │
+│      ├─ 读取已批准规格                                        │
+│      ├─ 提取验收标准 (GWT 或项目)                             │
+│      └─ 验证 SPEC 结构和完整性                              │
+│                                                                 │
+│  2️⃣  推导 (AI 自动化)                                      │
+│      ├─ AC → BDD Gherkin 场景                                │
+│      ├─ AC → 带 TODO 的 TDD 测试骨架                           │
+│      └─ (可选) AC → ATDD 验收测试表                           │
+│                                                                 │
+│  3️⃣  人工审查 (必需)                                        │
+│      ├─ 验证生成的场景匹配 AC 意图                           │
+│      ├─ 填写 [TODO] 部分                                     │
+│      └─ 如需要，完善步骤定义                                   │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### 命令概述
+
+| 命令 | 输入 | 输出 | 目的 |
+|------|------|------|------|
+| `/derive-bdd` | SPEC-XXX.md | .feature | AC → Gherkin 场景 |
+| `/derive-tdd` | SPEC-XXX.md | .test.ts | AC → 测试骨架 |
+| `/derive-all` | SPEC-XXX.md | .feature + .test.ts | 完整推导流水线 |
+| `/derive-atdd` | SPEC-XXX.md | acceptance.md | AC → 验收测试表 (可选) |
+
+---
+
+## 核心原则
+
+### 1. 规格边界生成
+
+**关键**: 仅推导规格中存在的内容。绝不要添加超出验收标准明确定义的场景、测试或功能。
+
+```
+# 反幻觉规则
+输入:  带有 N 个验收标准的 SPEC
+输出:  正好 N 个场景 (BDD)
+        正好 N 个测试组 (TDD)
+        正好 N 个验收测试 (ATDD，如请求)
+
+如果输出数量 ≠ 输入数量 → 违规
+```
+
+### 2. 来源归属
+
+每个生成项必须包含可追溯性：
+
+```gherkin
+# 生成自: specs/SPEC-001.md
+# AC: AC-1
+
+@SPEC-001 @AC-1
+Scenario: 使用有效凭据的用户登录
+```
+
+### 3. 推导标签（来自统一标签系统）
+
+此技能使用**推导标签**从规格生成新内容。有关完整标签参考，请参见[反幻觉标准](../../../../core/anti-hallucination.md#certainty-classification-tags)。
+
+| 标签 | 使用时机 | 示例 |
+|-----|----------|------|
+| `[来源]` | 直接来自 SPEC 的内容 | 功能标题，AC 文本 |
+| `[推导]` | 从 SPEC 内容转换 | 从项目 AC 转换的 GWT |
+| `[生成]` | AI 生成结构 | 测试骨架 |
+| `[TODO]` | 需要人工实施 | 断言，步骤定义 |
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 2.0.0 | 2026-01-25 | ATDD 从必需改为可选输出；/derive-all 现在只输出 BDD + TDD |
+| 1.1.0 | 2026-01-25 | 新增：统一标签系统引用 |
+| 1.0.0 | 2026-01-19 | 初始发布 |
+
+---
+
+## 许可证
+
+此技能根据 [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/git-workflow-guide → git-workflow-guide}/SKILL.md

@@ -1,10 +1,10 @@
 ---
-source: /skills/claude-code/git-workflow-guide/SKILL.md
+source: ../../../../skills/git-workflow-guide/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-25
 status: current
-name: git-workflow-guide
+name: git-flow
 description: |
   指導 Git 分支策略、分支命名与合併操作。
   使用时机：建立分支、合併、Pull Request、Git 工作流程問題。
@@ -13,7 +13,7 @@ description: |
 
 # Git 工作流程指南
 
-> **语言**: [English](../../../../../skills/claude-code/git-workflow-guide/SKILL.md) | 简体中文
+> **语言**: [English](../../../../skills/git-workflow-guide/SKILL.md) | 简体中文
 
 **版本**: 1.0.0
 **最後更新**: 2025-12-24
@@ -197,9 +197,9 @@ git push origin feature/my-feature
 
 ## 相关标准
 
-- [Git 工作流程](../../core/git-workflow.md)
-- [提交消息指南](../../core/commit-message-guide.md)
-- [簽入标准](../../core/checkin-standards.md)
+- [Git 工作流程](../../../../core/git-workflow.md)
+- [提交消息指南](../../../../core/commit-message-guide.md)
+- [簽入标准](../../../../core/checkin-standards.md)
 
 ---
 

package/bundled/locales/zh-CN/skills/{claude-code/git-workflow-guide → git-workflow-guide}/branch-naming.md

@@ -1,5 +1,5 @@
 ---
-source: skills/claude-code/git-workflow-guide/branch-naming.md
+source: ../../../../skills/git-workflow-guide/branch-naming.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-25
@@ -8,7 +8,7 @@ status: current
 
 # 分支命名參考
 
-> **语言**: [English](../../../../../skills/claude-code/git-workflow-guide/branch-naming.md) | 简体中文
+> **语言**: [English](../../../../skills/git-workflow-guide/branch-naming.md) | 简体中文
 
 **版本**: 1.0.0
 **最後更新**: 2025-12-24
@@ -201,7 +201,7 @@ git branch --show-current
 ## 相关标准
 
 - [Git 工作流程策略](./git-workflow.md)
-- [Git 工作流程](../../../../../core/git-workflow.md)
+- [Git 工作流程](../../../../core/git-workflow.md)
 
 ---
 

package/bundled/locales/zh-CN/skills/{claude-code/git-workflow-guide → git-workflow-guide}/git-workflow.md

@@ -1,5 +1,5 @@
 ---
-source: ../../../../../skills/claude-code/git-workflow-guide/git-workflow.md
+source: ../../../../skills/git-workflow-guide/git-workflow.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-25
@@ -8,7 +8,7 @@ status: current
 
 # Git 工作流程策略
 
-> **语言**: [English](../../../../../skills/claude-code/git-workflow-guide/git-workflow.md) | 简体中文
+> **语言**: [English](../../../../skills/git-workflow-guide/git-workflow.md) | 简体中文
 
 **版本**: 1.0.0
 **最後更新**: 2025-12-24
@@ -300,9 +300,9 @@ git merge --ff-only feature/user-auth
 
 ## 相关标准
 
-- [Git Workflow](../../../../../core/git-workflow.md)
+- [Git Workflow](../../../../core/git-workflow.md)
 - [分支命名參考](./branch-naming.md)
-- [Commit 消息指南](../../../../../core/commit-message-guide.md)
+- [Commit 消息指南](../../../../core/commit-message-guide.md)
 
 ---
 

package/bundled/locales/zh-CN/skills/{claude-code/logging-guide → logging-guide}/SKILL.md

@@ -1,10 +1,10 @@
 ---
-name: logging-guide
+name: logging
 description: |
   实作结构化日誌，包含正确的日誌层级和敏感数据处理。
   使用时机：新增日誌、除錯、设置可觀测性。
   关鍵字：logging, log level, structured logging, observability, 日誌, 记录, 结构化日誌。
-source: ../../../../../skills/claude-code/logging-guide/SKILL.md
+source: ../../../../skills/logging-guide/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-08
@@ -13,7 +13,7 @@ status: current
 
 # 日誌指南
 
-> **语言**: [English](../../../../../skills/claude-code/logging-guide/SKILL.md) | 简体中文
+> **语言**: [English](../../../../skills/logging-guide/SKILL.md) | 简体中文
 
 **版本**: 1.0.0
 **最後更新**: 2025-12-30
@@ -108,7 +108,7 @@ status: current
 ## 详细指南
 
 完整标准請參考：
-- [日誌标准](../../../core/logging-standards.md)
+- [日誌标准](../../../../core/logging-standards.md)
 
 ### AI 優化格式（节省 Token）
 
@@ -265,8 +265,8 @@ logger.error('处理订单失败', {
 
 ## 相关标准
 
-- [日誌标准](../../../core/logging-standards.md)
-- [错误码标准](../../../core/error-code-standards.md)
+- [日誌标准](../../../../core/logging-standards.md)
+- [错误码标准](../../../../core/error-code-standards.md)
 
 ---
 

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

@@ -0,0 +1,78 @@
+---
+source: ../../../../skills/methodology-system/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-02-10
+status: current
+description: |
+  管理当前项目的开发方法论，支持 SDD 和双循环 TDD 两个独立系统。
+  使用时机：切换方法论、查看当前阶段、管理开发流程。
+  关键字：methodology, SDD, TDD, BDD, ATDD, 方法论, 开发流程。
+---
+
+# 方法论系统
+
+> **语言**: [English](../../../../skills/methodology-system/SKILL.md) | 简体中文
+
+> [!WARNING]
+> **实验性功能**
+>
+> 此功能正在积极开发中，可能在 v4.0 中有重大变更。
+
+管理当前项目的开发方法论，支持两个独立系统。
+
+**两个独立系统：**
+- **系统 A：SDD** - 规格驱动开发（AI 时代、规格优先）
+- **系统 B：双循环 TDD** - BDD（外部循环）+ TDD（内部循环）（传统）
+
+**可选输入：** ATDD - 验收测试驱动开发（可作为任一系统的输入）
+
+## 动作
+
+| 动作 | 说明 |
+|------|------|
+| *(无)* / `status` | 显示当前阶段和检查清单 |
+| `switch <id>` | 切换到不同方法论 |
+| `phase [name]` | 显示或变更当前阶段 |
+| `checklist` | 显示当前阶段检查清单 |
+| `skip` | 跳过当前阶段（会有警告） |
+| `list` | 列出可用方法论 |
+| `create` | 建立自定方法论 |
+
+## 可用方法论
+
+| 系统 | ID | 工作流程 |
+|------|-----|---------|
+| A：SDD | `sdd` | /sdd -> 审查 -> /derive-all -> 实现 |
+| B：BDD | `bdd` | 探索 -> 制定 -> 自动化 |
+| B：TDD | `tdd` | 红 -> 绿 -> 重构 |
+| 输入 | `atdd` | 工作坊 -> 示例 -> 测试 |
+
+## 使用示例
+
+```
+/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"]
+  }
+}
+```
+
+## 参考
+
+- 详细指南：[guide.md](./guide.md)

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

@@ -1,5 +1,5 @@
 ---
-source: ../../../../../skills/claude-code/methodology-system/create-methodology.md
+source: ../../../../skills/methodology-system/create-methodology.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-12
@@ -8,7 +8,7 @@ status: experimental
 
 # 建立自订方法論指南
 
-> **Language**: [English](../../../../../skills/claude-code/methodology-system/create-methodology.md) | 简体中文
+> **Language**: [English](../../../../skills/methodology-system/create-methodology.md) | 简体中文
 
 > [!WARNING]
 > **实驗性功能 / Experimental Feature**

package/bundled/locales/zh-CN/skills/{claude-code/methodology-system/SKILL.md → methodology-system/guide.md}

@@ -1,5 +1,5 @@
 ---
-source: ../../../../../skills/claude-code/methodology-system/SKILL.md
+source: ../../../../skills/methodology-system/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-12
@@ -8,7 +8,7 @@ status: experimental
 
 # 方法論系统 Skill
 
-> **Language**: [English](../../../../../skills/claude-code/methodology-system/SKILL.md) | 简体中文
+> **Language**: [English](../../../../skills/methodology-system/SKILL.md) | 简体中文
 
 > [!WARNING]
 > **实驗性功能 / Experimental Feature**

package/bundled/locales/zh-CN/skills/{claude-code/methodology-system → methodology-system}/runtime.md

@@ -1,5 +1,5 @@
 ---
-source: ../../../../../skills/claude-code/methodology-system/runtime.md
+source: ../../../../skills/methodology-system/runtime.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-12
@@ -8,7 +8,7 @@ status: experimental
 
 # 方法論执行时引導
 
-> **Language**: [English](../../../../../skills/claude-code/methodology-system/runtime.md) | 简体中文
+> **Language**: [English](../../../../skills/methodology-system/runtime.md) | 简体中文
 
 > [!WARNING]
 > **实驗性功能 / Experimental Feature**
@@ -161,7 +161,7 @@ AI 应從以下來源偵测方法論上下文：
    - 「为这个变更建立規格」
 
 3. **命令調用**
-   - `/tdd`、`/bdd`、`/spec`、`/atdd`
+   - `/tdd`、`/bdd`、`/sdd`、`/atdd`
    - `/methodology switch <id>`
 
 ### 载入方法論定義

package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md

@@ -0,0 +1,66 @@
+---
+source: ../../../../skills/project-discovery/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-02-10
+status: current
+description: |
+  在既有代码库新增功能前的 Phase 0 评估，评估项目健康度、架构与风险。
+  使用时机：新增功能前、项目健康度检查、风险评估。
+  关键字：discover, assessment, health, risk, 评估, 健康度, 风险, 架构。
+---
+
+# 项目现况评估
+
+> **语言**: [English](../../../../skills/project-discovery/SKILL.md) | 简体中文
+
+在既有代码库新增功能前的 Phase 0 评估。评估项目健康度、架构与风险。
+
+## 评估维度
+
+| 维度 | 检查项目 |
+|------|----------|
+| **架构** | 模块结构、依赖图、入口点 |
+| **依赖套件** | 过时套件、已知漏洞、授权风险 |
+| **测试覆盖率** | 现有测试、覆盖率缺口、测试质量 |
+| **安全性** | `npm audit` 结果、硬编码密钥、暴露端点 |
+| **技术债** | TODO 标记、代码重复、复杂度热点 |
+
+## 工作流程
+
+1. **扫描项目** - 读取 package.json、目录结构、配置文件
+2. **分析架构** - 绘制模块、依赖性和数据流图
+3. **检查依赖套件** - 执行 `npm outdated`、`npm audit` 获取健康信号
+4. **评估风险** - 识别复杂度热点、缺失测试、安全问题
+5. **生成报告** - 输出健康分数与可执行的建议
+
+## 输出格式
+
+```
+项目健康报告
+=====================
+总分：7.2 / 10
+
+| 维度           | 分数  | 状态    | 主要发现                |
+|----------------|-------|---------|------------------------|
+| 架构           | 8/10  | 良好    | 模块边界清晰            |
+| 依赖套件       | 6/10  | 警告    | 5 个过时、1 个重大问题   |
+| 测试覆盖率     | 7/10  | 尚可    | 72% 行覆盖率            |
+| 安全性         | 8/10  | 良好    | 无重大漏洞              |
+| 技术债         | 6/10  | 警告    | 23 个 TODO、3 个热点    |
+
+建议：
+1. [高] 更新 lodash 以修复 CVE-2024-XXXX
+2. [中] 为 src/payments/ 新增测试（0% 覆盖率）
+3. [低] 解决 src/utils/ 中的 TODO 积压
+```
+
+## 使用方式
+
+- `/discover` - 完整项目健康度评估
+- `/discover auth` - 针对 auth 相关模块进行评估
+- `/discover payments` - 在新增支付功能前评估风险
+
+## 参考
+
+- 详细指南：[guide.md](./guide.md)