universal-dev-standards 5.1.0 → 5.2.0
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/ai/options/push/single-owner-mode.ai.yaml +60 -0
- package/bundled/ai/options/push/team-mode.ai.yaml +64 -0
- package/bundled/ai/standards/agent-behavior-discipline.ai.yaml +142 -0
- package/bundled/ai/standards/checkin-standards.ai.yaml +18 -0
- package/bundled/ai/standards/test-governance.ai.yaml +12 -0
- package/bundled/ai/standards/testing.ai.yaml +14 -0
- package/bundled/core/agent-behavior-discipline.md +178 -0
- package/bundled/core/checkin-standards.md +21 -2
- package/bundled/core/test-governance.md +3 -0
- package/bundled/core/testing-standards.md +25 -2
- package/bundled/core/versioning.md +1 -1
- package/bundled/locales/zh-CN/CHANGELOG.md +41 -3
- package/bundled/locales/zh-CN/README.md +9 -1
- package/bundled/locales/zh-CN/SECURITY.md +8 -0
- package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +8 -0
- package/bundled/locales/zh-CN/core/checkin-standards.md +22 -3
- package/bundled/locales/zh-CN/core/test-governance.md +14 -3
- package/bundled/locales/zh-CN/core/testing-standards.md +26 -3
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +8 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +8 -0
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +8 -0
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -0
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +8 -0
- package/bundled/locales/zh-CN/skills/commands/requirement.md +8 -0
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +8 -0
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +8 -0
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +8 -0
- package/bundled/locales/zh-CN/skills/commands/reverse.md +8 -0
- package/bundled/locales/zh-CN/skills/commands/review.md +8 -0
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +8 -0
- package/bundled/locales/zh-CN/skills/commands/sdd.md +8 -0
- package/bundled/locales/zh-CN/skills/commands/tdd.md +8 -0
- package/bundled/locales/zh-CN/skills/commands/update.md +8 -0
- package/bundled/locales/zh-TW/CHANGELOG.md +41 -3
- package/bundled/locales/zh-TW/MAINTENANCE.md +17 -6
- package/bundled/locales/zh-TW/README.md +9 -1
- package/bundled/locales/zh-TW/SECURITY.md +8 -0
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +1 -1
- package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +8 -0
- package/bundled/locales/zh-TW/core/anti-hallucination.md +8 -0
- package/bundled/locales/zh-TW/core/checkin-standards.md +24 -3
- package/bundled/locales/zh-TW/core/git-workflow.md +8 -0
- package/bundled/locales/zh-TW/core/refactoring-standards.md +8 -0
- package/bundled/locales/zh-TW/core/spec-driven-development.md +8 -0
- package/bundled/locales/zh-TW/core/structured-task-definition.md +8 -0
- package/bundled/locales/zh-TW/core/test-driven-development.md +8 -0
- package/bundled/locales/zh-TW/core/test-governance.md +14 -3
- package/bundled/locales/zh-TW/core/testing-standards.md +31 -0
- package/bundled/locales/zh-TW/core/versioning.md +1 -1
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +8 -0
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +8 -0
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +8 -0
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +8 -0
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -0
- package/bundled/locales/zh-TW/docs/MIGRATION-V5.md +8 -0
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +8 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +8 -0
- package/bundled/locales/zh-TW/skills/ac-coverage-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/forward-derivation/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/methodology-system/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/process-automation/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/retrospective-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +1 -0
- package/bundled/skills/ai-collaboration-standards/SKILL.md +1 -0
- package/bundled/skills/ai-friendly-architecture/SKILL.md +1 -0
- package/bundled/skills/ai-instruction-standards/SKILL.md +1 -0
- package/bundled/skills/documentation-guide/SKILL.md +1 -0
- package/bundled/skills/error-code-guide/SKILL.md +1 -0
- package/bundled/skills/git-workflow-guide/SKILL.md +1 -0
- package/bundled/skills/logging-guide/SKILL.md +1 -0
- package/bundled/skills/project-structure-guide/SKILL.md +1 -0
- package/bundled/skills/push/SKILL.md +203 -0
- package/bundled/skills/testing-guide/SKILL.md +1 -0
- package/package.json +4 -4
- package/src/config/ai-agent-paths.js +0 -1
- package/src/utils/directory-mapper.js +2 -2
- package/standards-registry.json +15 -4
- package/bundled/locales/zh-CN/docs/AI-AGENT-ROADMAP.md +0 -410
- package/bundled/locales/zh-CN/docs/OPERATION-WORKFLOW.md +0 -1074
- package/bundled/locales/zh-TW/docs/AI-AGENT-ROADMAP.md +0 -410
- package/bundled/locales/zh-TW/docs/OPERATION-WORKFLOW.md +0 -1074
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../README.md
|
|
3
|
+
source_version: 5.1.1
|
|
4
|
+
translation_version: 5.1.1
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
# Universal Development Standards
|
|
2
10
|
|
|
3
11
|
[](https://www.npmjs.com/package/universal-dev-standards)
|
|
@@ -6,7 +14,7 @@
|
|
|
6
14
|
|
|
7
15
|
> **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
|
|
8
16
|
|
|
9
|
-
**版本**: 5.
|
|
17
|
+
**版本**: 5.2.0 | **发布日期**: 2026-04-13 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
|
|
10
18
|
|
|
11
19
|
语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流,确保不同技术栈之间的一致性、质量和可维护性。
|
|
12
20
|
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/checkin-standards.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 1.6.0
|
|
4
|
+
translation_version: 1.6.0
|
|
5
|
+
last_synced: 2026-04-20
|
|
6
6
|
status: current
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -911,6 +911,25 @@ obj/
|
|
|
911
911
|
node_modules/
|
|
912
912
|
```
|
|
913
913
|
|
|
914
|
+
### 旧版项目文件同步(project-file-sync)
|
|
915
|
+
|
|
916
|
+
> **适用范围**:.NET Framework、MSBuild `.csproj` 及任何需要显式登记文件的旧版格式。
|
|
917
|
+
|
|
918
|
+
旧版项目格式(如 `.NET Framework .csproj`)不会自动包含磁盘上的源码文件——每个文件都必须在项目 manifest 中显式列出。未登记的文件在**编译时被静默排除,不会产生任何错误或警告**。
|
|
919
|
+
|
|
920
|
+
**风险**:新增 `.cs`/`.aspx.cs` 文件后重建 DLL,该文件被排除。测试通过(测试的是旧 DLL),正式环境崩溃并显示"无法加载类型"。
|
|
921
|
+
|
|
922
|
+
**预提交检查**:
|
|
923
|
+
|
|
924
|
+
```bash
|
|
925
|
+
# 找出磁盘上未登记于 .csproj 的 .cs 文件
|
|
926
|
+
comm -23 \
|
|
927
|
+
<(find . -name "*.cs" | sort) \
|
|
928
|
+
<(grep -oP '(?<=Include=")[^"]+\.cs' MyProject.csproj | sort)
|
|
929
|
+
```
|
|
930
|
+
|
|
931
|
+
**规则**:若项目使用旧版格式,每次提交前执行磁盘与 manifest 的比对。发现未登记文件时立即失败。
|
|
932
|
+
|
|
914
933
|
---
|
|
915
934
|
|
|
916
935
|
## 常见违规与解决方案
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/test-governance.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 1.1.0
|
|
4
|
+
translation_version: 1.1.0
|
|
5
|
+
last_synced: 2026-04-20
|
|
6
6
|
status: current
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -103,6 +103,17 @@ status: current
|
|
|
103
103
|
|
|
104
104
|
---
|
|
105
105
|
|
|
106
|
+
## 规则
|
|
107
|
+
|
|
108
|
+
| ID | 触发条件 | 指令 | 优先级 |
|
|
109
|
+
|----|---------|------|--------|
|
|
110
|
+
| enforce-completion-criteria | 完成任务或功能时 | 在将任务/功能标记为完成之前,验证所有必要的完成条件已满足 | 必须 |
|
|
111
|
+
| pyramid-compliance | 规划测试策略时 | 以 70/20/7/3 金字塔比例作为指导方针。允许偏差,但需有文档记录的理由 | 必须 |
|
|
112
|
+
| sit-isolation | 运行系统测试时 | 系统测试应对外部依赖使用 Stub,但使用真实的内部服务。使用 SIT 环境进行系统级验证 | 建议 |
|
|
113
|
+
| test-execution-continuity | 新增或完成测试用例时 | 测试用例必须连接到自动化执行触发器(CI gate、build hook 或定时执行)。存在但从未执行的测试提供假信心,比没有测试更糟。在将测试覆盖率标记为完成前,请确认执行历程存在。| 必须 |
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
106
117
|
## 相关标准
|
|
107
118
|
|
|
108
119
|
- [测试标准](testing-standards.md)
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/testing-standards.md
|
|
3
|
-
source_version: 3.
|
|
4
|
-
translation_version: 3.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 3.2.0
|
|
4
|
+
translation_version: 3.2.0
|
|
5
|
+
last_synced: 2026-04-20
|
|
6
6
|
status: current
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -239,6 +239,29 @@ status: current
|
|
|
239
239
|
e2e/[feature]/[scenario].[ext]
|
|
240
240
|
```
|
|
241
241
|
|
|
242
|
+
#### E2E 前置条件范围(e2e-precondition-scope)
|
|
243
|
+
|
|
244
|
+
E2E 环境前置检查(`globalSetup`、`beforeAll`)必须验证**所有受测页面与端点**的健康状态,而非仅验证认证入口点。
|
|
245
|
+
|
|
246
|
+
**反模式** — 只验 login:
|
|
247
|
+
```ts
|
|
248
|
+
// ❌ 即使功能页返回 500 也会通过
|
|
249
|
+
await page.goto('/login');
|
|
250
|
+
expect(response.status()).toBe(200);
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
**正确模式** — 明确的覆盖列表:
|
|
254
|
+
```ts
|
|
255
|
+
// ✅ 验证套件涵盖的所有页面
|
|
256
|
+
const PAGES_UNDER_TEST = ['/login', '/dashboard', '/feature-x'];
|
|
257
|
+
for (const path of PAGES_UNDER_TEST) {
|
|
258
|
+
const res = await fetch(`${BASE_URL}${path}`);
|
|
259
|
+
expect(res.status).toBeLessThan(500); // 遇到 5xx 立即失败
|
|
260
|
+
}
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
> **证据**:真实事故 — E2E `globalSetup` 只验了 `Login.aspx`;功能页静默返回 HTTP 500。整个 E2E 套件通过,提供假信心,直到正式环境崩溃才被发现。
|
|
264
|
+
|
|
242
265
|
---
|
|
243
266
|
|
|
244
267
|
## 测试替身
|
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../docs/CLI-FLOW.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
# CLI 命令流程
|
|
2
10
|
|
|
3
11
|
> **Language**: [English](../../../docs/CLI-FLOW.md) | [繁體中文](../../zh-TW/docs/CLI-FLOW.md) | 简体中文
|
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/commands/requirement.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
---
|
|
2
10
|
description: [UDS] Write user stories and requirements following INVEST criteria
|
|
3
11
|
allowed-tools: Read, Write, Grep, Glob
|
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/commands/reverse-bdd.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
---
|
|
2
10
|
description: [UDS] Transform SDD acceptance criteria to BDD scenarios
|
|
3
11
|
allowed-tools: Read, Grep, Glob, Write
|
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/commands/reverse-sdd.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
---
|
|
2
10
|
description: [UDS] Reverse engineer code into SDD specification document
|
|
3
11
|
allowed-tools: Read, Grep, Glob, Write
|
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/commands/reverse-tdd.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
---
|
|
2
10
|
description: [UDS] Analyze BDD-TDD coverage gaps
|
|
3
11
|
allowed-tools: Read, Grep, Glob, Write
|
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/commands/review.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
---
|
|
2
10
|
description: [UDS] Perform systematic code review with checklist
|
|
3
11
|
allowed-tools: Read, Grep, Glob, Bash(git diff:*), Bash(git log:*), Bash(git show:*)
|
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/commands/sdd-retro.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
---
|
|
2
10
|
description: [UDS] Create retroactive specs for untracked feat/fix commits
|
|
3
11
|
allowed-tools: Read, Write, Grep, Glob, Bash(git log:*), Bash(git show:*), Bash(git diff:*), Bash(mkdir:*)
|
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/commands/sdd.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
---
|
|
2
10
|
description: [UDS] Create or review specification documents for Spec-Driven Development
|
|
3
11
|
allowed-tools: Read, Write, Grep, Glob, Bash(git:*), Bash(npm test:*)
|
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/commands/tdd.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: experimental
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
---
|
|
2
10
|
description: [UDS] Guide through Test-Driven Development workflow
|
|
3
11
|
allowed-tools: Read, Write, Grep, Glob, Bash(npm test:*), Bash(npx:*)
|
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../../skills/commands/update.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
---
|
|
2
10
|
description: [UDS] Update development standards to latest version
|
|
3
11
|
allowed-tools: Read, Bash(uds update:*), Bash(uds check:*), Bash(uds configure:*), Bash(npx:*), Bash(cat .standards/*), Bash(ls .claude/*), Bash(ls .opencode/*), Bash(ls .github/*)
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../CHANGELOG.md
|
|
3
|
-
source_version: 5.
|
|
4
|
-
translation_version: 5.
|
|
5
|
-
last_synced: 2026-04-
|
|
3
|
+
source_version: 5.2.0
|
|
4
|
+
translation_version: 5.2.0
|
|
5
|
+
last_synced: 2026-04-24
|
|
6
6
|
status: current
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -17,6 +17,44 @@ status: current
|
|
|
17
17
|
|
|
18
18
|
## [Unreleased]
|
|
19
19
|
|
|
20
|
+
## [5.2.0] - 2026-04-24
|
|
21
|
+
|
|
22
|
+
> **次版本發布**:三項新標準/技能(XSPEC-080/081/082)—— `/release package` 子命令、`/push` 品質守門 Skill、以及 `agent-behavior-discipline` 標準(Karpathy 四大原則:問/減/準/測)。Bundle 一致性加固。文件集中至 dev-platform。標準總數:74。
|
|
23
|
+
|
|
24
|
+
### 新增
|
|
25
|
+
- **`agent-behavior-discipline.ai.yaml`**(Trial 試驗期至 2026-10-24,XSPEC-082 / DEC-048):新治理標準,系統化整合 Andrej Karpathy 提煉的四大 AI Agent 行為紀律——問(執行前揭露假設)、減(最小充分代碼)、準(精準修改邊界)、測(定義可驗證成功標準 + 自我修正循環)。已加入 `uds-manifest.json`(第 74 個標準)及 `cli/standards-registry.json`。
|
|
26
|
+
- **`/push` Skill**(`skills/push/`,XSPEC-081):Git Push 品質守門與跨人協作護欄——受保護分支偵測、force-push 護欄、pre-push gate 驗證、push 稽核日誌、PR 整合入口。包含兩個配置選項:`options/push/single-owner-mode.ai.yaml`(單人倉庫簡化護欄)和 `options/push/team-mode.ai.yaml`(團隊全護欄,需確認)。
|
|
27
|
+
- **`/release package` 子命令**(`skills/release/`,XSPEC-080):10 種目標格式的打包指引——npm/Node.js、Python/PyPI、Go 二進位、Electron App、Homebrew(Wave 1)+ Rust/Cargo、Tauri 桌面、Docker 映像、VS Code Extension、GitHub Release 資產(Wave 2)。偵測優先設計:自動偵測專案類型再套用打包步驟。
|
|
28
|
+
|
|
29
|
+
### 修正
|
|
30
|
+
- **Bundle 一致性**(XSPEC-072 Phase 2):解決 `ai/standards/` 與 `bundle/` 之間的差異——74 個標準現在全部納入 bundle。CI 硬性失敗(exit 1)於任何差異,防止靜默的 bundle 落差。
|
|
31
|
+
- **i18n NO META frontmatter**(BUG-A06):補齊 36 個翻譯檔案缺少的 YAML frontmatter,修復翻譯同步驗證誤報。
|
|
32
|
+
|
|
33
|
+
### 變更
|
|
34
|
+
- **文件集中化(DEC-047 Batch 2)**:UDS 規劃/治理文件已遷移至 AsiaOstrich dev-platform 規劃中心,不再隨 UDS 發布:
|
|
35
|
+
- `docs/AI-AGENT-ROADMAP.md`、`docs/OPERATION-WORKFLOW.md`、`docs/internal/` 下四份文件已移除
|
|
36
|
+
- `locales/zh-TW/docs/`、`locales/zh-CN/docs/` 副本亦已移除
|
|
37
|
+
|
|
38
|
+
[5.2.0]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v5.1.1...v5.2.0
|
|
39
|
+
|
|
40
|
+
## [5.1.1] - 2026-04-20
|
|
41
|
+
|
|
42
|
+
> **修補版本**:Windows CI 修正、53 個 SKILL.md 補 `name` 欄位、三份 `.md` 源文件依 BUG-A08 事後分析新增規則、zh-TW/zh-CN 翻譯同步。
|
|
43
|
+
|
|
44
|
+
### 修正
|
|
45
|
+
- **`cli/src/utils/directory-mapper.js`**:以 `path.basename(dir)` 取代 `dir.split('/').pop()`,修正 Windows CI 路徑分隔符相容性問題(修復 Windows CI runner 上 `directory-mapper.test.js` 測試失敗)。
|
|
46
|
+
|
|
47
|
+
### 新增
|
|
48
|
+
- **`name` 欄位** 補齊至 9 個源目錄 `skills/*/SKILL.md` 及 44 個 `locales/zh-TW/skills/*/SKILL.md`,符合 Skill 驗證工具需求。
|
|
49
|
+
|
|
50
|
+
### 變更
|
|
51
|
+
- **`core/test-governance.md`** 1.0.0 → 1.1.0:新增 `test-execution-continuity` 規則(BUG-A08 事後分析 — 22 個測試存在但未連接任何 CI 執行觸發器)。
|
|
52
|
+
- **`core/checkin-standards.md`** 1.5.0 → 1.6.0:新增舊版專案檔案同步(`project-file-sync`)章節 — 磁碟上的每個源文件必須登錄於舊版專案 manifest 中。
|
|
53
|
+
- **`core/testing-standards.md`** 3.1.0 → 3.2.0:新增 E2E 前置條件範圍(`e2e-precondition-scope`)章節 — E2E 前置檢查必須驗證所有受測頁面/端點,而非僅驗證認證入口。
|
|
54
|
+
- **zh-TW 與 zh-CN 翻譯** 已同步 `test-governance.md`、`checkin-standards.md`、`testing-standards.md` 三份文件。
|
|
55
|
+
|
|
56
|
+
[5.1.1]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v5.1.0...v5.1.1
|
|
57
|
+
|
|
20
58
|
## [5.1.0] - 2026-04-20
|
|
21
59
|
|
|
22
60
|
> **正式版**:BUG-A06 i18n 完整性 — 新增 32 份缺失翻譯、Semver 感知翻譯閘門、新增 `translation-lifecycle-standards` UDS 標準。BUG-A07 Shell 測試覆蓋 — 20+ 腳本的 bats smoke tests。BUG-A08 假通過測試稽核 — 修正 22 個測試。Pre-release Batch 0:6 個標準從 Trial 升至 Adopt(DEC-021/025/031/035/038/040)。標準總數:106 個。
|
|
@@ -1,12 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../MAINTENANCE.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
# 維護指南
|
|
2
10
|
|
|
3
|
-
>
|
|
11
|
+
> **維護流程已遷至 AsiaOstrich dev-platform 規劃中心。**
|
|
12
|
+
>
|
|
13
|
+
> 自 v2.0.0 起,所有維護工作流程整合至 `OPERATION-WORKFLOW.md`;自 v5.1.1 起依 DEC-047 遷至內部規劃中心(`cross-project/ops/uds-operation.md`)。
|
|
4
14
|
>
|
|
5
|
-
>
|
|
15
|
+
> **Maintenance workflow has moved to the AsiaOstrich dev-platform planning hub.**
|
|
6
16
|
>
|
|
7
|
-
>
|
|
17
|
+
> Merged into `OPERATION-WORKFLOW.md` in v2.0.0; migrated to internal planning hub in v5.1.1 per DEC-047.
|
|
18
|
+
|
|
19
|
+
## 快速參考
|
|
8
20
|
|
|
9
|
-
|
|
21
|
+
日常維護請遵循 `CLAUDE.md` 中的驗證步驟(§Post-Modification Verification)。
|
|
10
22
|
|
|
11
|
-
- [
|
|
12
|
-
- [歸檔版本](../../docs/archive/MAINTENANCE-v1.md) — 原始獨立指南 (v1.1.0)
|
|
23
|
+
- [歸檔版本 v1.1.0](../../docs/archive/MAINTENANCE-v1.md) — 原始獨立指南
|
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../README.md
|
|
3
|
+
source_version: 5.1.1
|
|
4
|
+
translation_version: 5.1.1
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
# Universal Development Standards
|
|
2
10
|
|
|
3
11
|
[](https://www.npmjs.com/package/universal-dev-standards)
|
|
@@ -6,7 +14,7 @@
|
|
|
6
14
|
|
|
7
15
|
> **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
|
|
8
16
|
|
|
9
|
-
**版本**: 5.
|
|
17
|
+
**版本**: 5.2.0 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
|
|
10
18
|
|
|
11
19
|
語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流,確保不同技術堆疊之間的一致性、品質和可維護性。
|
|
12
20
|
|
|
@@ -280,7 +280,7 @@ description: |
|
|
|
280
280
|
- [CLAUDE.md 範本](../../../templates/CLAUDE.md.template) - 可立即使用的靜態規則範本
|
|
281
281
|
- [Claude Code Skills](../../../skills/README.md) - 技能安裝指南
|
|
282
282
|
- [採用指南](ADOPTION-GUIDE.md) - 整體採用策略
|
|
283
|
-
-
|
|
283
|
+
- 維護者流程指南 — 見內部規劃中心(`cross-project/ops/uds-operation.md`)
|
|
284
284
|
|
|
285
285
|
---
|
|
286
286
|
|
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../core/anti-hallucination.md
|
|
3
|
+
source_version: 1.5.1
|
|
4
|
+
translation_version: 1.5.1
|
|
5
|
+
last_synced: 2026-04-22
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
1
9
|
# 防幻覺規範 (Anti-Hallucination Standards)
|
|
2
10
|
|
|
3
11
|
> **語言**: [English](../../../core/anti-hallucination.md) | 繁體中文
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/checkin-standards.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 1.6.0
|
|
4
|
+
translation_version: 1.6.0
|
|
5
|
+
last_synced: 2026-04-20
|
|
6
6
|
status: current
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -913,6 +913,27 @@ node_modules/
|
|
|
913
913
|
|
|
914
914
|
---
|
|
915
915
|
|
|
916
|
+
### 舊版專案檔案同步(project-file-sync)
|
|
917
|
+
|
|
918
|
+
> **適用範圍**:.NET Framework、MSBuild `.csproj` 及任何需要明確登錄檔案的舊版格式。
|
|
919
|
+
|
|
920
|
+
舊版專案格式(如 `.NET Framework .csproj`)不會自動包含磁碟上的原始碼檔案——每個檔案都必須明確列在專案 manifest 中。未登錄的檔案在**編譯時被靜默排除,不會產生任何錯誤或警告**。
|
|
921
|
+
|
|
922
|
+
**風險**:新增 `.cs`/`.aspx.cs` 檔案後重建 DLL,該檔案被排除。測試通過(測試的是舊 DLL),正式環境崩潰並顯示「無法載入型別」。
|
|
923
|
+
|
|
924
|
+
**預提交檢查**:
|
|
925
|
+
|
|
926
|
+
```bash
|
|
927
|
+
# 找出磁碟上未登錄於 .csproj 的 .cs 檔案
|
|
928
|
+
comm -23 \
|
|
929
|
+
<(find . -name "*.cs" | sort) \
|
|
930
|
+
<(grep -oP '(?<=Include=")[^"]+\.cs' MyProject.csproj | sort)
|
|
931
|
+
```
|
|
932
|
+
|
|
933
|
+
**規則**:若專案使用舊版格式,每次提交前執行磁碟與 manifest 的比對。發現未登錄檔案時立即失敗。
|
|
934
|
+
|
|
935
|
+
---
|
|
936
|
+
|
|
916
937
|
## 常見違規與解決方案
|
|
917
938
|
|
|
918
939
|
### 違規 1: "WIP" 提交
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/test-governance.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 1.1.0
|
|
4
|
+
translation_version: 1.1.0
|
|
5
|
+
last_synced: 2026-04-20
|
|
6
6
|
status: current
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -81,6 +81,17 @@ status: current
|
|
|
81
81
|
| Staging | 整合和 E2E 測試 | DevOps |
|
|
82
82
|
| Production | 煙霧測試和監控 | SRE |
|
|
83
83
|
|
|
84
|
+
## 規則
|
|
85
|
+
|
|
86
|
+
| ID | 觸發時機 | 指令 | 優先度 |
|
|
87
|
+
|----|---------|------|--------|
|
|
88
|
+
| enforce-completion-criteria | 完成任務或功能時 | 在將任務/功能標記為完成前,驗證所有必要的完成準則已達成 | 必須 |
|
|
89
|
+
| pyramid-compliance | 規劃測試策略時 | 以 70/20/7/3 金字塔比例為指引。可接受偏差,但需有文件記錄的正當理由 | 必須 |
|
|
90
|
+
| sit-isolation | 執行系統測試時 | 系統測試應對外部相依性使用 Stub,但使用真實的內部服務。使用 SIT 環境進行系統層級的驗證 | 建議 |
|
|
91
|
+
| test-execution-continuity | 新增或完成測試案例時 | 測試案例必須連接到自動化執行觸發器(CI gate、build hook 或排程執行)。存在但從未執行的測試提供假信心,比沒有測試更糟。在將測試覆蓋率標記為完成前,請確認執行歷程存在。| 必須 |
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
84
95
|
## 相關標準
|
|
85
96
|
|
|
86
97
|
- [測試標準](testing-standards.md)
|