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

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

@@ -1,5 +1,5 @@
 ---
-source: ../../../../../skills/claude-code/tdd-assistant/tdd-workflow.md
+source: ../../../../skills/tdd-assistant/tdd-workflow.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-07
@@ -8,7 +8,7 @@ status: current
 
 # TDD 工作流程指南
 
-> **语言**: [English](../../../../../skills/claude-code/tdd-assistant/tdd-workflow.md) | 简体中文
+> **语言**: [English](../../../../skills/tdd-assistant/tdd-workflow.md) | 简体中文
 
 **版本**: 1.0.0
 **最後更新**: 2026-01-07
@@ -483,4 +483,4 @@ stages:
 
 - [SKILL.md](./SKILL.md) - TDD 助手概覽
 - [语言範例](./language-examples.md) - 语言特定 TDD
-- [TDD 核心标准](../../../../../core/test-driven-development.md) - 完整 TDD 标准
+- [TDD 核心标准](../../../../core/test-driven-development.md) - 完整 TDD 标准

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

@@ -0,0 +1,65 @@
+---
+source: ../../../../skills/test-coverage-assistant/SKILL.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-02-10
+status: current
+description: |
+  多维度分析测试覆盖率并提供可执行的建议。
+  使用时机：分析覆盖率、识别测试缺口、制定测试策略。
+  关键字：coverage, test, analysis, dimension, 覆盖率, 测试, 分析, 维度。
+---
+
+# 测试覆盖率助手
+
+> **语言**: [English](../../../../skills/test-coverage-assistant/SKILL.md) | 简体中文
+
+多维度分析测试覆盖率并提供可执行的建议。
+
+## 覆盖率维度
+
+| 维度 | 测量内容 | Dimension | What it Measures |
+|------|----------|-----------|------------------|
+| **行覆盖率** | 执行的代码行数 | Line | Lines of code executed |
+| **分支覆盖率** | 决策路径覆盖 | Branch | Decision paths taken |
+| **函数覆盖率** | 调用的函数 | Function | Functions called |
+| **语句覆盖率** | 执行的语句 | Statement | Statements executed |
+
+## 八维度框架
+
+1. **代码覆盖率** - 行、分支、函数
+2. **需求覆盖率** - 所有需求都有对应测试
+3. **风险覆盖率** - 高风险区域优先测试
+4. **集成覆盖率** - 组件交互路径
+5. **边界案例覆盖率** - 边界条件测试
+6. **错误覆盖率** - 错误处理路径验证
+7. **权限覆盖率** - 访问控制场景
+8. **AI 生成质量** - AI 生成测试的有效性
+
+## 覆盖率目标
+
+| 等级 | 覆盖率 | 适用场景 | Use Case |
+|------|--------|----------|----------|
+| 最低要求 | 60% | 遗留代码 | Legacy code |
+| 标准 | 80% | 大多数项目 | Most projects |
+| 高标准 | 90% | 关键系统 | Critical systems |
+| 严格 | 95%+ | 安全关键 | Safety-critical |
+
+## 工作流程
+
+1. **执行覆盖率工具** - 生成覆盖率报告
+2. **分析缺口** - 识别未测试的区域
+3. **排定优先顺序** - 按风险和重要性排序
+4. **建议测试** - 提出具体的测试建议
+5. **追踪进度** - 持续监控覆盖率变化
+
+## 使用方式
+
+- `/coverage` - 执行完整覆盖率分析
+- `/coverage src/auth` - 分析特定模块
+- `/coverage --recommend` - 获取测试建议
+
+## 参考
+
+- 详细指南：[guide.md](./guide.md)
+- 核心规范：[test-completeness-dimensions.md](../../../../core/test-completeness-dimensions.md)

package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md

@@ -0,0 +1,284 @@
+---
+description: |
+  使用 8 维度框架评估测试完整性。
+  使用时机：撰写测试、审查测试覆盖率、确保测试品质。
+  关键字：test coverage, completeness, dimensions, 8 dimensions, test quality, 测试覆盖, 测试完整性, 八维度。
+source: ../../../../skills/test-coverage-assistant/SKILL.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-25
+status: current
+---
+
+# 测试覆盖助手
+
+> **语言**: [English](../../../../skills/test-coverage-assistant/SKILL.md) | 简体中文
+
+**版本**: 1.1.0
+**最后更新**: 2026-01-25
+**适用范围**: Claude Code Skills
+
+---
+
+## 目的
+
+此技能使用 8 维度框架帮助评估和改善测试完整性，确保每个功能都有全面的测试覆盖。
+
+## 快速参考
+
+### 8 个维度
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│              测试完整性 = 8 个维度                            │
+├─────────────────────────────────────────────────────────────┤
+│  1. 正常路径        正常预期行为                              │
+│  2. 边界条件        最小/最大值、限制                         │
+│  3. 错误处理        无效输入、例外状况                        │
+│  4. 授权验证        角色存取控制                              │
+│  5. 状态变更        前后状态验证                              │
+│  6. 验证逻辑        格式、商业规则                            │
+│  7. 集成测试        真实查询验证                              │
+│  8. AI 生成质量     AI 生成测试的质量 (新增)                  │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 维度摘要表
+
+| # | 维度 | 测试内容 | 关键问题 |
+|---|------|----------|----------|
+| 1 | **正常路径** | 有效输入 → 预期输出 | 正常流程是否运作？ |
+| 2 | **边界条件** | 最小/最大值、限制 | 边界情况会发生什么？ |
+| 3 | **错误处理** | 无效输入、找不到数据 | 错误如何处理？ |
+| 4 | **授权验证** | 角色权限 | 谁可以做什么？ |
+| 5 | **状态变更** | 前后状态 | 状态是否正确变更？ |
+| 6 | **验证逻辑** | 格式、商业规则 | 输入是否有验证？ |
+| 7 | **集成测试** | 真实 DB/API 调用 | 查询真的有效吗？ |
+| 8 | **AI 生成质量** | AI 生成测试的质量 | AI 测试是否有意义？ |
+
+### 各功能类型需要的维度
+
+| 功能类型 | 需要的维度 |
+|----------|------------|
+| CRUD API | 1, 2, 3, 4, 6, 7, 8* |
+| 查询/搜索 | 1, 2, 3, 4, 7, 8* |
+| 状态机 | 1, 3, 4, 5, 6, 8* |
+| 验证逻辑 | 1, 2, 3, 6, 8* |
+| 后台作业 | 1, 3, 5, 8* |
+| 外部集成 | 1, 3, 7, 8* |
+
+## 测试设计检查清单
+
+为每个功能使用此检查清单：
+
+```
+功能：___________________
+
+□ 正常路径
+  □ 有效输入产生预期成功
+  □ 正确的数据被回传/建立
+  □ 预期的副作用发生
+
+□ 边界条件
+  □ 最小有效值
+  □ 最大有效值
+  □ 空集合
+  □ 单一项目集合
+  □ 大型集合（如适用）
+
+□ 错误处理
+  □ 无效输入格式
+  □ 缺少必要字段
+  □ 重复/冲突情况
+  □ 找不到数据情况
+  □ 外部服务失败（如适用）
+
+□ 授权验证
+  □ 每个允许的角色已测试
+  □ 每个拒绝的角色已测试
+  □ 未认证存取已测试
+  □ 跨边界存取已测试
+
+□ 状态变更
+  □ 初始状态已验证
+  □ 最终状态已验证
+  □ 所有有效的状态转换已测试
+
+□ 验证逻辑
+  □ 格式验证（电子邮件、电话等）
+  □ 商业规则验证
+  □ 跨字段验证
+
+□ 集成测试（如 UT 使用通配符）
+  □ 查询谓词已验证
+  □ 实体关联已验证
+  □ 分页已验证
+  □ 排序/过滤已验证
+```
+
+## 详细指南
+
+完整标准请参考：
+- [测试完整性维度](../../../../core/test-completeness-dimensions.md)
+- [测试标准](../../../../core/testing-standards.md)
+
+### AI 优化格式（节省 Token）
+
+AI 助手可使用 YAML 格式文件以减少 Token 使用量：
+- 基础标准：`ai/standards/test-completeness-dimensions.ai.yaml`
+
+## 示例
+
+### 1. 正常路径
+
+```csharp
+[Fact]
+public async Task CreateUser_WithValidData_ReturnsSuccess()
+{
+    // Arrange
+    var request = new CreateUserRequest
+    {
+        Username = "newuser",
+        Email = "user@example.com"
+    };
+
+    // Act
+    var result = await _service.CreateUserAsync(request);
+
+    // Assert
+    result.Success.Should().BeTrue();
+    result.Data.Username.Should().Be("newuser");
+}
+```
+
+### 2. 边界条件
+
+```csharp
+[Theory]
+[InlineData(0, false)]      // 低于最小值
+[InlineData(1, true)]       // 最小有效值
+[InlineData(100, true)]     // 最大有效值
+[InlineData(101, false)]    // 高于最大值
+public void ValidateQuantity_BoundaryValues_ReturnsExpected(
+    int quantity, bool expected)
+{
+    var result = _validator.IsValidQuantity(quantity);
+    result.Should().Be(expected);
+}
+```
+
+### 4. 授权验证
+
+```csharp
+[Fact]
+public async Task DeleteUser_AsAdmin_Succeeds()
+{
+    var adminContext = CreateContext(role: "Admin");
+    var result = await _service.DeleteUserAsync(userId, adminContext);
+    result.Success.Should().BeTrue();
+}
+
+[Fact]
+public async Task DeleteUser_AsMember_ReturnsForbidden()
+{
+    var memberContext = CreateContext(role: "Member");
+    var result = await _service.DeleteUserAsync(userId, memberContext);
+    result.ErrorCode.Should().Be("FORBIDDEN");
+}
+```
+
+### 5. 状态变更
+
+```csharp
+[Fact]
+public async Task DisableUser_UpdatesStateCorrectly()
+{
+    // Arrange
+    var user = await CreateEnabledUser();
+    user.IsEnabled.Should().BeTrue();  // 验证初始状态
+
+    // Act
+    await _service.DisableUserAsync(user.Id);
+
+    // Assert
+    var updatedUser = await _repository.GetByIdAsync(user.Id);
+    updatedUser.IsEnabled.Should().BeFalse();  // 验证最终状态
+}
+```
+
+## 授权矩阵模板
+
+为每个功能建立矩阵：
+
+| 操作 | 管理员 | 经理 | 成员 | 访客 |
+|------|--------|------|------|------|
+| 建立 | ✅ | ✅ | ❌ | ❌ |
+| 读取全部 | ✅ | ⚠️ 范围限制 | ❌ | ❌ |
+| 更新 | ✅ | ⚠️ 仅自己部门 | ❌ | ❌ |
+| 删除 | ✅ | ❌ | ❌ | ❌ |
+
+每个格子都应该有对应的测试案例。
+
+## 要避免的反模式
+
+- ❌ 只测试正常路径
+- ❌ 多角色系统缺少授权测试
+- ❌ 没有验证状态变更
+- ❌ 单元测试使用通配符但没有对应的集成测试
+- ❌ 测试数据中 ID 和业务标识码使用相同值
+- ❌ 测试实现细节而非行为
+
+---
+
+## 设置检测
+
+此技能支持项目特定设置。
+
+### 检测顺序
+
+1. 检查 `CONTRIBUTING.md` 中的「测试标准」部分
+2. 检查代码库中现有的测试模式
+3. 如未找到，**默认使用全部 8 个维度**
+
+### 首次设置
+
+如未找到设置：
+
+1. 建议：「此项目尚未设置测试完整性要求。您要自定需要哪些维度吗？」
+2. 建议在 `CONTRIBUTING.md` 中记录：
+
+```markdown
+## 测试完整性
+
+我们使用 8 维度框架来确保测试覆盖。
+
+### 各功能类型需要的维度
+- API 端点：全部 8 个维度
+- 工具函式：维度 1, 2, 3, 6
+- 背景作业：维度 1, 3, 5
+```
+
+---
+
+## 相关标准
+
+- [测试完整性维度](../../../../core/test-completeness-dimensions.md)
+- [测试标准](../../../../core/testing-standards.md)
+- [测试指南](../testing-guide/SKILL.md)
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.1.0 | 2026-01-25 | 新增第 8 维度：AI 生成质量 |
+| 1.0.0 | 2025-12-30 | 初始发布 |
+
+---
+
+## 授权
+
+此技能采用 [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/testing-guide → testing-guide}/SKILL.md

@@ -1,10 +1,10 @@
 ---
-source: skills/claude-code/testing-guide/SKILL.md
-source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2025-12-29
+source: ../../../../skills/testing-guide/SKILL.md
+source_version: 1.2.0
+translation_version: 1.2.0
+last_synced: 2026-02-10
 status: current
-name: testing-guide
+name: testing
 description: |
   Testing pyramid and test writing standards for UT/IT/ST/E2E.
   Supports ISTQB and Industry Pyramid frameworks.
@@ -14,7 +14,7 @@ description: |
 
 # 测试指南
 
-> **语言**: [English](../../../../../skills/claude-code/testing-guide/SKILL.md) | 简体中文
+> **语言**: [English](../../../../skills/testing-guide/SKILL.md) | 简体中文
 
 **版本**: 1.1.0
 **最後更新**: 2025-12-29
@@ -213,8 +213,8 @@ test('method_scenario_expected', () => {
 
 ## 相关标准
 
-- [测试标准](../../core/testing-standards.md)
-- [程序码审查检查清单](../../core/code-review-checklist.md)
+- [测试标准](../../../../core/testing-standards.md)
+- [程序码审查检查清单](../../../../core/code-review-checklist.md)
 
 ---
 

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

@@ -1,5 +1,5 @@
 ---
-source: ../../../../../skills/claude-code/testing-guide/testing-pyramid.md
+source: ../../../../skills/testing-guide/testing-pyramid.md
 source_version: 1.1.0
 translation_version: 1.1.0
 last_synced: 2025-12-30
@@ -8,7 +8,7 @@ status: current
 
 # 测试金字塔指南
 
-> **语言**: [English](../../../../../skills/claude-code/testing-guide/testing-pyramid.md) | 简体中文
+> **语言**: [English](../../../../skills/testing-guide/testing-pyramid.md) | 简体中文
 
 **版本**: 1.1.0
 **最後更新**: 2025-12-29
@@ -427,8 +427,8 @@ const inactiveUser = new UserBuilder().inactive().build();
 
 ## 相关标准
 
-- [测试标准](../../../core/testing-standards.md)
-- [程序码审查检查清单](../../../core/code-review-checklist.md)
+- [测试标准](../../../../core/testing-standards.md)
+- [程序码审查检查清单](../../../../core/code-review-checklist.md)
 
 ---
 

package/bundled/locales/zh-CN/skills/{cline → tools/cline}/README.md

@@ -1,5 +1,5 @@
 ---
-source: ../../../../skills/cline/README.md
+source: ../../../../../skills/tools/cline/README.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-30

package/bundled/locales/zh-CN/skills/{copilot → tools/copilot}/README.md

@@ -1,5 +1,5 @@
 ---
-source: ../../../../skills/copilot/README.md
+source: ../../../../../skills/tools/copilot/README.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-30

package/bundled/locales/zh-CN/skills/{copilot → tools/copilot}/copilot-instructions.md

@@ -1,5 +1,5 @@
 ---
-source: ../../../../skills/copilot/copilot-instructions.md
+source: ../../../../../skills/tools/copilot/copilot-instructions.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-30

package/bundled/locales/zh-CN/skills/{cursor → tools/cursor}/README.md

@@ -1,5 +1,5 @@
 ---
-source: ../../../../skills/cursor/README.md
+source: ../../../../../skills/tools/cursor/README.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-30

package/bundled/locales/zh-CN/skills/{windsurf → tools/windsurf}/README.md

@@ -1,5 +1,5 @@
 ---
-source: ../../../../skills/windsurf/README.md
+source: ../../../../../skills/tools/windsurf/README.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-30

package/bundled/locales/zh-TW/CHANGELOG.md

@@ -69,11 +69,11 @@ status: current
 ### 修復
 - **i18n**：為 6 個翻譯檔案新增缺失的 YAML front matter
   - `docs/CLI-INIT-OPTIONS.md`
-  - `skills/claude-code/commands/bdd.md`
-  - `skills/claude-code/commands/methodology.md`
-  - `skills/claude-code/methodology-system/SKILL.md`
-  - `skills/claude-code/methodology-system/create-methodology.md`
-  - `skills/claude-code/methodology-system/runtime.md`
+  - `skills/commands/bdd.md`
+  - `skills/commands/methodology.md`
+  - `skills/methodology-system/SKILL.md`
+  - `skills/methodology-system/create-methodology.md`
+  - `skills/methodology-system/runtime.md`
 - **文件**：更新穩定版本參考從 3.3.0 至 3.4.2
 
 ## [3.5.0-beta.10] - 2026-01-12
@@ -385,9 +385,9 @@ status: current
   - ML 測試邊界（模型準確度 vs 資料工程）
   - 遺留系統的 Golden Master 測試
 - **Skills**：為 Claude Code 新增 `tdd-assistant` 技能（第 15 個技能）
-  - `skills/claude-code/tdd-assistant/SKILL.md` - TDD 工作流程指引
-  - `skills/claude-code/tdd-assistant/tdd-workflow.md` - 逐步 TDD 流程
-  - `skills/claude-code/tdd-assistant/language-examples.md` - 6 種語言範例
+  - `skills/tdd-assistant/SKILL.md` - TDD 工作流程指引
+  - `skills/tdd-assistant/tdd-workflow.md` - 逐步 TDD 流程
+  - `skills/tdd-assistant/language-examples.md` - 6 種語言範例
   - 所有 TDD 檔案的完整繁體中文翻譯
 
 ### 變更
@@ -440,7 +440,7 @@ status: current
 
 ### 新增
 - **Skills**：新增發布流程指南，提供完整的發布流程
-  - 新增 `skills/claude-code/release-standards/release-workflow.md` 包含逐步發布指示
+  - 新增 `skills/release-standards/release-workflow.md` 包含逐步發布指示
   - 涵蓋 beta、alpha、rc 和穩定版發布工作流程
   - 包含 npm dist-tag 策略、疑難排解和 AI 助理指南
   - 在 CLAUDE.md 中新增發布流程章節供 AI 助理參考
@@ -495,7 +495,7 @@ status: current
   - 新增 `.claude-plugin/plugin.json` - Plugin manifest 配置
   - 新增 `.claude-plugin/marketplace.json` - Marketplace 分發配置
   - 新增 `.claude-plugin/README.md` - Plugin 文檔和維護指南
-  - 更新 `skills/claude-code/README.md` 新增方法 1：Marketplace 安裝（推薦）
+  - 更新 `skills/README.md` 新增方法 1：Marketplace 安裝（推薦）
 
 ### 優點
 - 使用者可以用單一指令安裝所有 14 個技能：`/plugin install universal-dev-standards@universal-dev-standards`
@@ -521,7 +521,7 @@ status: current
 - **完整 Windows 支援**：為 Windows 使用者提供完整的跨平台相容性
   - 新增 `.gitattributes` 確保跨平台換行符一致性
   - 新增 `scripts/check-translation-sync.ps1` - 翻譯檢查器 PowerShell 版本
-  - 新增 `skills/claude-code/install.ps1` - Skills 安裝器 PowerShell 版本
+  - 新增 `skills/install.ps1` - Skills 安裝器 PowerShell 版本
   - 新增 `scripts/setup-husky.js` - 跨平台 Husky 設定腳本
   - 新增 `docs/WINDOWS-GUIDE.md` - 完整的 Windows 開發指南
 - **5 個新 Claude Code 技能**：技能庫從 9 個擴充至 14 個
@@ -576,7 +576,7 @@ status: current
 - **多語言支援**：新增 `locales/` 目錄結構用於國際化
 - 新增所有文件的繁體中文 (zh-TW) 翻譯（44 個檔案）
   - `locales/zh-TW/core/` - 13 個核心規範翻譯
-  - `locales/zh-TW/skills/claude-code/` - 25 個 skill 檔案翻譯
+  - `locales/zh-TW/skills/` - 25 個 skill 檔案翻譯
   - `locales/zh-TW/adoption/` - 5 個採用指南翻譯
   - `locales/zh-TW/README.md` - 完整的中文 README
 - 為所有英文文件新增語言切換器
@@ -588,7 +588,7 @@ status: current
 ### 變更
 - 將雙語內容分離到專用語言檔案（AI 工具減少約 50% token 消耗）
 - 英文版本現在僅包含英文內容並帶有語言切換器
-- 更新 `skills/claude-code/README.md` - 新增靜態與動態區塊及觸發關鍵字
+- 更新 `skills/README.md` - 新增靜態與動態區塊及觸發關鍵字
 
 ## [2.2.0] - 2025-12-24
 
@@ -605,17 +605,17 @@ status: current
 
 ### 新增
 - **整合 Skills**：將 `universal-dev-skills` 合併至 `skills/` 目錄
-- 新增 `skills/claude-code/` - 所有 Claude Code Skills 現已包含在主儲存庫中
+- 新增 `skills/` - 所有 Claude Code Skills 現已包含在主儲存庫中
 - 新增 `skills/_shared/` - 用於多 AI 工具支援的共享模板
 - 為未來 AI 工具新增佔位目錄：`skills/cursor/`、`skills/windsurf/`、`skills/cline/`、`skills/copilot/`
 
 ### 變更
-- CLI 現在從本地 `skills/claude-code/` 安裝技能，而非從遠端儲存庫獲取
+- CLI 現在從本地 `skills/` 安裝技能，而非從遠端儲存庫獲取
 - 更新 `standards-registry.json` 以反映整合的 skills 架構
 
 ### 遷移指南
 - 如果您之前單獨使用 `universal-dev-skills`，現在可以使用本儲存庫中包含的 skills
-- 執行 `cd skills/claude-code && ./install.sh` 從整合位置重新安裝 skills
+- 執行 `cd skills && ./install.sh` 從整合位置重新安裝 skills
 
 ## [2.0.0] - 2025-12-24
 

package/bundled/locales/zh-TW/CLAUDE.md

@@ -14,7 +14,7 @@ status: current
 
 Universal Development Standards 是一個語言無關、框架無關的文件化標準框架。它提供：
 
-- **核心規範** (`core/`)：22 個基礎開發標準
+- **核心規範** (`core/`)：32 個基礎開發標準
 - **AI 技能** (`skills/`)：用於 AI 輔助開發的 Claude Code 技能
 - **CLI 工具** (`cli/`)：用於採用標準的 Node.js CLI
 - **整合** (`integrations/`)：各種 AI 工具的配置
@@ -200,9 +200,9 @@ node cli\bin\uds.js init --help
 
 ```
 universal-dev-standards/
-├── core/                  # 核心規範（22 個檔案）
+├── core/                  # 核心規範（32 個檔案）
 ├── skills/                # AI 工具技能
-│   └── claude-code/       # Claude Code 技能（23 個技能）
+│   └── claude-code/       # Claude Code 技能（26 個技能）
 ├── cli/                   # Node.js CLI 工具
 │   ├── src/               # 原始碼
 │   ├── tests/             # 測試檔案

package/bundled/locales/zh-TW/MAINTENANCE.md

@@ -270,7 +270,7 @@ locales/zh-TW/
 ├── ai/
 │   ├── standards/           ← 16 個翻譯 AI 標準
 │   └── options/             ← 36 個翻譯 AI 選項
-├── skills/claude-code/      ← 翻譯技能
+├── skills/      ← 翻譯技能
 ├── adoption/                ← 翻譯採用指南
 ├── templates/               ← 翻譯模板
 ├── README.md
@@ -399,8 +399,8 @@ locales/zh-TW/
    a. 更新 ai/options/{category}/*.ai.yaml
    b. 更新 locales/zh-TW/ai/options/{category}/
 7. 如有技能：
-   a. 更新 skills/claude-code/{skill}/
-   b. 更新 locales/zh-TW/skills/claude-code/{skill}/
+   a. 更新 skills/{skill}/
+   b. 更新 locales/zh-TW/skills/{skill}/
 8. 執行 ./scripts/check-translation-sync.sh zh-TW
 9. 如有重大變更，更新 CHANGELOG.md
 ```
@@ -417,8 +417,8 @@ locales/zh-TW/
    b. 建立 ai/options/{category}/*.ai.yaml
    c. 建立所有語系翻譯
 6. 如需技能：
-   a. 建立 skills/claude-code/{skill-name}/
-   b. 建立 locales/zh-TW/skills/claude-code/{skill-name}/
+   a. 建立 skills/{skill-name}/
+   b. 建立 locales/zh-TW/skills/{skill-name}/
 7. 更新：
    - README.md（加入標準列表）
    - STANDARDS-MAPPING.md
@@ -451,10 +451,10 @@ locales/zh-TW/
    若大部分為是 → 建立技能（繼續步驟 1）
    若大部分為否 → 改加入 CLAUDE.md（參見靜態標準）
 
-1. 建立 skills/claude-code/{skill-name}/
+1. 建立 skills/{skill-name}/
    - SKILL.md（含 YAML frontmatter 的主要技能定義）
    - {topic}.md（選用的支援文件）
-2. 建立 locales/zh-TW/skills/claude-code/{skill-name}/
+2. 建立 locales/zh-TW/skills/{skill-name}/
    - SKILL.md（翻譯版本）
 3. 更新 MAINTENANCE.md
    - 在第 4 節新增至技能表格