universal-dev-standards 3.5.1-beta.1 → 3.5.1-beta.11

package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md

@@ -0,0 +1,302 @@
+---
+source: ../../../adoption/STATIC-DYNAMIC-GUIDE.md
+source_version: 1.2.0
+translation_version: 1.2.0
+last_synced: 2026-01-07
+status: current
+---
+
+# 静态与动态规范指南
+
+> **语言**: [English](../../../adoption/STATIC-DYNAMIC-GUIDE.md) | 繁体中文
+
+**版本**: 1.2.0
+**最后更新**: 2026-01-07
+**适用范围**: 使用本规范框架与 AI 助理协作的专案
+
+---
+
+## 目的
+
+本指南说明如何根据应用时机分类和部署开发规范。
+
+---
+
+## 分类概览
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│           纯静态规范                                         │
+│           随时生效，嵌入专案 context 档案中                   │
+├─────────────────────────────────────────────────────────────┤
+│  • checkin-standards    → 编译、测试、覆盖率检查点            │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│           双重性质规范（静态 + 动态）                         │
+│           核心规则在 context 中 + 完整指引按需触发            │
+├─────────────────────────────────────────────────────────────┤
+│  • anti-hallucination   → 基础规则随时生效，详细指引         │
+│                           透过 ai-collaboration-standards    │
+│                           技能按需触发                       │
+│  • project-structure    → 基础惯例随时生效，详细指引         │
+│                           透过 project-structure-guide       │
+│                           技能按需触发                       │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│           纯动态规范（15 个技能）                             │
+│           关键字触发，按需载入                                │
+├─────────────────────────────────────────────────────────────┤
+│  • ai-collaboration-standards ← "certainty", "确定性"        │
+│  • changelog-guide      ← "changelog", "变更日志"            │
+│  • code-review-assistant← "review", "PR", "审查"             │
+│  • commit-standards     ← "commit", "git", "提交"            │
+│  • documentation-guide  ← "docs", "README", "文件"           │
+│  • error-code-guide     ← "error code", "错误码"             │
+│  • git-workflow-guide   ← "branch", "merge", "分支"          │
+│  • logging-guide        ← "logging", "日志"                  │
+│  • project-structure-guide ← "structure", "结构"             │
+│  • release-standards    ← "version", "release", "版本"       │
+│  • requirement-assistant← "spec", "SDD", "规格"              │
+│  • spec-driven-dev      ← "spec", "proposal", "提案"         │
+│  • tdd-assistant        ← "TDD", "test first", "红绿重构"    │
+│  • test-coverage-assistant ← "test coverage", "测试覆盖"     │
+│  • testing-guide        ← "test", "测试"                     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 纯静态规范
+
+### 定义
+
+无论执行何种任务，AI 互动时都应该**随时生效**的规范。这些是强制性规则，无需选择。
+
+### 特征
+
+- 适用于所有互动（无特定触发）
+- 内容精简（适合放在专案 context 文件）
+- 低 token 开销
+- 基础行为准则
+- 强制性规则，无需决策支援
+
+### 纯静态规范清单
+
+| 规范 | 核心规则 | 核心目的 |
+|------|---------|---------|
+| [checkin-standards](../../core/checkin-standards.md) | 编译通过、测试通过、覆盖率维持 | 确保 commit 前的程式码品质 |
+
+### 部署方式
+
+将以下任一档案加入专案根目录：
+
+- `CLAUDE.md` (Claude Code)
+- `.cursorrules` (Cursor)
+- `.github/copilot-instructions.md` (GitHub Copilot)
+- `AI_GUIDELINES.md` (通用)
+
+**范本**: 参见 [CLAUDE.md.template](../../../templates/CLAUDE.md.template)
+
+---
+
+## 双重性质规范（静态 + 动态）
+
+### 定义
+
+同时具有**静态和动态元件**的规范：
+- **静态元件**：核心规则嵌入专案 context（随时生效）
+- **动态元件**：完整技能提供详细指引（按需触发）
+
+### 特征
+
+- 核心规则足够精简，可放入 context 档案
+- 详细指引若随时载入会使 context 膨胀
+- 两种使用模式都有效且互补
+
+### 双重性质规范清单
+
+| 规范 | 静态元件 | 动态技能 | 触发关键字 |
+|------|----------|----------|------------|
+| [anti-hallucination](../../core/anti-hallucination.md) | 确定性标签、建议原则 | ai-collaboration-standards | certainty, assumption, 确定性 |
+| [project-structure](../../core/project-structure.md) | 目录惯例 | project-structure-guide | structure, organization, 结构 |
+
+### 部署方式
+
+1. **静态**：将核心规则摘要加入 `CLAUDE.md`
+2. **动态**：安装对应的技能以获得详细指引
+
+---
+
+## 纯动态规范
+
+### 定义
+
+由**特定关键字**或任务触发，按需载入以提供详细指引的规范。
+
+### 特征
+
+- 有特定触发条件（关键字、指令）
+- 内容详细（若随时载入会使 context 膨胀）
+- 仅在相关时载入
+- 任务特定的工作流程
+- 需要决策支援（选择、建议）
+
+### 动态规范清单（15 个技能）
+
+| 规范 | 技能 | 触发关键字 |
+|------|------|-----------|
+| [anti-hallucination](../../core/anti-hallucination.md) | ai-collaboration-standards | certainty, assumption, 确定性 |
+| [changelog-standards](../../core/changelog-standards.md) | changelog-guide | changelog, release notes, 变更日志 |
+| [code-review-checklist](../../core/code-review-checklist.md) | code-review-assistant | review, PR, 审查 |
+| [commit-message-guide](../../core/commit-message-guide.md) | commit-standards | commit, git, 提交, feat, fix |
+| [documentation-structure](../../core/documentation-structure.md) | documentation-guide | README, docs, 文件 |
+| [documentation-writing-standards](../../core/documentation-writing-standards.md) | documentation-guide | documentation |
+| [error-code-standards](../../core/error-code-standards.md) | error-code-guide | error code, error handling, 错误码 |
+| [git-workflow](../../core/git-workflow.md) | git-workflow-guide | branch, merge, 分支 |
+| [logging-standards](../../core/logging-standards.md) | logging-guide | logging, log level, 日志 |
+| [project-structure](../../core/project-structure.md) | project-structure-guide | structure, organization, 结构 |
+| [spec-driven-development](../../core/spec-driven-development.md) | requirement-assistant | spec, SDD, 规格, 新功能 |
+| [spec-driven-development](../../core/spec-driven-development.md) | spec-driven-dev | spec, proposal, 提案 |
+| [test-driven-development](../../core/test-driven-development.md) | tdd-assistant | TDD, test first, 红绿重构 |
+| [test-completeness-dimensions](../../core/test-completeness-dimensions.md) | test-coverage-assistant | test coverage, 7 dimensions, 测试覆盖 |
+| [testing-standards](../../core/testing-standards.md) | testing-guide | test, 测试, coverage |
+| [versioning](../../core/versioning.md) | release-standards | version, release, 版本 |
+
+### 部署方式
+
+安装为 Claude Code Skills：
+
+**推荐：Plugin Marketplace**
+```bash
+/plugin marketplace add AsiaOstrich/universal-dev-standards
+/plugin install universal-dev-standards@asia-ostrich
+```
+
+**替代方案：手动安装（macOS / Linux）**
+```bash
+mkdir -p ~/.claude/skills
+cp -r skills/claude-code/commit-standards ~/.claude/skills/
+```
+
+**替代方案：手动安装（Windows PowerShell）**
+```powershell
+# 选择性安装
+Copy-Item -Recurse skills\claude-code\commit-standards $env:USERPROFILE\.claude\skills\
+```
+
+详见 [Claude Code Skills README](../../../skills/claude-code/README.md)。
+
+---
+
+## 决策流程图
+
+```
+                    ┌─────────────────┐
+                    │    新规范       │
+                    └────────┬────────┘
+                             │
+                             ▼
+               ┌─────────────────────────┐
+               │ 是否适用于所有           │
+               │ AI 互动？               │
+               └────────────┬────────────┘
+                            │
+              ┌─────────────┴─────────────┐
+              │                           │
+             是                           否
+              │                           │
+              ▼                           ▼
+    ┌─────────────────┐      ┌─────────────────────────┐
+    │ 静态规范         │      │ 能否由关键字             │
+    │ 加入专案         │      │ 触发？                  │
+    │ context 档案    │      └────────────┬────────────┘
+    └─────────────────┘                   │
+                               ┌──────────┴──────────┐
+                               │                     │
+                              是                     否
+                               │                     │
+                               ▼                     ▼
+                    ┌─────────────────┐   ┌─────────────────┐
+                    │ 动态规范         │   │ 考虑是否应该      │
+                    │ 建立为 Skill    │   │ 拆分或合并       │
+                    │ 并设定关键字     │   └─────────────────┘
+                    └─────────────────┘
+```
+
+---
+
+## Skill 触发机制
+
+Skills 使用 YAML frontmatter 定义触发条件：
+
+```yaml
+---
+name: commit-standards
+description: |
+  遵循 conventional commits 标准格式化 commit 讯息。
+  使用时机：撰写 commit 讯息、git commit、检阅 commit 历史。
+  关键字：commit, git, message, conventional, 提交, 讯息, feat, fix, refactor。
+---
+```
+
+**关键元素**:
+- `Use when:` - 描述触发情境
+- `Keywords:` - 列出触发关键字（支援多语言）
+
+---
+
+## 最佳实践
+
+### 静态规范
+
+1. **保持精简**：专案 context 档案最多 100-200 行
+2. **聚焦行为**：AI 应该随时做/避免的事
+3. **包含快速参考**：精简表格，非完整文件
+4. **连结详细内容**：参考完整标准以深入了解
+
+### 动态规范
+
+1. **选择清晰关键字**：明确、常用的术语
+2. **支援多语言**：为中文使用者包含中文关键字
+3. **群组相关规范**：如 testing-guide 涵盖 testing-standards 与 test-completeness
+4. **提供快速参考**：Skills 顶部应有精简摘要
+
+---
+
+## 迁移指南
+
+### 从完整规则到静态+动态
+
+如果目前所有规则都在一个档案中：
+
+1. **提取静态规则**：将 anti-hallucination、checkin、结构规则移至 `CLAUDE.md`
+2. **转换动态规则为 Skills**：为任务特定规则建立或安装 Skills
+3. **移除重复内容**：从 context 档案删除重复的规则
+4. **测试触发**：验证 Skills 在预期关键字时启动
+
+---
+
+## 相关资源
+
+- [CLAUDE.md 范本](../../../templates/CLAUDE.md.template) - 可立即使用的静态规则范本
+- [Claude Code Skills](../../../skills/claude-code/README.md) - 技能安装指南
+- [采用指南](ADOPTION-GUIDE.md) - 整体采用策略
+- [MAINTENANCE.md](../MAINTENANCE.md) - 如何新增/更新技能（维护者专用）
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.2.0 | 2026-01-07 | 新增 tdd-assistant 技能，更新至 15 个技能 |
+| 1.1.0 | 2025-12-30 | 新增双重性质规范分类，更新至 14 个技能 |
+| 1.0.0 | 2025-12-24 | 初始指南 |
+
+---
+
+## 授权
+
+本指南以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。

package/bundled/locales/zh-CN/adoption/checklists/enterprise.md

@@ -0,0 +1,332 @@
+---
+source: ../../../../adoption/checklists/enterprise.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+---
+
+# 等级三：企业采用检查清单
+
+> **语言**: [English](../../../adoption/checklists/enterprise.md) | 繁体中文
+
+> 企业或受监管专案的全面标准
+>
+> 设置时间：1-2 天
+
+---
+
+## 前置条件
+
+- [ ] 等级二（推荐）已完成
+- [ ] 利害关系人已批准全面采用
+- [ ] 已分配时间进行文件审查
+
+---
+
+## Skills 安装
+
+确保安装所有 skills:
+
+**推荐：Plugin Marketplace**
+```bash
+/plugin marketplace add AsiaOstrich/universal-dev-standards
+/plugin install universal-dev-standards@asia-ostrich
+```
+
+**完整 Skills 检查清单**:
+
+### Level 1 Skills
+- [ ] ai-collaboration-standards
+- [ ] commit-standards
+
+### Level 2 Skills
+- [ ] code-review-assistant
+- [ ] git-workflow-guide
+- [ ] release-standards
+- [ ] testing-guide
+- [ ] requirement-assistant
+
+### Level 3 Skills
+- [ ] documentation-guide
+
+---
+
+## 参考文件
+
+复制所有参考文件到您的专案：
+
+**macOS / Linux:**
+```bash
+# In your project root
+mkdir -p .standards
+
+# Level 1 reference documents
+cp path/to/universal-dev-standards/core/checkin-standards.md .standards/
+cp path/to/universal-dev-standards/core/spec-driven-development.md .standards/
+
+# Level 3 reference documents
+cp path/to/universal-dev-standards/core/documentation-writing-standards.md .standards/
+cp path/to/universal-dev-standards/core/project-structure.md .standards/
+```
+
+**Windows PowerShell:**
+```powershell
+# In your project root
+New-Item -ItemType Directory -Force -Path .standards
+
+# Level 1 reference documents
+Copy-Item path\to\universal-dev-standards\core\checkin-standards.md .standards\
+Copy-Item path\to\universal-dev-standards\core\spec-driven-development.md .standards\
+
+# Level 3 reference documents
+Copy-Item path\to\universal-dev-standards\core\documentation-writing-standards.md .standards\
+Copy-Item path\to\universal-dev-standards\core\project-structure.md .standards\
+```
+
+**检查清单**:
+- [ ] `checkin-standards.md` (Level 1)
+- [ ] `spec-driven-development.md` (Level 1)
+- [ ] `documentation-writing-standards.md` (Level 3)
+- [ ] `project-structure.md` (Level 3)
+
+---
+
+## 模板
+
+### 迁移模板（如适用）
+
+用于涉及技术迁移的专案：
+
+**macOS / Linux:**
+```bash
+cp path/to/universal-dev-standards/templates/migration-template.md docs/
+```
+
+**Windows PowerShell:**
+```powershell
+Copy-Item path\to\universal-dev-standards\templates\migration-template.md docs\
+```
+- [ ] `migration-template.md` copied (if applicable)
+
+---
+
+## 延伸规范
+
+验证等级二的所有适用延伸规范已安装：
+
+### 语言延伸
+- [ ] `csharp-style.md` (if C# project)
+- [ ] `php-style.md` (if PHP project)
+
+### 框架延伸
+- [ ] `fat-free-patterns.md` (if Fat-Free project)
+
+### 地区延伸
+- [ ] `zh-cn.md` (if 简体中文 team)
+
+---
+
+## AI 工具整合
+
+验证等级二的所有适用整合已安装：
+
+- [ ] GitHub Copilot: `.github/copilot-instructions.md`
+- [ ] Cursor: `.cursorrules`
+- [ ] Windsurf: `.windsurfrules`
+- [ ] Cline: `.clinerules`
+- [ ] OpenSpec: `.openspec/`
+
+---
+
+## 文件结构
+
+遵循 `documentation-structure.md`，设置：
+
+```
+project/
+├── README.md
+├── CONTRIBUTING.md
+├── CHANGELOG.md
+├── docs/
+│   ├── architecture/
+│   ├── api/
+│   ├── guides/
+│   └── adr/          # Architecture Decision Records
+├── .standards/
+│   ├── checkin-standards.md
+│   ├── spec-driven-development.md
+│   ├── documentation-writing-standards.md
+│   └── project-structure.md
+└── ...
+```
+
+**检查清单**:
+- [ ] `README.md` created/updated
+- [ ] `CONTRIBUTING.md` created
+- [ ] `CHANGELOG.md` created
+- [ ] `docs/` directory structure created
+- [ ] `docs/adr/` for Architecture Decision Records
+
+---
+
+## 专案结构
+
+遵循 `project-structure.md`，验证：
+
+```
+project/
+├── src/              # Source code
+├── tests/            # Test files
+├── tools/            # Build and development tools
+├── examples/         # Example code
+├── dist/             # Build output (gitignored)
+└── ...
+```
+
+- [ ] Directory structure follows standard
+- [ ] `.gitignore` properly configured
+
+---
+
+## 治理
+
+### 文件标准
+
+遵循 `documentation-writing-standards.md`:
+
+- [ ] Document matrix defined (which docs for which project type)
+- [ ] Writing guidelines communicated to team
+- [ ] Review process for documentation established
+
+### 品质闸门
+
+遵循 `checkin-standards.md`:
+
+- [ ] Pre-commit hooks configured
+- [ ] CI/CD pipeline enforces standards
+- [ ] Build verification automated
+
+### 规格驱动开发
+
+遵循 `spec-driven-development.md`:
+
+- [ ] Team trained on SDD methodology
+- [ ] OpenSpec (or equivalent) workflow established
+- [ ] Spec → Implementation → Verification cycle defined
+
+---
+
+## 合规与稽核轨迹
+
+适用于受监管产业：
+
+- [ ] Standards adoption documented
+- [ ] Change management process defined
+- [ ] Version control for all standards
+- [ ] Regular standards review scheduled
+
+---
+
+## 验证
+
+### 完整 Skills 测试
+
+以相关情境测试每个 skill:
+
+| Skill | Test Scenario | Pass |
+|-------|--------------|------|
+| ai-collaboration-standards | Ask for unverified claim | [ ] |
+| commit-standards | Write complex commit | [ ] |
+| code-review-assistant | Review PR | [ ] |
+| git-workflow-guide | Explain branching strategy | [ ] |
+| release-standards | Plan a release | [ ] |
+| testing-guide | Design test strategy | [ ] |
+| requirement-assistant | Write user story | [ ] |
+| documentation-guide | Plan documentation | [ ] |
+
+### 文件稽核
+
+- [ ] All required documents exist
+- [ ] Documents follow writing standards
+- [ ] Documents are up-to-date
+
+### 整合验证
+
+- [ ] All AI tools follow project standards
+- [ ] CI/CD enforces quality gates
+- [ ] Team follows established workflows
+
+---
+
+## 最终检查清单
+
+| Category | Items | Status |
+|----------|-------|--------|
+| **All Skills (8)** | Complete set installed | [ ] |
+| **Reference Docs (4)** | All Level 1 + Level 3 docs | [ ] |
+| **Extensions** | All applicable installed | [ ] |
+| **Integrations** | All tools configured | [ ] |
+| **Documentation** | Structure established | [ ] |
+| **Project Structure** | Follows standard | [ ] |
+| **Governance** | Processes defined | [ ] |
+| **Verification** | All tests passed | [ ] |
+
+---
+
+## 维护
+
+### 定期审查
+
+- [ ] Monthly: Review standards compliance
+- [ ] Quarterly: Update standards if needed
+- [ ] Annually: Full standards audit
+
+### 更新
+
+监控更新：
+- [ ] Subscribe to universal-dev-standards releases
+- [ ] Subscribe to universal-dev-skills releases
+- [ ] Plan upgrade process for new versions
+
+---
+
+## 摘要
+
+完成后，您的专案具有：
+
+- Full AI assistance with 8 Claude Code Skills
+- Complete reference documentation
+- Language/framework-specific guidelines
+- All AI tool integrations
+- Proper documentation structure
+- Standard project organization
+- Governance processes
+
+您的专案现在遵循企业级文件标准。
+
+---
+
+## 相关标准
+
+- [Essential Adoption Checklist](minimal.md) - Level 1 基本采用
+- [Recommended Adoption Checklist](recommended.md) - Level 2 推荐采用
+- [Documentation Writing Standards](../../../core/documentation-writing-standards.md) - 文件撰写规范
+- [Project Structure](../../../core/project-structure.md) - 专案结构标准
+- [Checkin Standards](../../../core/checkin-standards.md) - 签入标准
+- [Spec-Driven Development](../../../core/spec-driven-development.md) - 规格驱动开发
+
+---
+
+## 版本历史
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.1 | 2025-12-24 | Added: Related Standards, License sections |
+| 1.0.0 | 2025-12-23 | Initial checklist |
+
+---
+
+## 授权
+
+本检查清单以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。