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

package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md

@@ -0,0 +1,221 @@
+---
+source: ../../../../skills/ai-friendly-architecture/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-02-05
+status: current
+scope: uds-specific
+description: |
+  设计 AI 友善架构，包含明确模式、分层文档和语义边界。
+  使用时机：为 AI 协作规划项目结构、优化代码库以利 AI 分析、设置 AI 上下文。
+  关键字：architecture, AI-friendly, context, modules, documentation layers, .ai-context.yaml, 架构, AI 友善, 上下文.
+---
+
+# AI 友善架构指南
+
+> **语言**: [English](../../../../skills/ai-friendly-architecture/SKILL.md) | 简体中文
+
+**版本**: 1.0.0
+**最后更新**: 2026-01-25
+**适用范围**: Claude Code Skills
+
+---
+
+> **核心标准**: 本技能实现 [AI 友善架构](../../../../core/ai-friendly-architecture.md)。完整方法论文档请参阅核心标准。
+
+## 目的
+
+本技能协助设计项目架构，通过明确模式、分层文档和语义边界，最大化 AI 协作效能。
+
+## 快速参考
+
+### 核心原则
+
+| 原则 | 描述 | 效益 |
+|------|------|------|
+| **明确优于隐含** | 明确记录行为 | AI 无需猜测即可理解 |
+| **分层上下文** | 多层级文档 | 依任务提供适当细节 |
+| **语义边界** | 清晰的模块边界 | 独立分析 |
+| **可发现结构** | 自我说明的结构 | 快速定位 |
+
+### 上下文层级
+
+| 层级 | Token 预算 | 内容 |
+|------|------------|------|
+| **L1: 快速参考** | < 500 | 单行说明、API 签名、入口点 |
+| **L2: 详细** | < 5,000 | 完整 API 文档、使用示例 |
+| **L3: 示例** | 无限制 | 完整实现、边界案例 |
+
+### 建议结构
+
+```
+project/
+├── .ai-context.yaml          # AI 上下文配置
+├── docs/
+│   ├── QUICK-REF.md          # 第 1 层文档
+│   └── ARCHITECTURE.md       # 第 2 层文档
+├── src/
+│   └── auth/
+│       ├── index.ts          # 入口点与模块头部
+│       ├── QUICK-REF.md      # 模块快速参考
+│       └── README.md         # 模块文档
+└── CLAUDE.md                 # AI 指令文件
+```
+
+## 模块头部模板
+
+```javascript
+/**
+ * ═══════════════════════════════════════════════════════════
+ * 模块: [模块名称]
+ * ═══════════════════════════════════════════════════════════
+ *
+ * 目的: [单句描述]
+ *
+ * 依赖:
+ *   - [dep1]: [原因]
+ *   - [dep2]: [原因]
+ *
+ * 导出:
+ *   - [function1](params): [描述]
+ *   - [function2](params): [描述]
+ *
+ * 配置:
+ *   - [CONFIG_VAR]: [描述]
+ *
+ * ═══════════════════════════════════════════════════════════
+ */
+```
+
+## 详细指南
+
+完整标准请参阅：
+- [AI 友善架构标准](../../../../core/ai-friendly-architecture.md)
+
+### AI 优化格式（Token 效率）
+
+AI 助手可使用 YAML 格式文件以减少 Token 使用：
+- 基础标准：`ai/standards/ai-friendly-architecture.ai.yaml`
+
+## .ai-context.yaml 配置
+
+```yaml
+# .ai-context.yaml - AI 上下文配置
+version: 1.0.0
+
+project:
+  name: my-project
+  type: web-app  # web-app | library | cli | api | monorepo
+  primary-language: typescript
+
+modules:
+  - name: auth
+    path: src/auth/
+    entry: index.ts
+    description: 验证与授权
+    dependencies: [database, crypto]
+    priority: high
+
+  - name: api
+    path: src/api/
+    entry: routes.ts
+    description: REST API 端点
+    dependencies: [auth, database]
+    priority: high
+
+analysis-hints:
+  entry-points:
+    - src/main.ts
+    - src/index.ts
+  ignore-patterns:
+    - node_modules
+    - dist
+    - "*.test.ts"
+  architecture-type: layered
+
+documentation:
+  quick-ref: docs/QUICK-REF.md
+  detailed: docs/ARCHITECTURE.md
+  examples: docs/examples/
+```
+
+## 上下文优先顺序指南
+
+| 优先级 | 内容类型 | 原因 |
+|--------|----------|------|
+| 1 | 入口点 | 应用程序结构 |
+| 2 | .ai-context.yaml | 模块地图和依赖 |
+| 3 | QUICK-REF 文件 | 快速 API 理解 |
+| 4 | 修改的文件 | 与任务直接相关 |
+| 5 | 依赖链 | 变更的上下文 |
+
+## 应避免的反模式
+
+| 反模式 | 问题 | 解决方案 |
+|--------|------|----------|
+| **魔术字符串** | AI 无法追踪常量 | 带文档的类型常量 |
+| **隐式路由** | 隐藏行为 | 明确路由映射 |
+| **全局状态** | 不可预测的依赖 | 依赖注入 |
+| **循环依赖** | 上下文混乱 | 层级式依赖 |
+| **单体文件** | 上下文溢出 | 专注的模块 |
+
+## 实现检查清单
+
+### 快速开始（< 1 小时）
+
+- [ ] 创建 `.ai-context.yaml` 含模块清单
+- [ ] 在项目根目录添加 `QUICK-REF.md`
+- [ ] 在 README 中记录入口点
+- [ ] 为主要文件添加模块头部
+
+### 标准实现（< 1 天）
+
+- [ ] 完成 `.ai-context.yaml` 配置
+- [ ] 为每个主要模块添加 `QUICK-REF.md`
+- [ ] 记录所有公开 API 及类型信息
+- [ ] 为大型文件添加区段分隔
+
+---
+
+## 配置侦测
+
+本技能支持项目特定配置。
+
+### 侦测顺序
+
+1. 检查是否存在 `.ai-context.yaml`
+2. 检查是否存在 `QUICK-REF.md` 文件
+3. 若未找到，**建议创建 AI 友善结构**
+
+### 首次设置
+
+若未找到配置：
+
+1. 建议：「此项目尚未为 AI 协作进行配置。是否要设置 AI 友善结构？」
+2. 创建 `.ai-context.yaml` 模板
+3. 在项目根目录创建 `QUICK-REF.md`
+
+---
+
+## 相关标准
+
+- [AI 友善架构](../../../../core/ai-friendly-architecture.md) - 核心架构标准
+- [项目结构](../../../../core/project-structure.md) - 目录组织
+- [文档结构](../../../../core/documentation-structure.md) - 文档分层
+- [反幻觉](../../../../core/anti-hallucination.md) - AI 准确性标准
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2026-01-25 | 初始发布 |
+
+---
+
+## 授权
+
+本技能以 [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/ai-instruction-standards/SKILL.md

@@ -0,0 +1,214 @@
+---
+source: ../../../../skills/ai-instruction-standards/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-02-05
+status: current
+scope: partial
+description: |
+  创建和维护 AI 指令文件（CLAUDE.md、.cursorrules 等）并采用适当结构。
+  使用时机：创建 AI 指令文件、区分通用与项目特定规则、配置 AI 工具。
+  关键字：CLAUDE.md, cursorrules, windsurfrules, clinerules, AI instructions, system prompt, 指令文件, AI 设定.
+---
+
+# AI 指令文件标准指南
+
+> **语言**: [English](../../../../skills/ai-instruction-standards/SKILL.md) | 简体中文
+
+**版本**: 1.0.0
+**最后更新**: 2026-01-25
+**适用范围**: Claude Code Skills
+
+---
+
+> **核心标准**: 本技能实现 [AI 指令文件标准](../../../../core/ai-instruction-standards.md)。完整方法论文档请参阅核心标准。
+
+## 目的
+
+本技能协助创建和维护 AI 指令文件，适当区分通用标准与项目特定配置。
+
+## 快速参考
+
+### 支持的 AI 工具
+
+| AI 工具 | 指令文件 | 格式 |
+|---------|----------|------|
+| Claude Code | `CLAUDE.md` | Markdown |
+| Cursor | `.cursorrules` | Markdown |
+| Windsurf | `.windsurfrules` | Markdown |
+| Cline | `.clinerules` | Markdown |
+| GitHub Copilot | `.github/copilot-instructions.md` | Markdown |
+| OpenCode | `.opencode/instructions.md` | Markdown |
+
+### 核心原则：通用 vs 项目特定
+
+| 类型 | 包含内容 | 示例 |
+|------|----------|------|
+| **通用** | 通用规则 | 「提交前运行测试」 |
+| **项目特定** | 具体命令 | 「提交前运行 `npm test`」 |
+
+### 建议配置
+
+```markdown
+# [项目名称] - AI 指令
+
+## 通用标准
+<!-- 适用于任何项目的规则 -->
+- Commit 消息格式
+- 代码审查清单
+- 测试标准
+- 反幻觉规则
+
+---
+
+## 项目特定配置
+<!-- 此项目独有的设置 -->
+
+### 技术栈
+[你的技术在此]
+
+### 快速命令
+[你的构建/测试/部署命令]
+
+### 文件结构
+[你的项目结构]
+```
+
+## 详细指南
+
+完整标准请参阅：
+- [AI 指令文件标准](../../../../core/ai-instruction-standards.md)
+
+### AI 优化格式（Token 效率）
+
+AI 助手可使用 YAML 格式文件以减少 Token 使用：
+- 基础标准：`ai/standards/ai-instruction-standards.ai.yaml`
+
+## 内容指南
+
+### 通用内容（保持通用）
+
+| 类别 | 良好示例 |
+|------|----------|
+| **提交标准** | 「遵循 Conventional Commits 格式」 |
+| **代码审查** | 「使用 BLOCKING、IMPORTANT、SUGGESTION 前缀」 |
+| **测试** | 「维持最低 80% 覆盖率」 |
+| **AI 行为** | 「分析前务必先读取代码」 |
+
+**通用区段应避免：**
+- 特定命令（`npm test`、`pytest`）
+- 固定路径（`cli/src/`、`/var/www/`）
+- 版本号（`Node.js 18`、`Python 3.11`）
+- 项目名称和 URL
+
+### 项目特定内容
+
+| 类别 | 示例 |
+|------|------|
+| **技术栈** | Node.js 18、React 18、PostgreSQL 15 |
+| **命令** | `npm run lint`、`./scripts/deploy.sh` |
+| **文件结构** | `src/`、`cli/`、`tests/` |
+| **团队惯例** | 繁体中文注释 |
+
+## 标签惯例
+
+### 选项 A：区段标题
+
+```markdown
+## 通用标准
+[通用内容]
+
+## 项目特定配置
+[项目特定内容]
+```
+
+### 选项 B：行内标记
+
+```markdown
+> ⚠️ **项目特定**：本区段包含此项目独有的配置。
+
+### 技术栈
+...
+```
+
+### 选项 C：注释标注
+
+```markdown
+<!-- 通用：以下适用于所有项目 -->
+### Commit 消息格式
+...
+
+<!-- 项目特定：为你的项目自定义 -->
+### 快速命令
+...
+```
+
+## 多工具配置
+
+使用多个 AI 工具时，保持一致性：
+
+```
+project/
+├── CLAUDE.md              # Claude Code 指令
+├── .cursorrules           # Cursor 指令（可从 CLAUDE.md 导入）
+├── .windsurfrules         # Windsurf 指令
+└── .github/
+    └── copilot-instructions.md  # Copilot 指令
+```
+
+**最佳实践**：创建共用的 `docs/ai-standards.md` 并从各工具文件引用，避免重复。
+
+## 维护检查清单
+
+提交 AI 指令文件变更前：
+
+- [ ] 通用区段不包含项目特定的路径、命令或版本
+- [ ] 项目特定区段有明确标记
+- [ ] 标准文档的交叉引用正确
+- [ ] 格式与现有区段一致
+
+---
+
+## 配置侦测
+
+本技能支持项目特定配置。
+
+### 侦测顺序
+
+1. 检查是否存在 `CLAUDE.md` 或等效文件
+2. 分析内容结构是否区分通用/项目特定
+3. 若未找到，**建议创建结构化 AI 指令文件**
+
+### 首次设置
+
+若未找到 AI 指令文件：
+
+1. 询问：「此项目没有 AI 指令文件。是否要创建一个？」
+2. 确定项目类型和技术栈
+3. 生成包含适当区段的模板
+4. 若包含敏感信息，添加到 `.gitignore`
+
+---
+
+## 相关标准
+
+- [AI 指令文件标准](../../../../core/ai-instruction-standards.md) - 核心标准
+- [文档撰写标准](../../../../core/documentation-writing-standards.md) - 撰写指南
+- [反幻觉规范](../../../../core/anti-hallucination.md) - AI 准确性规则
+- [AI 友善架构](../../../../core/ai-friendly-architecture.md) - 上下文优化
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2026-01-25 | 初始发布 |
+
+---
+
+## 授权
+
+本技能以 [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/atdd-assistant/SKILL.md

@@ -0,0 +1,71 @@
+---
+source: ../../../../skills/atdd-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-02-10
+status: current
+description: |
+  引导验收测试驱动开发（ATDD）流程，用于定义和验证用户故事。
+  使用时机：定义验收条件、用户故事验证、ATDD 流程。
+  关键字：atdd, acceptance, user story, INVEST, 验收测试, 用户故事, 验收条件。
+---
+
+# ATDD 助手
+
+> **语言**: [English](../../../../skills/atdd-assistant/SKILL.md) | 简体中文
+
+引导验收测试驱动开发（ATDD）流程，用于定义和验证用户故事。
+
+## ATDD 循环
+
+WORKSHOP ──► DISTILLATION ──► DEVELOPMENT ──► DEMO ──► DONE
+
+## 工作流程
+
+### 1. WORKSHOP - 定义验收条件
+PO 提出用户故事，团队提出澄清问题，共同定义验收条件。
+
+### 2. DISTILLATION - 转换为测试
+将验收条件转换为可执行的测试格式，消除歧义，取得 PO 签核。
+
+### 3. DEVELOPMENT - 实现
+执行验收测试（初始应失败），使用 BDD/TDD 进行实现，迭代直到全部通过。
+
+### 4. DEMO - 向利害关系人展示
+展示通过的验收测试，演示可运作的功能，取得正式验收。
+
+### 5. DONE - 完成
+PO 已验收，代码已合并，故事已关闭。
+
+## INVEST 准则
+
+| 准则 | 说明 | Criterion | Description |
+|------|------|-----------|-------------|
+| **I**ndependent | 可独立开发 | Independent | Can be developed separately |
+| **N**egotiable | 可协商细节 | Negotiable | Details can be discussed |
+| **V**aluable | 提供商业价值 | Valuable | Delivers business value |
+| **E**stimable | 可估算工作量 | Estimable | Can estimate effort |
+| **S**mall | 一个 Sprint 可完成 | Small | Fits in one sprint |
+| **T**estable | 有明确验收条件 | Testable | Has clear acceptance criteria |
+
+## 用户故事格式
+
+```
+As a [role],
+I want [feature],
+So that [benefit].
+
+### Acceptance Criteria
+- Given [context], when [action], then [result]
+```
+
+## 使用方式
+
+- `/atdd` - 启动互动式 ATDD 会话
+- `/atdd "user can reset password"` - 针对特定功能进行 ATDD
+- `/atdd US-123` - 针对现有用户故事进行 ATDD
+
+## 参考
+
+- 详细指南：[guide.md](./guide.md)
+- 核心规范：[acceptance-test-driven-development.md](../../../../core/acceptance-test-driven-development.md)