universal-dev-standards 5.0.0-rc.8 → 5.0.0

package/bundled/locales/zh-CN/core/accessibility-standards.md

@@ -0,0 +1,124 @@
+---
+source: ../../../core/accessibility-standards.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-24
+status: current
+---
+
+> **语言**: [English](../../../core/accessibility-standards.md) | 简体中文
+
+# 无障碍标准
+
+**版本**: 1.0.0
+**最后更新**: 2026-01-29
+**适用范围**: 所有包含用户界面的软件项目
+**范围**: universal
+**行业标准**: WCAG 2.1/2.2, WAI-ARIA 1.2, Section 508
+**参考**: [w3.org](https://www.w3.org/WAI/WCAG21/quickref/)
+
+---
+
+## 目的
+
+本标准定义创建无障碍软件的综合指南，使具有不同能力的人都能使用。标准与国际规范对齐，包括 WCAG 2.1，并支持全球无障碍法规的合规性。
+
+**参考标准**:
+- [WCAG 2.1](https://www.w3.org/WAI/WCAG21/quickref/) - 网页内容无障碍指南
+- [WCAG 2.2](https://www.w3.org/TR/WCAG22/) - 最新 WCAG 版本（2023）
+- [WAI-ARIA 1.2](https://www.w3.org/TR/wai-aria-1.2/) - 无障碍富互联网应用
+- [Section 508](https://www.section508.gov/) - 美国联邦无障碍要求
+
+---
+
+## 无障碍原则（POUR）
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│               WCAG 2.1 POUR 原则                                │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│   P - 可感知（PERCEIVABLE）                                      │
+│   ├── 用户必须能够感知信息                                        │
+│   ├── 为非文本内容提供文本替代                                    │
+│   ├── 为多媒体提供字幕和替代方案                                  │
+│   └── 内容可适配且可区分                                          │
+│                                                                 │
+│   O - 可操作（OPERABLE）                                         │
+│   ├── 所有功能可通过键盘访问                                      │
+│   ├── 用户有足够时间阅读和使用内容                                │
+│   ├── 不要使用可能引发癫痫的设计                                  │
+│   └── 帮助用户导航和查找内容                                      │
+│                                                                 │
+│   U - 可理解（UNDERSTANDABLE）                                   │
+│   ├── 文本可读且可理解                                            │
+│   ├── 网页以可预测的方式呈现和操作                                │
+│   └── 帮助用户避免和纠正错误                                      │
+│                                                                 │
+│   R - 健壮（ROBUST）                                             │
+│   ├── 与当前和未来的用户工具兼容                                  │
+│   └── 使用标准化标记语言                                          │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## WCAG 合规级别
+
+| 级别 | 描述 | 目标 |
+|------|------|------|
+| **A** | 最低级别 — 基本无障碍 | 所有项目的最低要求 |
+| **AA** | 中级 — 解决最常见的障碍 | **推荐目标**（大多数法规要求） |
+| **AAA** | 最高级别 — 最全面的无障碍 | 针对特定需求的增强 |
+
+## 键盘导航
+
+| 要求 | 说明 |
+|------|------|
+| 所有交互元素可通过 Tab 键聚焦 | 按钮、链接、表单控件 |
+| 焦点顺序符合逻辑 | 遵循视觉布局顺序 |
+| 焦点指示器清晰可见 | 不要移除默认焦点样式 |
+| 提供跳过导航链接 | 允许用户跳过重复内容 |
+| 不要创建键盘陷阱 | 用户可以自由导航进出所有组件 |
+
+## 颜色与对比度
+
+| 类型 | AA 级别 | AAA 级别 |
+|------|---------|----------|
+| 普通文本 | 4.5:1 | 7:1 |
+| 大文本（18px+） | 3:1 | 4.5:1 |
+| UI 组件和图标 | 3:1 | 不适用 |
+
+## 无障碍检查清单
+
+- [ ] 所有图片都有 `alt` 属性
+- [ ] 所有表单控件都有关联的标签
+- [ ] 页面有正确的标题层级结构
+- [ ] 颜色不是传达信息的唯一手段
+- [ ] 对比度符合 AA 级别要求
+- [ ] 所有功能都可通过键盘操作
+- [ ] 使用 ARIA 属性增强语义
+- [ ] 视频有字幕，音频有文字记录
+
+## 测试与验证
+
+| 工具 | 类型 | 用途 |
+|------|------|------|
+| axe | 自动化 | 通用无障碍测试 |
+| WAVE | 自动化 | 可视化无障碍评估 |
+| Lighthouse | 自动化 | 性能 + 无障碍审计 |
+| NVDA / VoiceOver | 手动 | 屏幕阅读器测试 |
+| 键盘操作 | 手动 | 键盘导航测试 |
+
+---
+
+## 相关标准
+
+- [性能标准](performance-standards.md)
+- [安全标准](security-standards.md)
+- [测试标准](testing-standards.md)
+
+---
+
+## 许可证
+
+本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。

package/bundled/locales/zh-CN/core/agent-dispatch.md

@@ -0,0 +1,113 @@
+---
+source: ../../../core/agent-dispatch.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-24
+status: current
+---
+
+> **语言**: [English](../../../core/agent-dispatch.md) | 简体中文
+
+# 代理派遣与并行协调
+
+**版本**: 1.0.0
+**最后更新**: 2026-03-20
+**适用范围**: 使用多代理编排的 AI 辅助开发
+**范围**: universal
+**灵感来源**: [Superpowers](https://github.com/obra/superpowers) — dispatching-parallel-agents, subagent-driven-development (MIT)
+
+---
+
+## 目的
+
+定义 AI 子代理的并行派遣、工作协调与状态回报标准。确保高效并行化的同时，防止文件冲突与集成失败。
+
+---
+
+## 术语表
+
+| 术语 | 定义 |
+|------|------|
+| 子代理 | 由编排器生成的用于处理特定任务的 AI 代理 |
+| 独立域 | 与其他任务没有共享可变状态的任务范围 |
+| 状态协议 | 子代理必须回报的标准化返回状态 |
+| 文件冲突 | 多个代理同时修改同一文件 |
+
+---
+
+## 核心原则 — 并行前先确认独立性
+
+> **派遣代理并行执行前，必须验证其任务域是独立的（无共享可变状态）。**
+
+---
+
+## Prompt 设计原则
+
+每个子代理的 prompt 必须遵循三个原则：
+
+### 1. 聚焦（Focused）
+
+每个代理只处理单一问题域，不混合无关任务。
+
+### 2. 自足（Self-contained）
+
+Prompt 包含执行所需的完整上下文，代理不需要额外提问或搜索。
+
+### 3. 明确输出（Specific Output）
+
+明确定义期望的返回格式。
+
+---
+
+## 独立性验证
+
+在并行派遣前，必须检查以下条件：
+
+| 检查项 | 条件 | 失败时处理 |
+|--------|------|-----------|
+| 文件集合不相交 | 两个任务不修改相同文件 | 串行执行 |
+| 无共享可变状态 | 任务间不依赖共享变量 | 合并为单一任务 |
+| 无执行顺序依赖 | 任务 B 不需要任务 A 的输出 | 串行执行 |
+
+## 状态协议
+
+每个子代理必须返回标准化状态：
+
+| 状态 | 含义 | 后续动作 |
+|------|------|---------|
+| `SUCCESS` | 任务完成，所有验证通过 | 整合结果 |
+| `FAILED` | 任务失败，附带错误详情 | 分析失败原因 |
+| `BLOCKED` | 任务被外部依赖阻塞 | 解除阻塞后重试 |
+| `PARTIAL` | 部分完成，附带进度说明 | 评估是否继续 |
+
+## 冲突预防
+
+### 文件级隔离
+
+```
+代理 A: src/auth/**        ← 独立域
+代理 B: src/payments/**    ← 独立域
+代理 C: src/shared/**      ← ⚠️ 不可并行（共享域）
+```
+
+### 合并策略
+
+| 情况 | 策略 |
+|------|------|
+| 无冲突 | 自动合并 |
+| 格式冲突（仅空白/排序） | 自动解决 |
+| 语义冲突 | 人工审查 |
+
+---
+
+## 相关标准
+
+- [Git Worktree 隔离](git-worktree.md)
+- [分支完成工作流程](branch-completion.md)
+- [AI 模型选择策略](model-selection.md)
+
+---
+
+## 许可证
+
+本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。

package/bundled/locales/zh-CN/core/ai-agreement-standards.md

@@ -0,0 +1,103 @@
+---
+source: ../../../core/ai-agreement-standards.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-24
+status: current
+---
+
+> **语言**: [English](../../../core/ai-agreement-standards.md) | 简体中文
+
+# AI 协议标准
+
+**版本**: 1.0.0
+**最后更新**: 2026-01-29
+**适用范围**: 所有 AI 辅助开发会话
+**范围**: universal
+**行业标准**: ISO 12207 §6.1
+**参考**: [iso.org](https://www.iso.org/standard/63712.html)
+**ISO 12207 映射**: 协议过程（6.1）
+
+---
+
+## 目的
+
+本标准将人类（获取方）与 AI（供应方）之间的交互形式化为可验证的协议。在 "Vibe Coding" 中，prompt 上下文作为管理 AI 行为和交付物的合约。
+
+---
+
+## 1. 上下文合约
+
+每个 AI 会话必须以清晰的上下文合约开始。通常通过系统提示文件实现（如 `CLAUDE.md`、`.cursorrules`）。
+
+### 1.1 合约组件
+
+有效的上下文合约必须定义：
+
+| 组件 | 描述 | 示例 |
+|------|------|------|
+| **角色定义** | 谁代表用户 vs. AI | "你是一位资深后端工程师..." |
+| **工作范围** | 操作边界 | "只修改 `src/utils/` 中的文件。不要动 `config/`。" |
+| **约束法则** | 不可协商的规则 | "不要硬编码密钥。始终使用 TypeScript。" |
+| **验收条件** | 完成的定义 | "代码必须通过 `npm test` 和 `npm run lint`。" |
+
+---
+
+## 2. 需求提案（RFP）标准
+
+复杂任务应结构化为 "RFP"（需求提案），而非简单的聊天消息。
+
+### 2.1 RFP Prompt 结构
+
+请求复杂功能或重构时，使用此结构：
+
+```markdown
+# 目标
+[任务的单行摘要]
+
+# 上下文与约束
+- **当前状态**: [描述现有代码/架构]
+- **目标状态**: [描述期望结果]
+- **约束**: [如 "必须使用库 X"、"最大复杂度 N"]
+
+# 输入数据
+[列出相关文件或粘贴 JSON Schema]
+
+# 交付要求
+1. [要求 A]
+2. [要求 B]
+```
+
+---
+
+## 3. 变更管理
+
+### 3.1 范围变更协议
+
+| 变更类型 | 处理方式 |
+|---------|---------|
+| **范围内** | 直接实现 |
+| **小范围外** | 提出建议，等待确认 |
+| **大范围外** | 暂停，要求新的 RFP |
+
+### 3.2 冲突解决
+
+当 AI 检测到指令冲突时：
+
+1. 明确指出冲突
+2. 列出冲突的指令
+3. 提出推荐解决方案
+4. 等待人类决策
+
+---
+
+## 相关标准
+
+- [虚拟组织标准](virtual-organization-standards.md)
+- [AI 指令标准](../../../core/ai-instruction-standards.md)
+
+---
+
+## 许可证
+
+本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。

package/bundled/locales/zh-CN/core/ai-command-behavior.md

@@ -0,0 +1,247 @@
+---
+source: ../../../core/ai-command-behavior.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-24
+status: current
+---
+
+# AI 命令行为标准
+
+> **语言**: [English](../../../core/ai-command-behavior.md) | [繁體中文](../../zh-TW/core/ai-command-behavior.md) | 简体中文
+
+**版本**: 1.0.0
+**最后更新**: 2026-03-24
+**适用范围**: 所有使用 AI 辅助命令或技能的项目
+**范围**: universal
+**行业标准**: 无（新兴 AI 工具实践）
+**参考**: [SPEC-STD-07](../../../docs/specs/standards/SPEC-STD-07-ai-command-behavior.md)
+
+---
+
+## 目的
+
+本标准定义一套结构，用于在命令/技能定义文件中规范 AI Agent 的运行时行为。确保 AI Agent 在执行命令时产生一致、可预测的交互——无论使用哪个 AI 模型或工具。
+
+**问题**：命令定义了「做什么」，但缺乏「AI 如何与用户交互」，导致行为不可预测。
+
+**解决方案**：标准化的 `## AI Agent Behavior` 区段，包含四个子区段：进入路由、交互脚本、停止点、错误处理。
+
+---
+
+## AI 行为区段结构
+
+每个需要 AI 交互的命令定义文件 SHOULD 包含：
+
+```markdown
+## AI Agent Behavior | AI 代理行为
+
+### Entry Router | 进入路由
+
+### Interaction Script | 交互脚本
+
+### Stop Points | 停止点
+
+### Error Handling | 错误处理
+```
+
+---
+
+## 区段定义
+
+### 1. 进入路由
+
+定义 AI 对每种调用模式的行为。对于有多种调用模式的命令，使用决策表。
+
+**格式：**
+
+```markdown
+| Input | AI Action |
+|-------|-----------|
+| `/cmd` | [无参数时的行为] |
+| `/cmd <name>` | [有名称参数时的行为] |
+| `/cmd <phase>` | [有阶段子命令时的行为] |
+| `/cmd <phase> <target>` | [有阶段和目标时的行为] |
+```
+
+**简单命令**（单一调用模式）可以用一行描述代替。
+
+**规则：**
+- 每个文档记载的调用模式都必须有对应的条目
+- 「无参数」的情况必须始终定义
+- 进入行为必须是确定性的——不允许模糊
+
+### 2. 交互脚本
+
+使用**混合精细度**定义逐步 AI 行为：
+
+| 元素 | 精细度 | 原因 |
+|------|--------|------|
+| 决策点 | 精确（IF/THEN） | 影响下游流程 |
+| 一般步骤 | 指引式（编号列表） | AI 需要弹性 |
+
+**决策点格式：**
+
+```markdown
+**Decision: [名称]**
+- IF [条件 A] → [具体行为]
+- IF [条件 B] → [具体行为]
+- ELSE → [默认行为]
+```
+
+**一般步骤格式：**
+
+```markdown
+1. [步骤描述]
+2. [步骤描述]
+3. [步骤描述]
+```
+
+**规则：**
+- 决策点必须使用明确的 IF/THEN/ELSE
+- 一般步骤应使用编号列表
+- 关键输出的格式（AI 展示给用户的内容）应明确指定
+
+### 3. 停止点
+
+定义 AI 必须暂停并等待用户确认的时刻。
+
+**标记格式：**
+
+```markdown
+🛑 **STOP**: [描述] — 等待用户确认后再继续
+```
+
+**默认停止原则**（当未明确定义停止点时适用）：
+
+| 情境 | 行为 |
+|------|------|
+| 即将写入/修改文件 | 🛑 停止 |
+| 即将执行不可逆操作 | 🛑 停止 |
+| 阶段完成 | 🛑 停止 |
+| 需要用户提供额外信息 | 🛑 停止 |
+| 只读分析完成，展示结果 | ▶️ 继续 |
+
+**规则：**
+- 停止点必须明确——不依赖 AI 判断
+- 每个停止点必须描述 AI 在等待什么
+- 停止点的数量应与操作风险成正比
+
+### 4. 错误处理
+
+定义前置条件失败或遇到非预期状态时的 AI 行为。
+
+**格式：**
+
+```markdown
+| 错误条件 | AI 行为 |
+|---------|--------|
+| [前置条件未满足] | [引导到正确步骤] |
+| [非预期状态] | [停止并询问用户] |
+```
+
+**默认错误原则：**
+
+1. **说明问题**：告诉用户哪个前置条件失败
+2. **引导解决**：建议正确的命令或步骤
+3. **不静默跳过**：不忽略失败继续执行
+4. **不未经许可自动修复**：除非命令定义中明确允许
+5. **不确定时询问**：停止并询问，而非猜测
+
+---
+
+## 适用规则
+
+并非所有命令都需要完整的 `## AI Agent Behavior` 区段。
+
+| 条件 | 需要完整定义 | 原因 |
+|------|-------------|------|
+| 多阶段工作流程 | ✅ 是 | 复杂流程需要指引 |
+| 多种调用方式 | ✅ 是 | 否则进入路由模糊 |
+| 单一明确动作 | ❌ 否 | 行为不言自明 |
+| 纯信息查询 | ❌ 否 | 无交互决策 |
+| 子命令编排 | ✅ 是 | 协调逻辑需要定义 |
+
+**判断依据**：如果两个不同的 AI 模型可能合理地以不同方式解释该命令，则需要行为定义。
+
+---
+
+## 示例：最小行为区段
+
+以中等复杂度的 `/coverage` 命令为例：
+
+```markdown
+## AI Agent Behavior
+
+### Entry Router
+
+| Input | AI Action |
+|-------|-----------|
+| `/coverage` | 检测测试框架，运行覆盖率，展示摘要 |
+| `/coverage <path>` | 仅对指定路径运行覆盖率 |
+
+### Interaction Script
+
+1. 检测项目测试框架（查找 jest.config、vitest.config 等）
+2. 运行覆盖率命令
+3. 解析输出并呈现摘要表格
+
+**Decision: 检测到低覆盖率**
+- IF 覆盖率 < 项目阈值 → 突显差距，建议需要测试的文件
+- ELSE → 仅展示摘要
+
+### Stop Points
+
+🛑 **STOP**: 展示覆盖率摘要后 — 询问用户是否需要逐文件明细
+
+### Error Handling
+
+| 错误条件 | AI 行为 |
+|---------|--------|
+| 未检测到测试框架 | 询问用户使用哪个框架 |
+| 覆盖率运行期间测试失败 | 先展示失败，询问是否仍要覆盖率 |
+```
+
+---
+
+## 快速参考卡
+
+### 区段检查清单
+
+| 区段 | 必须定义 | 关键规则 |
+|------|---------|---------|
+| 进入路由 | 所有调用模式 | 「无参数」情况必须定义 |
+| 交互脚本 | 决策点 + 一般流程 | 决策 = 精确，步骤 = 指引 |
+| 停止点 | 每个暂停时刻 | 明确标记，不靠 AI 猜测 |
+| 错误处理 | 前置条件失败 | 不静默跳过 |
+
+### 精细度指引
+
+| 元素 | 层级 | 格式 |
+|------|------|------|
+| 进入路由 | 精确 | 决策表 |
+| 停止点 | 精确 | 🛑 标记 |
+| 交互脚本 | 指引式 | 编号步骤 + 决策用 IF/THEN |
+| 错误处理 | 原则式 | 错误表 + 默认规则 |
+
+---
+
+## 相关标准
+
+- [AI 指令文件规范](ai-instruction-standards.md) — AI 指令文件的文件结构
+- [AI 协议标准](ai-agreement-standards.md) — 人机协作协议
+- [反幻觉规范](anti-hallucination.md) — 基于证据的 AI 行为
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2026-03-24 | 初始版本 |
+
+---
+
+## 许可
+
+本标准依 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可发布。