universal-dev-standards 5.0.0-beta.9 → 5.0.0-rc.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bundled/core/documentation-structure.md +1 -1
- package/bundled/locales/zh-CN/CLAUDE.md +3 -3
- package/bundled/locales/zh-CN/README.md +90 -330
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +10 -10
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +14 -9
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +24 -24
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +5 -5
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +3 -3
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +5 -5
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +1 -1
- package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +1 -1
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +1 -1
- package/bundled/locales/zh-CN/core/anti-hallucination.md +2 -2
- package/bundled/locales/zh-CN/core/changelog-standards.md +1 -1
- package/bundled/locales/zh-CN/core/checkin-standards.md +1 -1
- package/bundled/locales/zh-CN/core/code-review-checklist.md +1 -1
- package/bundled/locales/zh-CN/core/commit-message-guide.md +2 -2
- package/bundled/locales/zh-CN/core/developer-memory.md +1 -1
- package/bundled/locales/zh-CN/core/documentation-structure.md +1 -1
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +1 -1
- package/bundled/locales/zh-CN/core/error-code-standards.md +1 -1
- package/bundled/locales/zh-CN/core/git-workflow.md +1 -1
- package/bundled/locales/zh-CN/core/logging-standards.md +1 -1
- package/bundled/locales/zh-CN/core/project-structure.md +1 -1
- package/bundled/locales/zh-CN/core/refactoring-standards.md +1 -1
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +7 -7
- package/bundled/locales/zh-CN/core/spec-driven-development.md +8 -8
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +1 -1
- package/bundled/locales/zh-CN/core/test-driven-development.md +1 -1
- package/bundled/locales/zh-CN/core/testing-standards.md +2 -2
- package/bundled/locales/zh-CN/core/versioning.md +1 -1
- package/bundled/locales/zh-CN/docs/AI-AGENT-ROADMAP.md +2 -2
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +34 -17
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +4 -4
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +43 -24
- package/bundled/locales/zh-CN/docs/OPERATION-WORKFLOW.md +1 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +3 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +1 -1
- package/bundled/locales/zh-CN/integrations/codex/README.md +3 -3
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +4 -4
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +5 -5
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +6 -6
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +1 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +3 -3
- package/bundled/locales/zh-CN/integrations/opencode/README.md +4 -4
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +3 -3
- package/bundled/locales/zh-CN/integrations/openspec/README.md +1 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +3 -3
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +1 -1
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +2 -2
- package/bundled/locales/zh-CN/options/commit-message/english.md +2 -2
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +2 -2
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +2 -2
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +2 -2
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +2 -2
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +2 -2
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +2 -2
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +2 -2
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +2 -2
- package/bundled/locales/zh-CN/options/project-structure/go.md +2 -2
- package/bundled/locales/zh-CN/options/project-structure/java.md +2 -2
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +2 -2
- package/bundled/locales/zh-CN/options/project-structure/python.md +2 -2
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +2 -2
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +2 -2
- package/bundled/locales/zh-CN/options/testing/system-testing.md +2 -2
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +2 -2
- package/bundled/locales/zh-CN/skills/README.md +22 -11
- package/bundled/locales/zh-CN/skills/agents/README.md +8 -8
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +3 -3
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +1 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +1 -1
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +6 -6
- package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +6 -6
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +1 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +9 -9
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +1 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +1 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +9 -9
- package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +4 -4
- package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +4 -4
- package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +3 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +1 -1
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +5 -5
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +1 -1
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +3 -3
- package/bundled/locales/zh-CN/skills/forward-derivation/guide.md +3 -3
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +3 -3
- package/bundled/locales/zh-CN/skills/logging-guide/SKILL.md +3 -3
- package/bundled/locales/zh-CN/skills/project-discovery/guide.md +21 -21
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +5 -5
- package/bundled/locales/zh-CN/skills/release-standards/guide.md +3 -3
- package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +2 -2
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +1 -1
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +1 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +6 -6
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +1 -1
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +4 -4
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +4 -4
- package/bundled/locales/zh-CN/skills/testing-guide/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +2 -2
- package/bundled/locales/zh-TW/CLAUDE.md +3 -3
- package/bundled/locales/zh-TW/MAINTENANCE.md +118 -64
- package/bundled/locales/zh-TW/README.md +90 -336
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +10 -10
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +14 -9
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +24 -24
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +5 -5
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +3 -3
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +5 -5
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +1 -1
- package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +1 -1
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +1 -1
- package/bundled/locales/zh-TW/core/anti-hallucination.md +1 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +2 -2
- package/bundled/locales/zh-TW/core/checkin-standards.md +1 -1
- package/bundled/locales/zh-TW/core/code-review-checklist.md +1 -1
- package/bundled/locales/zh-TW/core/commit-message-guide.md +1 -1
- package/bundled/locales/zh-TW/core/developer-memory.md +1 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +3 -3
- package/bundled/locales/zh-TW/core/documentation-writing-standards.md +1 -1
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +3 -3
- package/bundled/locales/zh-TW/core/git-workflow.md +1 -1
- package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +6 -6
- package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +6 -6
- package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +6 -6
- package/bundled/locales/zh-TW/core/guides/testing-guide.md +8 -8
- package/bundled/locales/zh-TW/core/project-structure.md +1 -1
- package/bundled/locales/zh-TW/core/refactoring-standards.md +1 -1
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +7 -7
- package/bundled/locales/zh-TW/core/spec-driven-development.md +2 -2
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +1 -1
- package/bundled/locales/zh-TW/core/test-driven-development.md +2 -2
- package/bundled/locales/zh-TW/core/testing-standards.md +1 -1
- package/bundled/locales/zh-TW/core/versioning.md +1 -1
- package/bundled/locales/zh-TW/docs/AI-AGENT-ROADMAP.md +2 -2
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +34 -17
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +4 -4
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +43 -24
- package/bundled/locales/zh-TW/docs/OPERATION-WORKFLOW.md +1 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +3 -3
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +1 -1
- package/bundled/locales/zh-TW/integrations/codex/README.md +1 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +1 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +1 -1
- package/bundled/locales/zh-TW/integrations/opencode/README.md +1 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +3 -3
- package/bundled/locales/zh-TW/methodologies/guides/sdd-guide.md +9 -9
- package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +9 -9
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +2 -2
- package/bundled/locales/zh-TW/options/commit-message/english.md +2 -2
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +2 -2
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +2 -2
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +2 -2
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +2 -2
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +2 -2
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +2 -2
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +2 -2
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +2 -2
- package/bundled/locales/zh-TW/options/project-structure/go.md +2 -2
- package/bundled/locales/zh-TW/options/project-structure/java.md +2 -2
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +2 -2
- package/bundled/locales/zh-TW/options/project-structure/python.md +2 -2
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +2 -2
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +2 -2
- package/bundled/locales/zh-TW/options/testing/system-testing.md +2 -2
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +2 -2
- package/bundled/locales/zh-TW/skills/README.md +22 -11
- package/bundled/locales/zh-TW/skills/agents/README.md +8 -8
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +1 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +4 -4
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +1 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +1 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +4 -4
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +110 -0
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md +499 -0
- package/bundled/locales/zh-TW/skills/forward-derivation/guide.md +1 -1
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +4 -4
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -2
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +1 -1
- package/bundled/skills/README.md +4 -0
- package/bundled/skills/ai-collaboration-standards/SKILL.md +3 -3
- package/bundled/skills/brainstorm-assistant/SKILL.md +116 -0
- package/bundled/skills/brainstorm-assistant/guide.md +505 -0
- package/bundled/skills/commands/COMMAND-FAMILY-OVERVIEW.md +6 -0
- package/bundled/skills/commands/README.md +1 -0
- package/bundled/skills/commands/brainstorm.md +82 -0
- package/bundled/skills/commands/docs.md +1 -1
- package/bundled/skills/commands/requirement.md +1 -1
- package/bundled/skills/forward-derivation/SKILL.md +1 -0
- package/bundled/skills/forward-derivation/guide.md +1 -1
- package/bundled/skills/methodology-system/integrated-flow.md +45 -0
- package/bundled/skills/methodology-system/prerequisite-check.md +131 -0
- package/bundled/skills/methodology-system/runtime.md +18 -0
- package/bundled/skills/project-discovery/SKILL.md +10 -0
- package/bundled/skills/release-standards/SKILL.md +1 -0
- package/bundled/skills/reverse-engineer/SKILL.md +85 -25
- package/bundled/skills/reverse-engineer/guide.md +147 -28
- package/package.json +1 -1
- package/src/commands/agent.js +3 -9
- package/src/commands/check.js +15 -30
- package/src/commands/config.js +83 -13
- package/src/commands/list.js +3 -9
- package/src/commands/skills.js +3 -9
- package/src/commands/update.js +116 -10
- package/src/commands/workflow.js +6 -18
- package/src/config/ai-agent-paths.js +1 -0
- package/src/i18n/messages.js +177 -6
- package/src/prompts/init.js +43 -7
- package/src/utils/integration-generator.js +89 -25
- package/src/utils/skills-installer.js +146 -8
- package/standards-registry.json +8 -3
|
@@ -232,7 +232,7 @@ When you have more than 5 flow documents, `flows/README.md` is **required** and
|
|
|
232
232
|
|
|
233
233
|
1. **Define centrally** in `flows/README.md` or `DATABASE.md`
|
|
234
234
|
2. **Reference in flow docs**: List only relevant codes, with note:
|
|
235
|
-
> Complete definitions at [flows/README.md](../README.md
|
|
235
|
+
> Complete definitions at [flows/README.md](../README.md)
|
|
236
236
|
3. **Version control**: Status code changes must be recorded in CHANGELOG.md
|
|
237
237
|
|
|
238
238
|
**Status Code Definition Format**:
|
|
@@ -14,7 +14,7 @@ status: current
|
|
|
14
14
|
|
|
15
15
|
Universal Development Standards 是一个语言无关、框架无关的文件化标准框架。它提供:
|
|
16
16
|
|
|
17
|
-
- **核心规范** (`core/`):
|
|
17
|
+
- **核心规范** (`core/`):32 个基础开发标准
|
|
18
18
|
- **AI 技能** (`skills/`):用于 AI 辅助开发的 Claude Code 技能
|
|
19
19
|
- **CLI 工具** (`cli/`):用于采用标准的 Node.js CLI
|
|
20
20
|
- **整合** (`integrations/`):各种 AI 工具的配置
|
|
@@ -200,9 +200,9 @@ node cli\bin\uds.js init --help
|
|
|
200
200
|
|
|
201
201
|
```
|
|
202
202
|
universal-dev-standards/
|
|
203
|
-
├── core/ # 核心规范(
|
|
203
|
+
├── core/ # 核心规范(32 个档案)
|
|
204
204
|
├── skills/ # AI 工具技能
|
|
205
|
-
│ └── claude-code/ # Claude Code 技能(
|
|
205
|
+
│ └── claude-code/ # Claude Code 技能(26 个技能)
|
|
206
206
|
├── cli/ # Node.js CLI 工具
|
|
207
207
|
│ ├── src/ # 原始码
|
|
208
208
|
│ ├── tests/ # 测试档案
|
|
@@ -6,32 +6,23 @@
|
|
|
6
6
|
|
|
7
7
|
> **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
|
|
8
8
|
|
|
9
|
-
**版本**:
|
|
9
|
+
**版本**: 5.0.0-rc.2 (Pre-release) | **发布日期**: 2026-02-13 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流,确保不同技术栈之间的一致性、质量和可维护性。
|
|
12
12
|
|
|
13
13
|
---
|
|
14
14
|
|
|
15
|
-
##
|
|
16
|
-
|
|
17
|
-
| 类别 | 数量 | 说明 |
|
|
18
|
-
|------|------|------|
|
|
19
|
-
| **核心标准** | 22 | 通用开发准则(Markdown) |
|
|
20
|
-
| **AI Skills** | 23 | Claude Code 交互式技能 |
|
|
21
|
-
| **Slash Commands** | 24 | 快速操作(`/commit`、`/tdd`、`/review` 等) |
|
|
22
|
-
| **CLI 命令** | 6 | `list`、`init`、`configure`、`check`、`update`、`skills` |
|
|
23
|
-
| **语言支持** | 3 | 英文、繁体中文、简体中文 |
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## 快速开始
|
|
15
|
+
## 🚀 快速开始
|
|
28
16
|
|
|
29
17
|
### 通过 npm 安装(推荐)
|
|
30
18
|
|
|
31
19
|
```bash
|
|
32
|
-
#
|
|
20
|
+
# 全局安装(稳定版)
|
|
33
21
|
npm install -g universal-dev-standards
|
|
34
22
|
|
|
23
|
+
# 或安装 beta 获取最新功能
|
|
24
|
+
npm install -g universal-dev-standards@beta
|
|
25
|
+
|
|
35
26
|
# 初始化项目
|
|
36
27
|
uds init
|
|
37
28
|
```
|
|
@@ -42,365 +33,134 @@ uds init
|
|
|
42
33
|
npx universal-dev-standards init
|
|
43
34
|
```
|
|
44
35
|
|
|
45
|
-
### 手动设置
|
|
46
|
-
|
|
47
|
-
若不使用 npm 的手动设置方式,请参阅下方[安装方式](#安装方式)。
|
|
48
|
-
|
|
49
36
|
> **注意**:仅复制标准文件不会启用 AI 协助功能。请使用 `uds init` 自动配置 AI 工具,或手动在工具配置文件中引用标准。
|
|
50
37
|
|
|
51
38
|
---
|
|
52
39
|
|
|
53
|
-
##
|
|
40
|
+
## ✨ 功能特色
|
|
54
41
|
|
|
55
|
-
|
|
42
|
+
<!-- UDS_STATS_TABLE_START -->
|
|
43
|
+
| 类别 | 数量 | 说明 |
|
|
44
|
+
|----------|-------|-------------|
|
|
45
|
+
| **核心标准** | 32 | 通用开发准则 |
|
|
46
|
+
| **AI Skills** | 27 | 互动式技能 |
|
|
47
|
+
| **斜线命令** | 30 | 快速操作 |
|
|
48
|
+
| **CLI 命令** | 6 | list, init, configure, check, update, skills |
|
|
49
|
+
<!-- UDS_STATS_TABLE_END -->
|
|
56
50
|
|
|
57
|
-
|
|
58
|
-
```bash
|
|
59
|
-
npm install -g universal-dev-standards
|
|
60
|
-
uds init # 交互式初始化
|
|
61
|
-
uds check # 检查采用状态
|
|
62
|
-
uds update # 更新至最新版本
|
|
63
|
-
uds skills # 列出已安装的 skills
|
|
64
|
-
```
|
|
51
|
+
### 5.0 Beta 新功能
|
|
65
52
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
53
|
+
| 功能 | 说明 |
|
|
54
|
+
| :--- | :--- |
|
|
55
|
+
| **32 个核心标准** | 新增 10 个标准,包含安全性、性能、无障碍 |
|
|
56
|
+
| **26 Skills / 30 Commands** | 新增 `/requirement`、`/security`、`/perf` 命令 |
|
|
57
|
+
| **开发者记忆** | 跨工作会话的持久记忆(`.standards/developer-memory.ai.yaml`) |
|
|
58
|
+
| **增强 i18n** | 提交语言偏好设置、改进简体中文支持 |
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## 🏗️ 系统架构
|
|
63
|
+
|
|
64
|
+
UDS 采用 **双层执行模型 (Dual-Layer Execution Model)**,专为高速互动开发与深度技术合规而设计。
|
|
65
|
+
|
|
66
|
+
```mermaid
|
|
67
|
+
graph TD
|
|
68
|
+
A[AI 助手 / 开发者] --> B{执行层}
|
|
69
|
+
B -- "日常任务" --> C[技能层 Skills (.ai.yaml)]
|
|
70
|
+
B -- "深度审查" --> D[标准层 Standards (.md)]
|
|
71
|
+
|
|
72
|
+
C --> C1[Token 优化]
|
|
73
|
+
C --> C2[互动式引导]
|
|
74
|
+
|
|
75
|
+
D --> D1[完整理论与定义]
|
|
76
|
+
D --> D2[工具自动化配置]
|
|
77
|
+
|
|
78
|
+
C1 -. "回退机制" .-> D1
|
|
69
79
|
```
|
|
70
80
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
81
|
+
| 面向 | 技能层 Skills (执行层) | 核心标准 Standards (知识库) |
|
|
82
|
+
| :--- | :--- | :--- |
|
|
83
|
+
| **格式** | YAML 优化 | 完整 Markdown |
|
|
84
|
+
| **目标** | 高速互动与快速查询 | 深度理解与理论依据 |
|
|
85
|
+
| **Token 使用** | 极小(AI 友好) | 详细(参考文献) |
|
|
76
86
|
|
|
77
|
-
|
|
87
|
+
---
|
|
78
88
|
|
|
79
|
-
|
|
80
|
-
```bash
|
|
81
|
-
git clone https://github.com/AsiaOstrich/universal-dev-standards.git
|
|
82
|
-
cd universal-dev-standards/cli && npm install && npm link
|
|
83
|
-
```
|
|
89
|
+
## 🤖 AI 工具支持
|
|
84
90
|
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
91
|
+
| AI 工具 | 状态 | Skills | 斜线命令 | 配置文件 |
|
|
92
|
+
| :--- | :--- | :---: | :---: | :--- |
|
|
93
|
+
| **Claude Code** | ✅ 完整支持 | **26** | **30** | `CLAUDE.md` |
|
|
94
|
+
| **OpenCode** | ✅ 完整支持 | **26** | **30** | `AGENTS.md` |
|
|
95
|
+
| **Gemini CLI** | 🧪 预览版 | **18+** | **20+** | `GEMINI.md` |
|
|
96
|
+
| **Cursor** | ✅ 完整支持 | **核心** | **模拟支持** | `.cursorrules` |
|
|
97
|
+
| **Cline / Roo Code**| 🔶 部分支持 | **核心** | **工作流** | `.clinerules` |
|
|
98
|
+
| **Windsurf** | 🔶 部分支持 | ✅ | **规则书** | `.windsurfrules` |
|
|
90
99
|
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
## AI 工具支持
|
|
94
|
-
|
|
95
|
-
| AI 工具 | 状态 | Skills | Commands | 配置文件 |
|
|
96
|
-
|---------|------|:------:|:--------:|----------|
|
|
97
|
-
| **Claude Code** | ✅ 完整支持 | ✅ | 内建 | `CLAUDE.md` |
|
|
98
|
-
| **OpenCode** | ✅ 完整支持 | ✅ | ✅ | `AGENTS.md` |
|
|
99
|
-
| Cline | 🔶 部分支持 | ✅ | - | `.clinerules` |
|
|
100
|
-
| GitHub Copilot | 🔶 部分支持 | ✅ | ✅ | `copilot-instructions.md` |
|
|
101
|
-
| OpenAI Codex | 🔶 部分支持 | ✅ | - | `AGENTS.md` |
|
|
102
|
-
| Gemini CLI | 🧪 预览版 | ✅ | ✅ | `GEMINI.md` |
|
|
103
|
-
| Roo Code | ⏳ 计划中 | ✅ | ✅ | `.roorules` |
|
|
104
|
-
| Cursor | 📄 基本支持 | - | - | `.cursorrules` |
|
|
105
|
-
| Windsurf | 📄 基本支持 | - | - | `.windsurfrules` |
|
|
106
|
-
| Antigravity | 📄 基本支持 | - | - | `INSTRUCTIONS.md` |
|
|
107
|
-
|
|
108
|
-
> **状态图例**(UDS CLI 实现状态):
|
|
109
|
-
> - ✅ 完整支持 = Skills + Commands 完整支持,已测试
|
|
110
|
-
> - 🔶 部分支持 = Skills 可用,Commands 受限或不支持
|
|
111
|
-
> - 🧪 预览版 = 功能可用但为预览版本
|
|
112
|
-
> - ⏳ 计划中 = 代码存在,待测试
|
|
113
|
-
> - 📄 基本支持 = 仅规则文件生成,不支持 Skills/Commands
|
|
114
|
-
|
|
115
|
-
### 平台支持
|
|
116
|
-
|
|
117
|
-
| 平台 | 状态 | 备注 |
|
|
118
|
-
|------|------|------|
|
|
119
|
-
| **macOS** | ✅ 已测试 | 主要开发平台 |
|
|
120
|
-
| **Linux** | ⚠️ 未测试 | 预期可运行(基于 Node.js) |
|
|
121
|
-
| **Windows** | ⚠️ 未测试 | 提供 PowerShell 脚本 |
|
|
122
|
-
|
|
123
|
-
请参阅 [Windows 指南](../../docs/WINDOWS-GUIDE.md)了解平台特定说明。
|
|
100
|
+
> **状态图例**:✅ 完整支持 | 🧪 預覽版 | 🔶 部分支持 | ⏳ 计划中
|
|
124
101
|
|
|
125
102
|
---
|
|
126
103
|
|
|
127
|
-
##
|
|
104
|
+
## 📦 安装方式
|
|
128
105
|
|
|
129
|
-
###
|
|
106
|
+
### CLI 工具(主要方式)
|
|
130
107
|
|
|
108
|
+
**npm(推荐)**
|
|
131
109
|
```bash
|
|
132
|
-
|
|
110
|
+
npm install -g universal-dev-standards
|
|
111
|
+
uds init # 交互式初始化
|
|
112
|
+
uds check # 检查采用状态
|
|
113
|
+
uds update # 更新至最新版本
|
|
133
114
|
```
|
|
134
115
|
|
|
135
|
-
|
|
116
|
+
### 预发布版本 (Pre-release)
|
|
136
117
|
|
|
137
|
-
**从 v3.x 升级?**
|
|
138
118
|
```bash
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
```
|
|
119
|
+
# 安装最新 RC (Release Candidate)
|
|
120
|
+
npm install -g universal-dev-standards@rc
|
|
142
121
|
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
```bash
|
|
146
|
-
npm install -g universal-dev-standards
|
|
147
|
-
uds init # 选择 AI 工具,skills 自动安装
|
|
122
|
+
# 安装最新 Beta
|
|
123
|
+
npm install -g universal-dev-standards@beta
|
|
148
124
|
```
|
|
149
125
|
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
### 方法 3:手动安装
|
|
126
|
+
### 源码安装(开发用)
|
|
153
127
|
|
|
154
|
-
macOS / Linux:
|
|
155
128
|
```bash
|
|
156
|
-
git clone https://github.com/AsiaOstrich/universal-dev-standards.git
|
|
157
|
-
|
|
158
|
-
# 或: cp -r /tmp/uds/skills/* .claude/skills/ # 项目
|
|
159
|
-
rm -rf /tmp/uds
|
|
160
|
-
```
|
|
161
|
-
|
|
162
|
-
Windows (PowerShell):
|
|
163
|
-
```powershell
|
|
164
|
-
git clone https://github.com/AsiaOstrich/universal-dev-standards.git $env:TEMP\uds
|
|
165
|
-
Copy-Item -Recurse $env:TEMP\uds\skills\claude-code\* $env:USERPROFILE\.claude\skills\
|
|
166
|
-
Remove-Item -Recurse $env:TEMP\uds
|
|
129
|
+
git clone https://github.com/AsiaOstrich/universal-dev-standards.git
|
|
130
|
+
cd universal-dev-standards/cli && npm install && npm link
|
|
167
131
|
```
|
|
168
132
|
|
|
169
|
-
### 社区市集
|
|
170
|
-
|
|
171
|
-
- **[n-skills](https://github.com/numman-ali/n-skills)** - Claude Code、OpenCode、Cursor 精选市集
|
|
172
|
-
- **[claude-plugins.dev](https://claude-plugins.dev/skills)** - 自动索引的 skill 探索
|
|
173
|
-
- **[agentskills.io](https://agentskills.io)** - 官方 Agent Skills 规范
|
|
174
|
-
|
|
175
|
-
---
|
|
176
|
-
|
|
177
|
-
## 使用模式
|
|
178
|
-
|
|
179
|
-
| 模式 | 最适合 | 主要优势 |
|
|
180
|
-
|------|--------|----------|
|
|
181
|
-
| **仅 Skills** | 个人开发者 + Claude Code | 最低 token 使用量、最佳交互体验 |
|
|
182
|
-
| **仅标准** | 多工具团队 / 企业 | 完整自定义、版本控制 |
|
|
183
|
-
| **Skills + 标准** | 完整体验 / 学习 | 100% 功能覆盖 |
|
|
184
|
-
|
|
185
|
-
### 快速决策指南
|
|
186
|
-
|
|
187
|
-
- **个人项目使用 Claude Code?** → 仅 Skills
|
|
188
|
-
- **团队使用多个 AI 工具?** → Skills + 标准
|
|
189
|
-
- **企业合规需求?** → 仅标准
|
|
190
|
-
|
|
191
|
-
详细分析请参阅[使用模式比较](../../docs/USAGE-MODES-COMPARISON.md)。
|
|
192
|
-
|
|
193
|
-
---
|
|
194
|
-
|
|
195
|
-
## 核心标准概览
|
|
196
|
-
|
|
197
|
-
### Level 1:基本(30 分钟设置)
|
|
198
|
-
|
|
199
|
-
每个项目必须包含:
|
|
200
|
-
|
|
201
|
-
| 标准 | 说明 |
|
|
202
|
-
|------|------|
|
|
203
|
-
| `anti-hallucination.md` | AI 协作准则 |
|
|
204
|
-
| `checkin-standards.md` | 提交前质量检查 |
|
|
205
|
-
| `commit-message-guide.md` | Conventional Commits 格式 |
|
|
206
|
-
| `spec-driven-development.md` | 规格优先方法 |
|
|
207
|
-
|
|
208
|
-
### Level 2:推荐(2 小时设置)
|
|
209
|
-
|
|
210
|
-
包含 Level 1 加上:
|
|
211
|
-
|
|
212
|
-
| 标准 | 说明 |
|
|
213
|
-
|------|------|
|
|
214
|
-
| `git-workflow.md` | 分支策略(GitHub Flow、GitFlow、Trunk-Based) |
|
|
215
|
-
| `code-review-checklist.md` | 系统化审查准则 |
|
|
216
|
-
| `versioning.md` | 语义化版本(SemVer) |
|
|
217
|
-
| `changelog-standards.md` | Keep a Changelog 格式 |
|
|
218
|
-
| `testing-standards.md` | 测试金字塔(70/20/7/3) |
|
|
219
|
-
| `test-driven-development.md` | TDD 方法论 |
|
|
220
|
-
| `behavior-driven-development.md` | BDD 与 Given-When-Then |
|
|
221
|
-
|
|
222
|
-
### Level 3:全面(1-2 天设置)
|
|
223
|
-
|
|
224
|
-
包含 Level 2 加上:
|
|
225
|
-
|
|
226
|
-
| 标准 | 说明 |
|
|
227
|
-
|------|------|
|
|
228
|
-
| `documentation-structure.md` | 文档组织 |
|
|
229
|
-
| `project-structure.md` | 目录惯例 |
|
|
230
|
-
| `acceptance-test-driven-development.md` | ATDD 方法论 |
|
|
231
|
-
| `refactoring-standards.md` | 安全重构实务 |
|
|
232
|
-
|
|
233
|
-
完整指引请参阅[采用指南](../../adoption/ADOPTION-GUIDE.md)。
|
|
234
|
-
|
|
235
133
|
---
|
|
236
134
|
|
|
237
|
-
##
|
|
238
|
-
|
|
239
|
-
### 自定义文件位置
|
|
240
|
-
|
|
241
|
-
| 类型 | 文件 | 位置 |
|
|
242
|
-
|------|------|------|
|
|
243
|
-
| AI 工具规则 | `CLAUDE.md`、`.cursorrules` 等 | 项目根目录 |
|
|
244
|
-
| 项目覆盖 | `PROJECT-STANDARDS.md` | 项目根目录 |
|
|
245
|
-
| 复制的标准 | `docs/standards/` | 您的项目 |
|
|
246
|
-
|
|
247
|
-
### 调整标准
|
|
135
|
+
## ⚙️ 设置
|
|
248
136
|
|
|
249
|
-
|
|
250
|
-
2. **工具**:配置构建命令(`npm`、`dotnet`、`mvn` 等)
|
|
251
|
-
3. **阈值**:调整测试覆盖率、方法长度限制
|
|
252
|
-
4. **范围**:定义模块允许的提交范围
|
|
137
|
+
使用 `uds config` 管理您的偏好设置:
|
|
253
138
|
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
139
|
+
| 参数 | 命令示例 | 说明 |
|
|
140
|
+
| :--- | :--- | :--- |
|
|
141
|
+
| **提交语言** | `uds config --lang zh-CN` | 设置 AI 提交消息的偏好语言 |
|
|
142
|
+
| **标准等级** | `uds init --level 2` | 选择采用深度 (1: 基本, 3: 全面) |
|
|
143
|
+
| **工具模式** | `uds config --mode skills` | 在 Skills、Standards 或两者之间切换 |
|
|
259
144
|
|
|
260
145
|
---
|
|
261
146
|
|
|
262
|
-
## 贡献
|
|
263
|
-
|
|
264
|
-
### 如何贡献
|
|
265
|
-
|
|
266
|
-
1. **建议改进**:开立 issue 说明问题与解决方案
|
|
267
|
-
2. **添加示例**:提交实际使用示例
|
|
268
|
-
3. **扩展标准**:贡献语言/框架/领域扩展
|
|
269
|
-
4. **翻译**:协助翻译成其他语言
|
|
147
|
+
## 👥 贡献
|
|
270
148
|
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
- 至少在 2 个不同情境中包含示例
|
|
275
|
-
- 遵循现有文档结构
|
|
276
|
-
- 采用 CC BY 4.0 授权
|
|
149
|
+
1. **建议改进**:开立 issue 说明问题与解决方案。
|
|
150
|
+
2. **添加示例**:提交实际使用示例。
|
|
151
|
+
3. **扩展标准**:贡献语言/框架/领域扩展。
|
|
277
152
|
|
|
278
153
|
详细准则请参阅 [CONTRIBUTING.md](../../CONTRIBUTING.md)。
|
|
279
154
|
|
|
280
155
|
---
|
|
281
156
|
|
|
282
|
-
##
|
|
283
|
-
|
|
284
|
-
### 如何选择「仅 Skills」还是「仅标准」?
|
|
285
|
-
|
|
286
|
-
- **仅 Skills**:最适合使用 Claude Code 的个人开发者,想要以最少设置获得交互式 AI 协助
|
|
287
|
-
- **仅标准**:最适合使用多个 AI 工具或需要企业合规与完整版本控制的团队
|
|
288
|
-
|
|
289
|
-
### 可以只采用部分标准吗?
|
|
290
|
-
|
|
291
|
-
可以!执行 `uds init` 并选择需要的标准。也可以从 `core/` 手动复制特定文件。
|
|
292
|
-
|
|
293
|
-
### 如何更新已安装的 skills?
|
|
294
|
-
|
|
295
|
-
Plugin Marketplace:Skills 会自动更新或使用 `/plugin update`。
|
|
296
|
-
CLI 安装:执行 `uds update --skills`。
|
|
297
|
-
|
|
298
|
-
### UDS 支持 Windows 吗?
|
|
157
|
+
## 📄 授权
|
|
299
158
|
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
- **核心标准**:定义最佳实务的文档(Markdown)- 参考资料
|
|
305
|
-
- **Skills**:实现这些标准的交互式 AI 命令 - 主动协助
|
|
306
|
-
|
|
307
|
-
### 为什么有些 AI 工具标示为「计划中」?
|
|
308
|
-
|
|
309
|
-
我们提供这些工具的配置文件,但完整集成测试尚待进行。配置应该可以运行,但可能存在边缘案例。
|
|
159
|
+
| 组件 | 授权 |
|
|
160
|
+
| :--- | :--- |
|
|
161
|
+
| **文档内容** | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
|
|
162
|
+
| **CLI 工具** | [MIT](../../cli/LICENSE) |
|
|
310
163
|
|
|
311
164
|
---
|
|
312
165
|
|
|
313
|
-
## 延伸阅读
|
|
314
|
-
|
|
315
|
-
### 相关标准
|
|
316
|
-
|
|
317
|
-
- [Conventional Commits](https://www.conventionalcommits.org/)
|
|
318
|
-
- [Semantic Versioning](https://semver.org/)
|
|
319
|
-
- [Keep a Changelog](https://keepachangelog.com/)
|
|
320
|
-
- [Google Engineering Practices](https://google.github.io/eng-practices/)
|
|
321
|
-
|
|
322
|
-
### 推荐书籍
|
|
323
|
-
|
|
324
|
-
- **The Art of Readable Code** - Boswell & Foucher
|
|
325
|
-
- **Clean Code** - Robert C. Martin
|
|
326
|
-
- **The Pragmatic Programmer** - Hunt & Thomas
|
|
327
|
-
- **Accelerate** - Forsgren, Humble & Kim
|
|
328
|
-
|
|
329
|
-
---
|
|
330
|
-
|
|
331
|
-
## 版本历史
|
|
332
|
-
|
|
333
|
-
| 版本 | 日期 | 重点 |
|
|
334
|
-
|------|------|------|
|
|
335
|
-
| **4.1.0** | 2026-01-21 | 增强重构标准 |
|
|
336
|
-
| **4.0.0** | 2026-01-20 | 双向推导;6 个新核心标准 |
|
|
337
|
-
| 3.5.0 | 2026-01-15 | 多代理 Skills;Gemini CLI;i18n |
|
|
338
|
-
| 3.2.2 | 2026-01-06 | `uds skills` 命令 |
|
|
339
|
-
| 3.0.0 | 2025-12-30 | Windows 支持;npm 发布 |
|
|
340
|
-
|
|
341
|
-
完整历史请参阅 [CHANGELOG.md](../../CHANGELOG.md)。
|
|
342
|
-
|
|
343
|
-
---
|
|
344
|
-
|
|
345
|
-
## 4.x 新功能
|
|
346
|
-
|
|
347
|
-
### 4.1.0 重点
|
|
348
|
-
|
|
349
|
-
- 增强重构标准,包含战术、策略和遗留代码安全策略
|
|
350
|
-
- 选择重构方法的决策矩阵
|
|
351
|
-
|
|
352
|
-
### 4.0.0 重点
|
|
353
|
-
|
|
354
|
-
| 功能 | 说明 |
|
|
355
|
-
|------|------|
|
|
356
|
-
| **双向推导** | Forward Derivation + Reverse Engineering 实现完整规格-代码生命周期 |
|
|
357
|
-
| **6 个新核心标准** | BDD、ATDD、Reverse Engineering、Forward Derivation、AI Instructions、Refactoring |
|
|
358
|
-
| **23 Skills** | 7 个新 skills 包括 Forward Derivation、BDD/ATDD assistants |
|
|
359
|
-
| **24 Slash Commands** | 9 个新命令(`/derive-*`、`/reverse-*`、`/atdd`、`/bdd`) |
|
|
360
|
-
| **方法论系统** | TDD/BDD/SDD/ATDD 工作流已达生产就绪 |
|
|
361
|
-
|
|
362
|
-
---
|
|
363
|
-
|
|
364
|
-
## 授权
|
|
365
|
-
|
|
366
|
-
| 组件 | 授权 | 允许 |
|
|
367
|
-
|------|------|------|
|
|
368
|
-
| 文档 | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) | 商业使用、修改、带署名的再发布 |
|
|
369
|
-
| CLI 工具 | [MIT](../../cli/LICENSE) | 商业使用、修改、再发布 |
|
|
370
|
-
|
|
371
|
-
完整详情请参阅 [LICENSE](../../LICENSE)。
|
|
372
|
-
|
|
373
|
-
---
|
|
374
|
-
|
|
375
|
-
## 目录结构
|
|
376
|
-
|
|
377
|
-
```
|
|
378
|
-
universal-dev-standards/
|
|
379
|
-
├── core/ # 核心标准(22 个文件)
|
|
380
|
-
│ ├── anti-hallucination.md
|
|
381
|
-
│ ├── commit-message-guide.md
|
|
382
|
-
│ ├── testing-standards.md
|
|
383
|
-
│ └── ...
|
|
384
|
-
├── ai/ # AI 优化格式(.ai.yaml)
|
|
385
|
-
├── skills/ # AI 工具 skills
|
|
386
|
-
│ └── claude-code/ # 23 个 skill 目录
|
|
387
|
-
├── extensions/ # 语言/框架扩展
|
|
388
|
-
│ ├── languages/ # csharp-style.md、php-style.md
|
|
389
|
-
│ └── frameworks/ # fat-free-patterns.md
|
|
390
|
-
├── integrations/ # AI 工具配置
|
|
391
|
-
│ ├── cursor/ # .cursorrules
|
|
392
|
-
│ ├── windsurf/ # .windsurfrules
|
|
393
|
-
│ └── ...
|
|
394
|
-
├── cli/ # CLI 工具(uds 命令)
|
|
395
|
-
├── locales/ # 翻译
|
|
396
|
-
│ ├── zh-TW/ # 繁体中文
|
|
397
|
-
│ └── zh-CN/ # 简体中文
|
|
398
|
-
├── templates/ # 文档模板
|
|
399
|
-
└── adoption/ # 采用指南
|
|
400
|
-
```
|
|
401
|
-
|
|
402
|
-
---
|
|
403
|
-
|
|
404
|
-
**准备好提升项目品质了吗?** 从[快速开始](#快速开始)开始!
|
|
405
|
-
|
|
406
166
|
**由开源社区用 ❤️ 维护**
|
|
@@ -8,7 +8,7 @@ status: current
|
|
|
8
8
|
|
|
9
9
|
# 规范采用指南
|
|
10
10
|
|
|
11
|
-
> **语言**: [English](
|
|
11
|
+
> **语言**: [English](../../../adoption/ADOPTION-GUIDE.md) | 繁体中文
|
|
12
12
|
>
|
|
13
13
|
> 版本 1.0.0
|
|
14
14
|
|
|
@@ -58,7 +58,7 @@ status: current
|
|
|
58
58
|
- `checkin-standards.md` - 建置、测试、覆盖率门槛
|
|
59
59
|
- `project-structure.md` - 目录惯例
|
|
60
60
|
|
|
61
|
-
**部署方式**:加入 `CLAUDE.md` 或 `.cursorrules`。请参阅 [CLAUDE.md.template](
|
|
61
|
+
**部署方式**:加入 `CLAUDE.md` 或 `.cursorrules`。请参阅 [CLAUDE.md.template](../../../templates/CLAUDE.md.template)。
|
|
62
62
|
|
|
63
63
|
### 动态规范
|
|
64
64
|
|
|
@@ -76,7 +76,7 @@ status: current
|
|
|
76
76
|
|
|
77
77
|
**部署方式**:通过 Plugin Marketplace 或手动复制安装为 Skills。
|
|
78
78
|
|
|
79
|
-
> 详细分类请参阅 [STATIC-DYNAMIC-GUIDE.md](
|
|
79
|
+
> 详细分类请参阅 [STATIC-DYNAMIC-GUIDE.md](../../../adoption/STATIC-DYNAMIC-GUIDE.md)。
|
|
80
80
|
|
|
81
81
|
---
|
|
82
82
|
|
|
@@ -196,7 +196,7 @@ Copy-Item <source-file> .standards\
|
|
|
196
196
|
- [ ] checkin-standards.md (参考文件)
|
|
197
197
|
- [ ] spec-driven-development.md (参考文件)
|
|
198
198
|
|
|
199
|
-
详细检查清单请参阅 [checklists/minimal.md](
|
|
199
|
+
详细检查清单请参阅 [checklists/minimal.md](../../../adoption/checklists/minimal.md)。
|
|
200
200
|
|
|
201
201
|
### 等级二:推荐
|
|
202
202
|
|
|
@@ -210,7 +210,7 @@ Copy-Item <source-file> .standards\
|
|
|
210
210
|
- [ ] 适用的延伸规范
|
|
211
211
|
- [ ] AI 工具整合
|
|
212
212
|
|
|
213
|
-
详细检查清单请参阅 [checklists/recommended.md](
|
|
213
|
+
详细检查清单请参阅 [checklists/recommended.md](../../../adoption/checklists/recommended.md)。
|
|
214
214
|
|
|
215
215
|
### 等级三:企业
|
|
216
216
|
|
|
@@ -222,7 +222,7 @@ Copy-Item <source-file> .standards\
|
|
|
222
222
|
- [ ] project-structure.md (参考文件)
|
|
223
223
|
- [ ] migration-template.md (如适用)
|
|
224
224
|
|
|
225
|
-
详细检查清单请参阅 [checklists/enterprise.md](
|
|
225
|
+
详细检查清单请参阅 [checklists/enterprise.md](../../../adoption/checklists/enterprise.md)。
|
|
226
226
|
|
|
227
227
|
---
|
|
228
228
|
|
|
@@ -377,7 +377,7 @@ Copy-Item path\to\universal-dev-standards\integrations\github-copilot\copilot-in
|
|
|
377
377
|
|
|
378
378
|
## 机器可读注册表
|
|
379
379
|
|
|
380
|
-
工具和自动化请参阅 [standards-registry.json](
|
|
380
|
+
工具和自动化请参阅 [standards-registry.json](../../../adoption/standards-registry.json)。
|
|
381
381
|
|
|
382
382
|
此 JSON 档案包含所有规范、类别和采用方法的完整对照。
|
|
383
383
|
|
|
@@ -387,6 +387,6 @@ Copy-Item path\to\universal-dev-standards\integrations\github-copilot\copilot-in
|
|
|
387
387
|
|
|
388
388
|
- [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards) - 来源储存库
|
|
389
389
|
- [universal-dev-skills](https://github.com/AsiaOstrich/universal-dev-skills) - Skills 储存库
|
|
390
|
-
- [最小检查清单](
|
|
391
|
-
- [推荐检查清单](
|
|
392
|
-
- [企业检查清单](
|
|
390
|
+
- [最小检查清单](../../../adoption/checklists/minimal.md) - 等级一采用检查清单
|
|
391
|
+
- [推荐检查清单](../../../adoption/checklists/recommended.md) - 等级二采用检查清单
|
|
392
|
+
- [企业检查清单](../../../adoption/checklists/enterprise.md) - 等级三采用检查清单
|
|
@@ -11,7 +11,7 @@ status: current
|
|
|
11
11
|
**版本**: 1.1.0
|
|
12
12
|
**最后更新**: 2026-02-10
|
|
13
13
|
|
|
14
|
-
> **语言**: [English](
|
|
14
|
+
> **语言**: [English](../../../adoption/DAILY-WORKFLOW-GUIDE.md) | [繁體中文](../../zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md) | 简体中文
|
|
15
15
|
|
|
16
16
|
本指南说明在执行 `uds init` 后,如何在日常开发工作流程中使用 Universal Development Standards。
|
|
17
17
|
|
|
@@ -372,6 +372,11 @@ test('should reject email without domain', () => {
|
|
|
372
372
|
| `/commit` | 生成规范的 commit message | 提交代码 |
|
|
373
373
|
| `/review` | 启动代码审查 | 审查 PR |
|
|
374
374
|
| `/requirement` | 撰写需求文档 | 定义 User Story |
|
|
375
|
+
| `/checkin` | 提交前质量验证 | 提交代码前 |
|
|
376
|
+
| `/changelog` | 生成变更日志条目 | 准备发布期间 |
|
|
377
|
+
| `/coverage` | 分析测试覆盖率 | 评估测试质量 |
|
|
378
|
+
| `/docs` | 管理文档 | 撰写/更新文档 |
|
|
379
|
+
| `/release` | 引导发布流程 | 准备发布 |
|
|
375
380
|
|
|
376
381
|
---
|
|
377
382
|
|
|
@@ -495,14 +500,14 @@ test('should reject email without domain', () => {
|
|
|
495
500
|
|
|
496
501
|
- [采用指南](ADOPTION-GUIDE.md) - 如何安装 UDS
|
|
497
502
|
- [专案现况评估](../../../skills/project-discovery/SKILL.md) - Phase 0 专案评估
|
|
498
|
-
- [反向工程标准](
|
|
499
|
-
- [重构标准](
|
|
500
|
-
- [测试驱动开发](
|
|
501
|
-
- [行为驱动开发](
|
|
502
|
-
- [验收测试驱动开发](
|
|
503
|
-
- [规格驱动开发](
|
|
504
|
-
- [提交规范](
|
|
505
|
-
- [代码审查清单](
|
|
503
|
+
- [反向工程标准](../../../core/reverse-engineering-standards.md) - 反向工程工作流程
|
|
504
|
+
- [重构标准](../../../core/refactoring-standards.md) - 重构工作流程
|
|
505
|
+
- [测试驱动开发](../../../core/test-driven-development.md) - TDD 标准(包含 Golden Master Testing)
|
|
506
|
+
- [行为驱动开发](../../../core/behavior-driven-development.md) - BDD 工作流程
|
|
507
|
+
- [验收测试驱动开发](../../../core/acceptance-test-driven-development.md) - ATDD 工作流程
|
|
508
|
+
- [规格驱动开发](../../../core/spec-driven-development.md) - SDD 工作流程
|
|
509
|
+
- [提交规范](../../../core/checkin-standards.md) - 代码提交要求
|
|
510
|
+
- [代码审查清单](../../../core/code-review-checklist.md) - 审查流程
|
|
506
511
|
|
|
507
512
|
---
|
|
508
513
|
|