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

package/bundled/locales/zh-CN/skills/README.md

@@ -6,129 +6,179 @@ last_synced: 2026-01-07
 status: current
 ---
 
-# 技能 - AI 编程助手规则
+# Claude Code Skills
 
-此目录包含各种 AI 编程助手的技能/规则实作，皆衍生自本仓库的核心标准。
+> **语言**: [English](../../../skills/README.md) | 简体中文
 
-## 目录结构
+软体开发标准的 Claude Code Skills。
 
-```
-skills/
-├── _shared/           # 共用模板和生成工具
-├── claude-code/       # Claude Code 技能（SKILL.md 格式）
-├── cursor/            # Cursor 规则（.cursorrules、Notepads）
-├── windsurf/          # Windsurf 规则（.windsurfrules）
-├── cline/             # Cline 规则（.clinerules）
-└── copilot/           # GitHub Copilot（copilot-instructions.md）
-```
+> 衍生自 [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards) 核心标准。
+
+## 概述
+
+这些技能会根据上下文在使用 Claude Code 时自动觸發，協助您：
+
+- 透過基於证据的响应防止 AI 幻覺
+- 撰写一致且格式良好的提交消息
+- 进行全面的程序码审查
+- 遵循测试最佳实踐
+- 使用語意化版本管理發布
+
+## 可用的 Skills
+
+| Skill（文件夹） | 命令 | 描述 |
+|----------------|---------|-------------|
+| `guide` | `/guide` | [UDS] 访问所有标准指南 |
+| `checkin-assistant` | `/checkin` | [UDS] 提交前质量闸门 |
+| `commit-standards` | `/commit` | [UDS] Conventional Commits 格式 |
+| `code-review-assistant` | `/review` | [UDS] 系统化程序码审查 |
+| `tdd-assistant` | `/tdd` | [UDS] 测试驱动开发 |
+| `bdd-assistant` | `/bdd` | [UDS] 行为驱动开发 |
+| `atdd-assistant` | `/atdd` | [UDS] 验收测试驱动开发 |
+| `release-standards` | `/release` | [UDS] 发布与变更日志管理 |
+| `documentation-guide` | `/docs` | [UDS] 文档管理 |
+| `requirement-assistant` | `/requirement` | [UDS] 需求撰写 |
+| `reverse-engineer` | `/reverse` | [UDS] 逆向工程程序码 |
+| `forward-derivation` | `/derive` | [UDS] 从规格衍生产出物 |
+| `spec-driven-dev` | `/sdd` | [UDS] 规格驱动开发 |
+| `test-coverage-assistant` | `/coverage` | [UDS] 测试覆盖率分析 |
+| `methodology-system` | `/methodology` | [UDS] 开发方法论 |
+| `refactoring-assistant` | `/refactor` | [UDS] 重构指引 |
+| `project-discovery` | `/discover` | [UDS] 评估项目健康度与风险 |
+| `changelog-guide` | `/changelog` | [UDS] 生成变更日志条目 |
+| `docs-generator` | `/docgen` | [UDS] 生成使用文档 |
+
+## 静态与动态规范
+
+规范依据应用时机分为兩类：
+
+Standards are classified into two types based on when they should be applied:
+
+### 静态规范（项目文件）
+
+这些规范应該**隨时生效**，建议放在项目的 `CLAUDE.md` 或 `.cursorrules` 中：
 
-## 快速开始
+These standards should **always be active**. Add them to your project's `CLAUDE.md` or `.cursorrules`:
 
-### Claude Code
+| Standard | 核心規則 | Key Rules |
+|----------|---------|-----------|
+| [anti-hallucination](../../../core/anti-hallucination.md) | 确定性标签、建议原則 | Certainty labels, suggestion principles |
+| [checkin-standards](../../../core/checkin-standards.md) | 编譯通過、测试通過、覆蓋率达標 | Build passes, tests pass, coverage met |
+| [project-structure](../../../core/project-structure.md) | 目录结构规范 | Directory structure conventions |
+
+> 📄 參見 [CLAUDE.md.template](../../../templates/CLAUDE.md.template) 取得可直接使用的範本。
+>
+> 📄 See [CLAUDE.md.template](../../../templates/CLAUDE.md.template) for a ready-to-use template.
+
+### 动态规范（Skills）
+
+这些规范由**关鍵字觸發**，按需载入。安裝为 Skills 使用：
+
+These are **triggered by keywords** or specific tasks. Install as Skills:
+
+| Skill | 觸發关鍵字 | Trigger Keywords |
+|-------|-----------|-----------------|
+| commit-standards | 提交、消息 | commit, git, message |
+| code-review-assistant | 审查、检查 | review, PR, checklist |
+| git-workflow-guide | 分支、合併 | branch, merge, workflow |
+| testing-guide | 测试、覆蓋率 | test, coverage, pyramid |
+| tdd-assistant | TDD、测试優先、紅綠重構 | TDD, test first, red green refactor |
+| release-standards | 版本、發布 | version, release, semver |
+| documentation-guide | 文件、文档 | README, docs, documentation |
+| requirement-assistant | 規格、需求、新功能 | spec, SDD, requirement |
+
+> 📖 參見[静态与动态指南](../../../adoption/STATIC-DYNAMIC-GUIDE.md)了解详细分类说明。
+>
+> 📖 See [Static vs Dynamic Guide](../../../adoption/STATIC-DYNAMIC-GUIDE.md) for detailed classification.
+
+## 安裝
+
+### 推荐：Plugin Marketplace
+
+透過 Claude Code Plugin Marketplace 安裝以獲得自动更新：
 
-**推荐：Plugin Marketplace**
 ```bash
+# 新增 marketplace（一次性设置）
 /plugin marketplace add AsiaOstrich/universal-dev-standards
+
+# 安裝包含所有 15 个技能的插件
 /plugin install universal-dev-standards@asia-ostrich
 ```
 
-**替代方案：手动复制（macOS / Linux）**
-```bash
-mkdir -p ~/.claude/skills
-cp -r skills/claude-code/commit-standards ~/.claude/skills/
-```
+**優点：**
+- ✅ Claude Code 重啟时自动更新
+- ✅ 与 Claude Code 更好的集成
+- ✅ 無需手动維護
 
-**替代方案：手动安装（Windows PowerShell）**
-```powershell
-# 复制特定技能
-Copy-Item -Recurse skills\claude-code\commit-standards $env:USERPROFILE\.claude\skills\
-```
+所有技能將自动载入并可使用。
 
-### Cursor
+### 替代方案：脚本安裝（已棄用）
 
-**macOS / Linux:**
-```bash
-# 复制规则到您的专案
-cp skills/cursor/.cursorrules .cursorrules
-```
+> ⚠️ **已棄用**：透過脚本手动安裝已棄用，將在未來版本中移除。請改用 Plugin Marketplace。
 
-**Windows PowerShell:**
-```powershell
-Copy-Item skills\cursor\.cursorrules .cursorrules
-```
+适用于无法访问 Marketplace 的环境（例如企业网络）：
 
-### Windsurf
+#### 手动安装（选择性 Skills）
 
 **macOS / Linux:**
 ```bash
-cp skills/windsurf/.windsurfrules .windsurfrules
+mkdir -p ~/.claude/skills
+cp -r ai-collaboration-standards ~/.claude/skills/
+cp -r commit-standards ~/.claude/skills/
 ```
 
 **Windows PowerShell:**
 ```powershell
-Copy-Item skills\windsurf\.windsurfrules .windsurfrules
+New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude\skills
+Copy-Item -Recurse ai-collaboration-standards $env:USERPROFILE\.claude\skills\
+Copy-Item -Recurse commit-standards $env:USERPROFILE\.claude\skills\
 ```
 
-### Cline
+### 替代方案：项目层级安裝（已棄用）
 
-**macOS / Linux:**
-```bash
-cp skills/cline/.clinerules .clinerules
-```
-
-**Windows PowerShell:**
-```powershell
-Copy-Item skills\cline\.clinerules .clinerules
-```
+> ⚠️ **已棄用**：项目层级手动安裝已棄用。建议使用 Plugin Marketplace 以獲得最佳体驗。
 
-### GitHub Copilot
+適用於项目特定技能自订：
 
 **macOS / Linux:**
 ```bash
-mkdir -p .github
-cp skills/copilot/copilot-instructions.md .github/copilot-instructions.md
+mkdir -p .claude/skills
+cp -r /path/to/skills/* .claude/skills/
 ```
 
 **Windows PowerShell:**
 ```powershell
-New-Item -ItemType Directory -Force -Path .github
-Copy-Item skills\copilot\copilot-instructions.md .github\copilot-instructions.md
+New-Item -ItemType Directory -Force -Path .claude\skills
+Copy-Item -Recurse path\to\skills\claude-code\* .claude\skills\
 ```
 
-## 可用技能
+> **注意**：项目层级技能（`.claude/skills/`）優先於全域技能（`~/.claude/skills/`）。
 
-| 技能 | 说明 | Claude Code | Cursor | Windsurf | Cline | Copilot |
-|------|------|:-----------:|:------:|:--------:|:-----:|:-------:|
-| AI 协作 | 防止幻觉 | ✅ | ✅ | ✅ | ✅ | ✅ |
-| 变更日志指南 | 变更日志撰写 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
-| 程序码审查 | 审查检查表 | ✅ | ✅ | ✅ | ✅ | ✅ |
-| 提交标准 | Conventional Commits | ✅ | ✅ | ✅ | ✅ | ✅ |
-| 文件 | README 模板 | ✅ | ✅ | ✅ | ✅ | ✅ |
-| 错误码指南 | 错误码标准 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
-| Git 工作流程 | 分支策略 | ✅ | ✅ | ✅ | ✅ | ✅ |
-| 日志指南 | 日志最佳实践 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
-| 专案结构 | 目录规范 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
-| 发布标准 | 语意化版本 | ✅ | ✅ | ✅ | ✅ | ✅ |
-| 需求 | 使用者故事指引 | ✅ | ✅ | ✅ | ✅ | ✅ |
-| 规格驱动开发 | SDD 方法论 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
-| 测试覆盖率 | 覆盖率分析 | ✅ | 🚧 | 🚧 | 🚧 | 🚧 |
-| 测试指南 | 测试最佳实践 | ✅ | ✅ | ✅ | ✅ | ✅ |
+## 设置
 
-图例：✅ 完成 | 🚧 计划中 | ❌ 不适用
+Skills 支援透過 `CONTRIBUTING.md` 进行项目特定设置。
 
-## 与核心标准的关系
+### 停用 Skills
 
-这些技能是核心标准的**互动式实作**：
+在您的项目 `CONTRIBUTING.md` 中加入：
 
+```markdown
+## Disabled Skills
+
+- testing-guide
+- release-standards
 ```
-core/anti-hallucination.md
-    ↓ 转换为
-skills/claude-code/ai-collaboration-standards/SKILL.md
-skills/cursor/.cursorrules（AI 区段）
-```
 
-**重要**：使用技能或复制核心文件——同一标准**不要两者并用**。
+### 设置範本
+
+完整设置选项請參見 [CONTRIBUTING.template.md](../../../skills/CONTRIBUTING.template.md)。
+
+## Skill 優先順序
+
+當同一个 skill 同时存在於兩个位置时：
+1. **项目层级**（`.claude/skills/`）優先
+2. **全域层级**（`~/.claude/skills/`）为备援
 
-## 贡献
+## 授权条款
 
-请参阅 [CONTRIBUTING.md](../CONTRIBUTING.md) 了解新增技能或支援其他 AI 工具的指南。
+雙重授权：CC BY 4.0（文件）+ MIT（程序码）

package/bundled/locales/zh-CN/skills/agents/README.md

@@ -0,0 +1,281 @@
+---
+source: ../../../../skills/agents/README.md
+source_version: 1.1.0
+translation_version: 1.0.0
+last_synced: 2026-02-05
+status: current
+---
+
+# UDS 代理
+
+> **语言**: [English](../../../../skills/agents/README.md) | 简体中文
+
+**版本**: 1.1.0
+**最后更新**: 2026-01-21
+**状态**: 稳定
+
+---
+
+## 概述
+
+UDS 代理是专门的 AI 子代理，可以协调处理复杂的开发工作流程。与技能（提供上下文/知识）不同，代理是可以执行多步骤任务的自主实体。
+
+## AGENT.md 格式规格
+
+### Frontmatter 架构
+
+```yaml
+---
+# === 必填字段 ===
+name: agent-name              # 唯一标识符（kebab-case）
+version: 1.0.0                # 语义版本
+description: |                # 用于 AI 匹配的多行描述
+  代理目的的简要描述。
+  关键字: keyword1, keyword2, keyword3.
+
+# === 角色配置 ===
+role: specialist              # orchestrator | specialist | reviewer
+expertise:                    # 领域专长
+  - system-design
+  - api-design
+  - database-modeling
+
+# === 工具权限（Claude Code Task 工具）===
+# 指定此代理可以使用哪些工具
+allowed-tools:
+  - Read                      # 文件读取
+  - Glob                      # 模式匹配
+  - Grep                      # 内容搜索
+  - Bash(git:*)               # 仅 Git 命令
+  - WebFetch                  # 网页抓取
+  - WebSearch                 # 网页搜索
+disallowed-tools:             # 明确封锁的工具
+  - Write                     # 不可写入文件
+  - Edit                      # 不可编辑文件
+
+# === 技能依赖 ===
+# 为此代理提供上下文/知识的技能
+skills:
+  - spec-driven-dev           # 技能名称引用
+  - testing-guide
+
+# === 模型偏好（仅 Claude Code）===
+model: claude-sonnet-4-20250514  # 偏好模型
+temperature: 0.3              # 响应创造性（0.0-1.0）
+
+# === 上下文策略（RLM 启发）===
+# 处理大型代码库和长上下文的配置
+context-strategy:
+  mode: adaptive              # full | chunked | adaptive
+  max-chunk-size: 50000       # 每个区块的最大 token 数
+  overlap: 500                # 区块间的 token 重叠
+  analysis-pattern: hierarchical  # hierarchical | parallel | sequential
+
+# === 触发条件 ===
+triggers:
+  keywords:                   # 这些关键字自动启动
+    - architecture
+    - system design
+    - 架构设计
+  commands:                   # 调用此代理的斜线命令
+    - /architect
+---
+```
+
+### 角色类型
+
+| 角色 | 描述 | 使用案例 |
+|------|------|---------|
+| `orchestrator` | 协调多个代理 | 复杂工作流程、功能开发 |
+| `specialist` | 特定领域的深度专业 | 架构、测试、文档 |
+| `reviewer` | 评估并提供反馈 | 代码审查、规格审查、PR 审查 |
+
+### 工具权限模式
+
+```yaml
+# 完全工具访问（未指定时的默认）
+allowed-tools: [*]
+
+# 只读代理
+allowed-tools: [Read, Glob, Grep]
+disallowed-tools: [Write, Edit, Bash]
+
+# 仅限 Git 的 bash 访问
+allowed-tools:
+  - Bash(git:*)     # 仅 git 命令
+  - Bash(npm:test)  # 仅 npm test
+
+# 特定文件模式
+allowed-tools:
+  - Write(*.md)     # 仅 markdown 文件
+  - Edit(src/**)    # 仅 src 目录
+```
+
+### 上下文策略配置（RLM 启发）
+
+`context-strategy` 区段使用 RLM（递归语言模型）原则实现对大型代码库和长上下文的智能处理。
+
+#### 模式选项
+
+| 模式 | 描述 | 使用案例 |
+|------|------|---------|
+| `full` | 一次加载完整上下文 | 小项目、文档任务 |
+| `chunked` | 将上下文分成固定大小的区块 | 顺序代码审查、大型文件分析 |
+| `adaptive` | 根据内容结构动态调整 | 复杂分析、架构探索 |
+
+#### 分析模式
+
+| 模式 | 描述 | 最适合 |
+|------|------|--------|
+| `hierarchical` | 先分析高层结构，然后深入细节 | 架构分析、系统设计 |
+| `parallel` | 同时处理多个区段 | 独立模块分析、规格审查 |
+| `sequential` | 依序处理区段，保留上下文 | 代码审查、逐步分析 |
+
+## 内建代理
+
+| 代理 | 角色 | 描述 |
+|------|------|------|
+| [code-architect](../../../../skills/agents/code-architect.md) | specialist | 软件架构和系统设计 |
+| [test-specialist](../../../../skills/agents/test-specialist.md) | specialist | 测试策略和测试实现 |
+| [reviewer](../../../../skills/agents/reviewer.md) | reviewer | 代码审查和质量评估 |
+| [doc-writer](../../../../skills/agents/doc-writer.md) | specialist | 文档和技术写作 |
+| [spec-analyst](../../../../skills/agents/spec-analyst.md) | specialist | 规格分析和需求萃取 |
+
+## 使用方式
+
+### CLI 安装
+
+```bash
+# 列出可用的代理
+uds agent list
+
+# 将特定代理安装到项目
+uds agent install code-architect
+
+# 安装所有代理
+uds agent install --all
+
+# 安装到用户目录（全局）
+uds agent install code-architect --global
+```
+
+### 在 Claude Code 中直接调用
+
+```
+/architect [任务描述]
+```
+
+或通过自然语言触发：
+
+```
+请帮我设计新认证系统的架构。
+```
+
+## 创建自定义代理
+
+### 1. 创建 AGENT.md 文件
+
+```bash
+# 在你的项目中
+mkdir -p .claude/agents
+touch .claude/agents/my-agent.md
+```
+
+### 2. 定义 Frontmatter
+
+```yaml
+---
+name: my-custom-agent
+version: 1.0.0
+description: |
+  针对特定项目需求的自定义代理。
+  关键字: custom, specific, project.
+
+role: specialist
+expertise: [domain-specific]
+
+allowed-tools: [Read, Glob, Grep, Edit]
+skills: [relevant-skill]
+
+triggers:
+  commands: [/myagent]
+---
+```
+
+### 3. 撰写代理指令
+
+```markdown
+# 我的自定义代理
+
+## 目的
+
+描述此代理的功能。
+
+## 工作流程
+
+1. 步骤一
+2. 步骤二
+3. 步骤三
+
+## 指南
+
+- 指南 1
+- 指南 2
+```
+
+## 代理 vs 技能比较
+
+| 方面 | 技能 | 代理 |
+|------|------|------|
+| **目的** | 提供知识/上下文 | 执行自主任务 |
+| **执行** | 作为上下文加载 | 作为子代理生成（或内嵌） |
+| **状态** | 无状态 | 可维护任务状态 |
+| **工具访问** | 无（仅上下文） | 可配置权限 |
+| **触发** | 手动加载 | 关键字、命令、工作流程 |
+| **组合** | 由代理引用 | 可使用技能作为上下文 |
+
+## 与工作流程整合
+
+代理可通过工作流程定义进行协调：
+
+```yaml
+# workflows/feature-dev.workflow.yaml
+name: feature-development
+steps:
+  - agent: spec-analyst
+    task: 分析需求
+  - agent: code-architect
+    task: 设计解决方案
+  - agent: test-specialist
+    task: 定义测试策略
+  - manual: 实现
+  - agent: reviewer
+    task: 代码审查
+```
+
+请参阅 [workflows/README.md](../../../../skills/workflows/README.md) 获取工作流程文档。
+
+---
+
+## 相关资源
+
+- [技能文档](../README.md)
+- [工作流程文档](../../../../skills/workflows/README.md)
+- [AI 代理路径配置](../../../../cli/src/config/ai-agent-paths.js)
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.1.0 | 2026-01-21 | 添加 RLM 启发的 context-strategy 配置 |
+| 1.0.0 | 2026-01-20 | 初始发布 |
+
+---
+
+## 授权
+
+本文档以 [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/ai-collaboration-standards → ai-collaboration-standards}/SKILL.md

@@ -1,17 +1,17 @@
 ---
-source: ../../../../../skills/claude-code/ai-collaboration-standards/SKILL.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2025-12-30
+source: ../../../../skills/ai-collaboration-standards/SKILL.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-25
 status: current
 ---
 
 # AI 协作标准
 
-> **语言**: [English](../../../../../skills/claude-code/ai-collaboration-standards/SKILL.md) | 简体中文
+> **语言**: [English](../../../../skills/ai-collaboration-standards/SKILL.md) | 简体中文
 
-**版本**: 1.0.0
-**最後更新**: 2025-12-24
+**版本**: 1.1.0
+**最後更新**: 2026-01-25
 **適用範圍**: Claude Code Skills
 
 ---
@@ -154,9 +154,9 @@ This project uses **English** certainty tags.
 
 ## 相关标准
 
-- [防幻覺标准](../../core/anti-hallucination.md)
-- [程序码审查检查清单](../../core/code-review-checklist.md)
-- [测试标准](../../core/testing-standards.md)
+- [防幻覺标准](../../../../core/anti-hallucination.md)
+- [程序码审查检查清单](../../../../core/code-review-checklist.md)
+- [测试标准](../../../../core/testing-standards.md)
 
 ---
 

package/bundled/locales/zh-CN/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/anti-hallucination.md

@@ -1,17 +1,17 @@
 ---
-source: skills/claude-code/ai-collaboration-standards/anti-hallucination.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2025-12-25
+source: ../../../../skills/ai-collaboration-standards/anti-hallucination.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-25
 status: current
 ---
 
 # 防止幻覺指南
 
-> **语言**: [English](../../../../../skills/claude-code/ai-collaboration-standards/anti-hallucination.md) | 简体中文
+> **语言**: [English](../../../../skills/ai-collaboration-standards/anti-hallucination.md) | 简体中文
 
-**版本**: 1.0.0
-**最後更新**: 2025-12-24
+**版本**: 1.1.0
+**最後更新**: 2026-01-25
 **適用範圍**: Claude Code Skills
 
 ---
@@ -203,7 +203,7 @@ AI 助理絕对不能:
 
 ## 相关标准
 
-- [防止幻覺标准](../../../core/anti-hallucination.md)
+- [防止幻覺标准](../../../../core/anti-hallucination.md)
 - [确定性标签參考](./certainty-labels.md)
 
 ---

package/bundled/locales/zh-CN/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/certainty-labels.md

@@ -1,17 +1,17 @@
 ---
-source: skills/claude-code/ai-collaboration-standards/certainty-labels.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2025-12-25
+source: ../../../../skills/ai-collaboration-standards/certainty-labels.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-25
 status: current
 ---
 
 # 确定性标签參考
 
-> **语言**: [English](../../../../../skills/claude-code/ai-collaboration-standards/certainty-labels.md) | 简体中文
+> **语言**: [English](../../../../skills/ai-collaboration-standards/certainty-labels.md) | 简体中文
 
-**版本**: 1.0.0
-**最後更新**: 2025-12-24
+**版本**: 1.1.0
+**最後更新**: 2026-01-25
 **適用範圍**: Claude Code Skills
 
 ---
@@ -113,7 +113,7 @@ status: current
 ## 相关标准
 
 - [防幻覺指南](./anti-hallucination.md)
-- [防幻覺标准](../../../core/anti-hallucination.md)
+- [防幻覺标准](../../../../core/anti-hallucination.md)
 
 ---