universal-dev-standards 5.4.0 → 5.6.0

package/bundled/locales/zh-CN/skills/ac-coverage-assistant/SKILL.md

@@ -1,190 +0,0 @@
----
-source: ../../../../skills/ac-coverage-assistant/SKILL.md
-source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-03-26
-status: current
-description: |
-  分析验收条件（AC）与测试之间的追踪关系，产生覆盖率报告。
-  使用时机：验证 AC 覆盖率、检查测试追踪性、发布前审查。
-  关键字：AC, acceptance-criteria, coverage, traceability, 验收条件, 覆盖率。
----
-
-# AC 覆盖率助手
-
-> **语言**: [English](../../../../skills/ac-coverage-assistant/SKILL.md) | 简体中文
-
-分析验收条件（AC）与测试之间的追踪关系，并产生覆盖率报告。
-
-## 与 `/coverage` 的区别
-
-| 方面 | `/coverage` | `/ac-coverage` |
-|------|-------------|----------------|
-| **范围** | 代码级别（行/分支/函数） | 需求级别（AC 到测试） |
-| **输入** | 源代码 + 测试运行器 | SPEC 文件 + 测试标注 |
-| **问题** | "多少代码被测试了？" | "哪些 AC 有测试？" |
-| **输出** | 覆盖率百分比 | 追踪矩阵 + 差距报告 |
-
-## 工作流程
-
-1. **解析 SPEC** — 从规格文件中提取 AC 定义（AC-1、AC-2……）
-2. **扫描测试** — 使用标准链接惯例搜索测试文件中的 `@AC` 和 `@SPEC` 标注
-3. **构建矩阵** — 将每个 AC 映射到其测试引用（文件、测试名称、行号）
-4. **分类状态** — 将每个 AC 标记为 ✅ 已覆盖、⚠️ 部分覆盖 或 ❌ 未覆盖
-5. **计算覆盖率** — 套用公式：`覆盖率 % = (已覆盖 + 部分覆盖 × 0.5) / 总计 × 100`
-6. **产生报告** — 输出标准化 Markdown 报告
-
-## 标注惯例
-
-测试必须使用标准标注引用其来源 AC：
-
-```typescript
-// TypeScript/JavaScript
-describe('AC-1: 使用有效凭证登录', () => {
-  // @AC AC-1
-  // @SPEC SPEC-001
-  it('should redirect to dashboard on successful login', () => { ... });
-});
-```
-
-```python
-# Python
-class TestAC1_UserLogin:
-    """AC-1: 使用有效凭证登录
-    @AC AC-1
-    @SPEC SPEC-001
-    """
-    def test_redirect_to_dashboard(self): ...
-```
-
-```gherkin
-# BDD Feature
-@SPEC-001 @AC-1
-Scenario: 使用有效凭证登录
-```
-
-## 覆盖率门槛
-
-| 门槛 | 默认值 | 执行时机 |
-|------|--------|---------|
-| **提交** | 80% | 功能分支合并时必须达标 |
-| **发布** | 100% | 生产环境发布时必须达标 |
-| **警告** | 60% | 触发覆盖率警告 |
-
-门槛可通过 `--threshold` 参数或项目配置自定义。
-
-## 四层追溯（`--full` 模式）
-
-使用 `--full` 标记将追溯从 2 层（AC→Test）扩展为 4 层。
-
-### 追溯层次
-
-```
-第 0 层：需求 / 用户故事（REQ）
-    ↓ (定义)
-第 1 层：验收条件（AC）
-    ↓ (@AC 标注)
-第 2 层：测试用例
-    ↓ (覆盖)
-第 3 层：源代码（@implements）
-```
-
-### 各层标注惯例
-
-```typescript
-// 第 3→1 层：代码引用 AC
-// @implements AC-1, AC-2
-function authenticate(user: string, pass: string) { ... }
-```
-
-```markdown
-<!-- 第 0→1 层：SPEC 中的需求 -->
-## 需求
-### REQ-1: 用户认证
-- AC-1: 给定有效凭证，当登录时，则通过认证
-- AC-2: 给定无效凭证，当登录时，则拒绝登录
-```
-
-### 完整追溯报告
-
-```markdown
-## 四层追溯矩阵
-
-| 需求 | AC | 测试 | 代码 | 状态 |
-|------|-----|------|------|------|
-| REQ-1 | AC-1 | auth.test.ts:15 | auth.ts:42 | ✅ 完整 |
-| REQ-1 | AC-2 | auth.test.ts:30 | auth.ts:58 | ✅ 完整 |
-| REQ-2 | AC-3 | — | dashboard.ts:10 | ⚠️ 无测试 |
-| REQ-3 | AC-4 | export.test.ts:5 | — | ⚠️ 无代码 |
-
-### 差距摘要
-- 第 0→1 层：2 个需求缺少 AC
-- 第 1→2 层：1 个 AC 缺少测试
-- 第 2→3 层：0 个测试缺少代码映射
-- 第 3→1 层：3 个代码文件缺少 AC 映射
-```
-
-### 反向追溯
-
-使用 `--trace-code <path>` 从代码反向追溯到需求。
-
-```bash
-/ac-coverage --trace-code src/auth.ts
-# 输出：
-# src/auth.ts:42 → @implements AC-1 → REQ-1 (SPEC-AUTH-001)
-# src/auth.ts:58 → @implements AC-2 → REQ-1 (SPEC-AUTH-001)
-```
-
-## 报告格式
-
-产生的报告遵循 `core/acceptance-criteria-traceability.md` 的标准格式：
-
-```markdown
-# AC 覆盖率报告
-
-**规格**: SPEC-001 — 功能名称
-**产生日期**: 2026-03-26
-**覆盖率**: 75% (6/8 AC)
-
-## 摘要
-
-| 状态 | 数量 | 百分比 |
-|------|------|--------|
-| ✅ 已覆盖 | 5 | 62.5% |
-| ⚠️ 部分覆盖 | 2 | 25.0% |
-| ❌ 未覆盖 | 1 | 12.5% |
-
-## 追踪矩阵
-
-| AC-ID | 描述 | 状态 | 测试引用 |
-|-------|------|------|---------|
-| AC-1 | 使用有效凭证登录 | ✅ | auth.test.ts:15 |
-| AC-2 | 拒绝无效凭证 | ✅ | auth.test.ts:32 |
-| ...   | ...              | ... | ... |
-
-## 差距
-
-- **AC-8**: 社交登录 — 被 OAuth 沙箱阻塞
-
-## 行动项目
-
-1. [ ] AC-8: 建立 OAuth 沙箱（预计完成时间：待定）
-```
-
-## 下一步引导
-
-`/ac-coverage` 完成后，AI 助手应建议：
-
-> **AC 覆盖率分析完成。建议下一步：**
-> - 覆盖率达标 → 执行 `/checkin` 品质关卡
-> - 有未覆盖 AC → 执行 `/derive-tdd` 补齐测试 ⭐ **推荐**
-> - 有部分覆盖 AC → 检查缺少的边界情况
-> - 需要完整追溯 → 执行 `/ac-coverage --full`
-> - 反向追溯 → 执行 `/ac-coverage --trace-code <path>`
-
-## 参考
-
-- 核心规范：[acceptance-criteria-traceability.md](../../../../core/acceptance-criteria-traceability.md)
-- SPEC：[SPEC-AC-COVERAGE.md](../../../../docs/specs/skills/SPEC-AC-COVERAGE.md)
-- 相关：[test-coverage-assistant](../test-coverage-assistant/SKILL.md)（代码级别覆盖率）
-- 相关：[checkin-assistant](../checkin-assistant/SKILL.md)（品质关卡）

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

@@ -1,71 +0,0 @@
----
-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 表格
-
-## 下一步引导
-
-`/derive` 完成后，AI 助手应建议：
-
-> **测试工件已生成。建议下一步：**
-> - 执行 `/tdd` 开始红绿重构循环
-> - 执行 `/bdd` 细化 Gherkin 场景
-> - 检查生成的 `[TODO]` 标记并补齐实现
-
-## 参考
-
-- 详细指南：[guide.md](./guide.md)
-- 核心规范：[forward-derivation-standards.md](../../../../core/forward-derivation-standards.md)

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

@@ -1,130 +0,0 @@
----
-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/methodology-system/SKILL.md

@@ -1,88 +0,0 @@
----
-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"]
-  }
-}
-```
-
-## 下一步引导
-
-`/methodology` 完成后，AI 助手应根据选择的方法论建议：
-
-> **方法论已设定。建议下一步：**
-> - SDD 方法论 → 执行 `/sdd` 建立规格
-> - BDD 方法论 → 执行 `/bdd` 开始场景探索
-> - TDD 方法论 → 执行 `/tdd` 开始红绿重构
-> - ATDD 方法论 → 执行 `/atdd` 定义验收条件
-
-## 参考
-
-- 详细指南：[guide.md](./guide.md)