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

package/bundled/locales/zh-CN/integrations/openspec/README.md

@@ -0,0 +1,43 @@
+---
+source: ../../../../integrations/openspec/README.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# OpenSpec 集成
+
+本目录包含 [OpenSpec](https://github.com/openspec) 的集成文件，这是一个用于规格驱动开发的规格管理工具。
+
+## 文件
+
+| 文件 | 说明 |
+|------|------|
+| `AGENTS.md` | 使用 OpenSpec 的 AI 助手完整指令 |
+
+## 使用方式
+
+### 手动安装
+
+将 `AGENTS.md` 复制到项目的 `openspec/` 目录，或将其内容包含在 AI 助手的系统指令中。
+
+### 搭配 Claude Code
+
+如果使用 Claude Code，您可以在 `CLAUDE.md` 中引用此文件：
+
+```markdown
+## 规格驱动开发
+
+本项目使用 OpenSpec 进行规格管理。请遵循以下指南：
+- [OpenSpec 指令](openspec/AGENTS.md)
+```
+
+## 相关资源
+
+- [Spec Kit 集成](../spec-kit/) - 替代的轻量级 SDD 工具
+- [规格驱动开发规范](../../core/spec-driven-development.md) - SDD 方法论
+
+## 注意事项
+
+OpenSpec 和 Spec Kit 是**规格驱动开发工具**，不是 AI 编码助手。它们不包含在 `uds init` 的 AI 工具选择中，但可以根据需要手动集成。

package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md

@@ -0,0 +1,184 @@
+---
+source: ../../../../integrations/spec-kit/AGENTS.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# Spec Kit 指令
+
+使用 Spec Kit 进行规格驱动开发的 AI 编码助手指令。
+
+## 使用方式
+
+将此文件复制到您的项目，或包含在 AI 助手的系统指令中。
+
+---
+
+## 使用 Spec Kit 进行规格驱动开发
+
+当此项目启用 Spec Kit 时，您必须遵循**规格驱动开发（SDD）**方法论。
+
+### 核心原则：规格优先，代码其次
+
+**规则**：没有对应的已核准规格，不得进行任何功能性代码变更。
+
+**例外情况**：
+- 紧急修复（立即恢复服务，事后记录）
+- 琐碎变更（错字、注释、格式）
+
+---
+
+## Spec Kit 指令
+
+当 Spec Kit 可用时，优先使用这些指令：
+
+| 指令 | 说明 |
+|------|------|
+| `/spec create <title>` | 创建新规格 |
+| `/spec list` | 列出所有活跃规格 |
+| `/spec show <id>` | 显示规格详情 |
+| `/spec approve <id>` | 标记规格为已核准 |
+| `/spec close <id>` | 关闭已完成规格 |
+| `/spec archive <id>` | 归档规格 |
+
+### 指令优先顺序
+
+**规则**：始终优先使用 Spec Kit 指令，而非手动编辑文件。
+
+**理由**：
+- **一致性**：确保规格结构遵循 schema
+- **可追溯性**：自动生成 ID 和链接
+- **验证**：内建检查防止无效状态
+
+---
+
+## SDD 工作流程
+
+```
+┌──────────────┐    ┌──────────────┐    ┌──────────────┐
+│     提案     │───▶│     审查     │───▶│     实现     │
+└──────────────┘    └──────────────┘    └──────────────┘
+                                               │
+                                               ▼
+                    ┌──────────────┐    ┌──────────────┐
+                    │     归档     │◀───│     验证     │
+                    └──────────────┘    └──────────────┘
+```
+
+### 工作流程阶段
+
+| 阶段 | 说明 | 操作 |
+|------|------|------|
+| **提案** | 定义变更内容和原因 | `/spec create` |
+| **审查** | 利益相关者核准 | `/spec approve` |
+| **实现** | 执行已核准规格 | 代码变更 |
+| **验证** | 确认实现符合规格 | 测试 |
+| **归档** | 关闭并归档规格 | `/spec close` |
+
+---
+
+## 任何任务之前
+
+**上下文检查清单**：
+- [ ] 检查活跃规格：`/spec list`
+- [ ] 变更前审查相关规格
+- [ ] 确认无冲突规格
+- [ ] 非琐碎变更需创建规格
+
+**可跳过规格的情况**：
+- 错误修复（恢复预期行为）
+- 错字、格式、注释
+- 依赖更新（非破坏性）
+- 配置变更
+
+---
+
+## 规格文档模板
+
+手动创建规格时，使用此结构：
+
+```markdown
+# [SPEC-ID] 功能标题
+
+## 摘要
+简述提议变更。
+
+## 动机
+为何需要此变更？解决什么问题？
+
+## 详细设计
+技术方案、受影响组件、数据流程。
+
+## 验收标准
+- [ ] 标准 1
+- [ ] 标准 2
+
+## 依赖项
+列出对其他规格或外部系统的依赖。
+
+## 风险
+潜在风险和缓解策略。
+```
+
+---
+
+## 与通用文档规范的集成
+
+### Commit 消息
+
+在 commit 消息中引用规格 ID：
+
+```
+feat(auth): 实现登录功能
+
+实现 SPEC-001 登录功能，支持 OAuth2。
+
+Refs: SPEC-001
+```
+
+### 代码审查
+
+审查者应确认：
+- [ ] 变更符合已核准规格
+- [ ] 无超出规格的范围蔓延
+- [ ] 规格验收标准已达成
+
+---
+
+## 最佳实践
+
+### 应该做的
+- 保持规格聚焦且原子化（每个规格一项变更）
+- 包含清晰的验收标准
+- 将规格链接到实现 PR
+- 完成后归档规格
+
+### 不应该做的
+- 规格核准前开始编码
+- 实现期间修改范围而不更新规格
+- 让规格处于悬而未决状态（始终关闭或归档）
+- 跳过验证步骤
+
+---
+
+## 相关规范
+
+- [规格驱动开发](../../core/spec-driven-development.md) - SDD 方法论
+- [Commit 消息指南](../../core/commit-message-guide.md) - Commit 惯例
+- [代码签入规范](../../core/checkin-standards.md) - 签入要求
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2025-12-30 | 初始 Spec Kit 集成 |
+
+---
+
+## 许可证
+
+本文档以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可发布。

package/bundled/locales/zh-CN/integrations/spec-kit/README.md

@@ -0,0 +1,43 @@
+---
+source: ../../../../integrations/spec-kit/README.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# Spec Kit 集成
+
+本目录包含 [Spec Kit](https://github.com/spec-kit/spec-kit) 的集成文件，这是一个用于规格驱动开发的轻量级规格追踪工具。
+
+## 文件
+
+| 文件 | 说明 |
+|------|------|
+| `AGENTS.md` | 使用 Spec Kit 的 AI 助手指令 |
+
+## 使用方式
+
+### 手动安装
+
+将 `AGENTS.md` 复制到您的项目，或将其内容包含在 AI 助手的系统指令中。
+
+### 搭配 Claude Code
+
+如果使用 Claude Code，您可以在 `CLAUDE.md` 中引用此文件：
+
+```markdown
+## 规格驱动开发
+
+本项目使用 Spec Kit 进行规格管理。请遵循以下指南：
+- [Spec Kit 指令](integrations/spec-kit/AGENTS.md)
+```
+
+## 相关资源
+
+- [OpenSpec 集成](../openspec/) - 替代的 SDD 工具集成
+- [规格驱动开发规范](../../core/spec-driven-development.md) - SDD 方法论
+
+## 注意事项
+
+Spec Kit 和 OpenSpec 是**规格驱动开发工具**，不是 AI 编码助手。它们不包含在 `uds init` 的 AI 工具选择中，但可以根据需要手动集成。

package/bundled/locales/zh-CN/options/commit-message/bilingual.md

@@ -0,0 +1,161 @@
+---
+source: ../../../../options/commit-message/bilingual.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-30
+status: current
+---
+
+# 双语 Commit 讯息
+
+> **语言**: [English](../../../../options/commit-message/bilingual.md) | 繁体中文
+
+**上层标准**: [Commit 讯息指南](../../core/commit-message-guide.md)
+
+---
+
+## 概述
+
+双语 commit 讯息以结构化格式结合英文和繁体中文。此方法在维持国际可及性的同时，为中文团队成员提供清晰的沟通。
+
+## 适用情境
+
+- 语言背景混合的团队
+- 转型为国际标准的公司
+- 同时有本地和国际贡献者的专案
+- 需要双语文件的组织
+
+## 格式
+
+### 基本结构
+
+```
+<type>(<scope>): <英文主题>
+
+<英文说明>
+
+<中文说明>
+
+<footer>
+```
+
+### 替代格式
+
+```
+<type>(<scope>): <English> / <中文>
+
+<详细英文说明>
+
+<详细中文说明>
+
+<footer>
+```
+
+## 范例
+
+### 功能
+
+```
+feat(auth): add two-factor authentication
+
+Add support for TOTP-based two-factor authentication.
+Users can enable 2FA from their security settings.
+
+新增基于 TOTP 的双因素验证支援。
+使用者可以从安全设定中启用 2FA。
+
+Closes #234
+```
+
+### 错误修复
+
+```
+fix(api): handle timeout in payment processing
+
+The payment gateway timeout was causing silent failures.
+Added proper error handling and user notification.
+
+付款闸道逾时导致静默失败。
+新增适当的错误处理和使用者通知。
+
+Fixes #567
+```
+
+### 重大变更
+
+```
+feat(api): migrate to GraphQL API
+
+BREAKING CHANGE: REST API endpoints are deprecated.
+All clients must migrate to GraphQL by v3.0.
+
+重大变更：REST API 端点已弃用。
+所有客户端必须在 v3.0 前迁移至 GraphQL。
+
+Migration guide / 迁移指南：
+- Replace REST calls with GraphQL queries
+- 将 REST 呼叫替换为 GraphQL 查询
+
+Closes #789
+```
+
+### 精简格式
+
+对于较小的变更，使用行内双语格式：
+
+```
+fix(ui): correct button alignment / 修正按钮对齐
+
+style(css): update color scheme / 更新配色方案
+
+docs: fix typo in README / 修正 README 错字
+```
+
+## 撰写指南
+
+| 指南 | 说明 |
+|------|------|
+| 英文优先 | 英文放在中文之前 |
+| 各语言 50 字元 | 每种语言保持简洁 |
+| 英文祈使语气 | 使用动词原形 |
+| 中文动词开头 | 新增、修正、更新等 |
+
+## 最佳实践
+
+### 建议
+
+- 保持两种语言同步
+- 使用一致的格式
+- 审阅两种语言版本
+- 使用各语言适当的惯用语
+
+### 避免
+
+- 在句子中混合语言
+- 使用未经审阅的机器翻译
+- 「小变更」时跳过一种语言
+- 不必要地翻译技术术语
+
+## 技术术语
+
+保持技术术语使用英文：
+
+| 术语 | 使用方式 |
+|------|----------|
+| API、REST、GraphQL | 不翻译 |
+| CRUD 操作 | 不翻译 |
+| Git 指令 | 不翻译 |
+| 框架名称 | 不翻译 |
+
+## 相关选项
+
+- [英文](./english.md) - 纯英文格式
+- [繁体中文](./traditional-chinese.md) - 纯中文格式
+
+---
+
+## 授权条款
+
+本文件采用 [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/options/commit-message/english.md

@@ -0,0 +1,137 @@
+---
+source: ../../../../options/commit-message/english.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-30
+status: current
+---
+
+# 英文 Commit 讯息
+
+> **语言**: [English](../../../../options/commit-message/english.md) | 繁体中文
+
+**上层标准**: [Commit 讯息指南](../../core/commit-message-guide.md)
+
+---
+
+## 概述
+
+此选项定义完全使用英文撰写 commit 讯息的标准。英文是软体开发中使用最广泛的语言，使 commit 对全球开发者社群都可理解。
+
+## 适用情境
+
+- 国际团队
+- 开源专案
+- 有外部贡献者的专案
+- 以英文为公司语言的组织
+- 追求最大可及性的专案
+
+## 格式
+
+### 基本结构
+
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+### 组成元素
+
+| 元素 | 必填 | 说明 |
+|------|------|------|
+| type | 是 | 变更类别（feat、fix、docs 等）|
+| scope | 否 | 影响的模组或元件 |
+| subject | 是 | 简短描述（祈使语气）|
+| body | 否 | 详细说明 |
+| footer | 否 | 参考连结、重大变更 |
+
+## Commit 类型
+
+| 类型 | 说明 | 范例 |
+|------|------|------|
+| `feat` | 新功能 | `feat: add user authentication` |
+| `fix` | 错误修复 | `fix: resolve login timeout issue` |
+| `docs` | 文件更新 | `docs: update API reference` |
+| `style` | 格式调整 | `style: fix indentation in utils` |
+| `refactor` | 程式码重构 | `refactor: simplify validation logic` |
+| `perf` | 效能优化 | `perf: optimize database queries` |
+| `test` | 测试相关 | `test: add unit tests for auth module` |
+| `chore` | 维护作业 | `chore: update dependencies` |
+
+## 撰写指南
+
+### 主题行
+
+1. **使用祈使语气**：「Add feature」而非「Added feature」
+2. **冒号后不大写**：「add feature」而非「Add feature」
+3. **结尾不加句号**：「add feature」而非「add feature.」
+4. **保持 50 字元以内**：简洁扼要
+5. **具体明确**：「fix null pointer in user service」而非「fix bug」
+
+### 内文
+
+1. **每行 72 字元**：在终端机中保持可读性
+2. **说明「什么」和「为什么」**：而非「如何」（程式码会显示如何）
+3. **使用项目符号**：多项变更时
+4. **与主题分隔**：使用空行
+
+## 范例
+
+### 简单功能
+
+```
+feat(auth): add password strength indicator
+
+- Display strength bar during password input
+- Show requirements as user types
+- Prevent submission of weak passwords
+
+Closes #234
+```
+
+### 错误修复
+
+```
+fix(api): handle null response from payment gateway
+
+The payment gateway occasionally returns null instead of an error
+object when the service is degraded. This caused unhandled exceptions
+in the checkout flow.
+
+Added null check and appropriate error handling to gracefully
+handle this edge case.
+
+Fixes #567
+```
+
+### 重大变更
+
+```
+feat(api): change authentication to JWT tokens
+
+BREAKING CHANGE: Session-based authentication is removed.
+All API clients must now use JWT tokens for authentication.
+
+Migration guide:
+1. Obtain JWT token from /auth/token endpoint
+2. Include token in Authorization header
+3. Remove session cookie handling
+
+Closes #789
+```
+
+## 相关选项
+
+- [繁体中文](./traditional-chinese.md) - 繁体中文 Commit 讯息
+- [双语](./bilingual.md) - 中英双语格式
+
+---
+
+## 授权条款
+
+本文件采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权条款。
+
+**来源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)