universal-dev-standards 5.1.1 → 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/core/agent-behavior-discipline.md +178 -0
- package/bundled/core/versioning.md +1 -1
- package/bundled/locales/zh-CN/CHANGELOG.md +23 -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/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 +23 -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/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/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/skills/push/SKILL.md +203 -0
- package/package.json +1 -1
- package/src/config/ai-agent-paths.js +0 -1
- 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: ../../../../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,26 @@ 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
|
+
|
|
20
40
|
## [5.1.1] - 2026-04-20
|
|
21
41
|
|
|
22
42
|
> **修補版本**:Windows CI 修正、53 個 SKILL.md 補 `name` 欄位、三份 `.md` 源文件依 BUG-A08 事後分析新增規則、zh-TW/zh-CN 翻譯同步。
|
|
@@ -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) | 繁體中文
|
|
@@ -242,7 +242,7 @@ CHANGELOG **不應**記錄以下類型的變更:
|
|
|
242
242
|
| 類別 | 常見目錄/檔案 | 原因 |
|
|
243
243
|
|------|--------------|------|
|
|
244
244
|
| AI 協作輔助 | `.claude/`, `.cursor/`, `.ai/` | 本地開發輔助,不納入版控 |
|
|
245
|
-
| 開發規範 | `.standards
|
|
245
|
+
| 開發規範 | `.standards/` | 本地規範文件,不納入版控 |
|
|
246
246
|
| 建置輸出 | `dist/`, `build/`, `out/` | 建置產物,不納入版控 |
|
|
247
247
|
| 大型資料 | `data/`, `datasets/` | 資料檔案,不納入版控 |
|
|
248
248
|
|
|
@@ -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-CN/docs/CLI-FLOW.md)
|
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: push
|
|
3
|
+
scope: universal
|
|
4
|
+
description: |
|
|
5
|
+
AI-assisted safety layer for git push operations with quality gates and collaboration guardrails.
|
|
6
|
+
Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches.
|
|
7
|
+
Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保護分支, 品質閘門.
|
|
8
|
+
allowed-tools: Read, Bash(git:*), Bash(npm:*), Bash(pnpm:*), Bash(yarn:*), Bash(bun:*)
|
|
9
|
+
argument-hint: "[--force] [--target <branch>] [--skip-gates] [--no-pr]"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Push Assistant | 推送助手
|
|
13
|
+
|
|
14
|
+
> **Language**: English | 繁體中文
|
|
15
|
+
|
|
16
|
+
**Version**: 1.0.0
|
|
17
|
+
**Created**: 2026-04-23
|
|
18
|
+
**Applicability**: Claude Code Skills
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
AI-assisted safety layer for `git push`. Detects protected branches, enforces force-push guardrails, runs pre-push quality gates, outputs a structured push receipt, and integrates with PR automation.
|
|
23
|
+
|
|
24
|
+
`git push` 的 AI 輔助安全層。偵測保護分支、強制 force-push 護欄、執行 pre-push 品質 gate、輸出結構化推送收據,並整合 PR 自動化。
|
|
25
|
+
|
|
26
|
+
## Core Standard | 核心標準
|
|
27
|
+
|
|
28
|
+
This skill implements [`.standards/push-standards.ai.yaml`](../../.standards/push-standards.ai.yaml).
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## Features | 功能說明
|
|
33
|
+
|
|
34
|
+
### 1. Push Target Risk Detection | 推送目標風險偵測
|
|
35
|
+
|
|
36
|
+
Before pushing, the assistant detects whether the target branch is a protected branch (e.g., `main`, `master`, `release/*`, `hotfix/*`).
|
|
37
|
+
|
|
38
|
+
推送前偵測目標分支是否為保護分支(例如 `main`、`master`、`release/*`、`hotfix/*`)。
|
|
39
|
+
|
|
40
|
+
- Displays a **warning** with branch name and commit list
|
|
41
|
+
- Requires explicit user confirmation before proceeding
|
|
42
|
+
- Aborts push if user does not confirm
|
|
43
|
+
|
|
44
|
+
### 2. Force-Push Guardrails | Force-Push 護欄
|
|
45
|
+
|
|
46
|
+
When `--force` is detected, shows the impact before allowing execution.
|
|
47
|
+
|
|
48
|
+
偵測到 `--force` 時,推送前顯示影響範圍。
|
|
49
|
+
|
|
50
|
+
- Calculates commits that will be overwritten on remote
|
|
51
|
+
- Shows count and authors of overwritten commits
|
|
52
|
+
- Requires user to type a confirmation string (`yes, force push`)
|
|
53
|
+
- Records `force_push: true` in the push receipt
|
|
54
|
+
|
|
55
|
+
### 3. Pre-Push Quality Gates | Pre-Push 品質 Gate
|
|
56
|
+
|
|
57
|
+
Runs configured quality gates in sequence before pushing.
|
|
58
|
+
|
|
59
|
+
推送前依序執行已設定的品質 gate。
|
|
60
|
+
|
|
61
|
+
| Gate | Description | 說明 |
|
|
62
|
+
|------|-------------|------|
|
|
63
|
+
| `lint` | Run project lint command | 執行 lint 檢查 |
|
|
64
|
+
| `test` | Run project test command | 執行測試 |
|
|
65
|
+
| `type-check` | TypeScript type checking (optional) | TypeScript 型別檢查(選用) |
|
|
66
|
+
| `ac-coverage` | Acceptance criteria coverage check (optional) | AC 覆蓋率檢查(選用) |
|
|
67
|
+
| `security-scan` | Security vulnerability scan (optional) | 安全掃描(選用) |
|
|
68
|
+
|
|
69
|
+
### 4. Push Receipt | 推送收據
|
|
70
|
+
|
|
71
|
+
After a successful push, outputs a structured receipt for audit trail purposes.
|
|
72
|
+
|
|
73
|
+
推送成功後輸出結構化收據,供稽核追蹤使用。
|
|
74
|
+
|
|
75
|
+
```json
|
|
76
|
+
{
|
|
77
|
+
"branch": "feature/my-feature",
|
|
78
|
+
"commit_sha": "a1b2c3d",
|
|
79
|
+
"gates_passed": ["lint", "test"],
|
|
80
|
+
"gates_skipped": false,
|
|
81
|
+
"force_push": false,
|
|
82
|
+
"timestamp": "2026-04-23T10:00:00Z",
|
|
83
|
+
"target_remote": "origin"
|
|
84
|
+
}
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
Optionally appended to `~/.uds/push-history.jsonl` for persistent audit trail.
|
|
88
|
+
|
|
89
|
+
可選擇附加到 `~/.uds/push-history.jsonl` 以持久化稽核追蹤。
|
|
90
|
+
|
|
91
|
+
### 5. PR Automation Integration | PR 自動化整合入口
|
|
92
|
+
|
|
93
|
+
After pushing a feature branch, prompts user to create a Pull Request if none exists.
|
|
94
|
+
|
|
95
|
+
推送 feature branch 後,若尚無 PR,提示使用者建立 Pull Request。
|
|
96
|
+
|
|
97
|
+
- Checks if an open PR exists for the branch
|
|
98
|
+
- Prompts user to run `pr-automation-assistant`
|
|
99
|
+
- Skipped in `single-owner` repo mode or when `--no-pr` flag is used
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## Usage | 使用方式
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
# Standard push (runs quality gates automatically)
|
|
107
|
+
/push
|
|
108
|
+
|
|
109
|
+
# Push with force (shows overwritten commits, requires confirmation)
|
|
110
|
+
/push --force
|
|
111
|
+
|
|
112
|
+
# Push to a specific remote branch
|
|
113
|
+
/push --target main
|
|
114
|
+
|
|
115
|
+
# Skip quality gates (emergency use)
|
|
116
|
+
/push --skip-gates
|
|
117
|
+
|
|
118
|
+
# Push without PR prompt
|
|
119
|
+
/push --no-pr
|
|
120
|
+
|
|
121
|
+
# Force push without PR prompt (e.g., updating a personal branch)
|
|
122
|
+
/push --force --no-pr
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## Arguments | 參數說明
|
|
126
|
+
|
|
127
|
+
| Argument | Description | 說明 |
|
|
128
|
+
|----------|-------------|------|
|
|
129
|
+
| `--force` | Enable force push with guardrail checks | 啟用 force push,含護欄確認 |
|
|
130
|
+
| `--target <branch>` | Specify target remote branch explicitly | 明確指定目標遠端分支 |
|
|
131
|
+
| `--skip-gates` | Skip pre-push quality gates (emergency only) | 跳過品質 gate(僅緊急情況) |
|
|
132
|
+
| `--no-pr` | Suppress PR automation prompt after push | 推送後不提示建立 PR |
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
|
|
136
|
+
## Configuration | 設定
|
|
137
|
+
|
|
138
|
+
Configure via `uds.project.yaml`:
|
|
139
|
+
|
|
140
|
+
```yaml
|
|
141
|
+
push:
|
|
142
|
+
repo_mode: team # "team" | "single-owner"
|
|
143
|
+
protected_branches:
|
|
144
|
+
- main
|
|
145
|
+
- master
|
|
146
|
+
- "release/*"
|
|
147
|
+
- "hotfix/*"
|
|
148
|
+
push_gates:
|
|
149
|
+
default:
|
|
150
|
+
- lint
|
|
151
|
+
- test
|
|
152
|
+
optional:
|
|
153
|
+
- type-check
|
|
154
|
+
- ac-coverage
|
|
155
|
+
- security-scan
|
|
156
|
+
receipt:
|
|
157
|
+
output: console # "console" | "file" | "both"
|
|
158
|
+
file_path: "~/.uds/push-history.jsonl"
|
|
159
|
+
auto_pr: true # prompt to create PR after push to non-protected branch
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
### Options | 選項模式
|
|
163
|
+
|
|
164
|
+
| Option File | Mode | Description | 說明 |
|
|
165
|
+
|-------------|------|-------------|------|
|
|
166
|
+
| [`options/push/team-mode.md`](../../options/push/team-mode.md) | `team` | Full collaboration guardrails (default) | 完整協作護欄(預設) |
|
|
167
|
+
| [`options/push/single-owner-mode.md`](../../options/push/single-owner-mode.md) | `single-owner` | Reduced friction for personal repos | 個人 repo 低摩擦模式 |
|
|
168
|
+
|
|
169
|
+
---
|
|
170
|
+
|
|
171
|
+
## Next Steps Guidance | 下一步引導
|
|
172
|
+
|
|
173
|
+
After `/push` completes, the AI assistant should suggest:
|
|
174
|
+
|
|
175
|
+
> **推送完成。建議下一步 / Push complete. Suggested next steps:**
|
|
176
|
+
> - 執行 `/pr-automation-assistant` 建立或更新 Pull Request ⭐ **Recommended / 推薦** — 確保協作流程完整 / Ensure complete collaboration workflow
|
|
177
|
+
> - 執行 `/checkin` 確認程式碼簽入品質 — 下次提交前的品質確認 / Quality verification before next commit
|
|
178
|
+
> - 查看 `~/.uds/push-history.jsonl` 確認推送紀錄 — 稽核追蹤 / Audit trail verification
|
|
179
|
+
|
|
180
|
+
---
|
|
181
|
+
|
|
182
|
+
## Related Standards | 相關標準
|
|
183
|
+
|
|
184
|
+
- [Push Standards](.standards/push-standards.ai.yaml) — Core push safety rules
|
|
185
|
+
- [Git Workflow](../../.standards/git-workflow.ai.yaml) — Branching strategy
|
|
186
|
+
- [Commit Message](../../.standards/commit-message.ai.yaml) — Commit conventions
|
|
187
|
+
- [PR Automation](../pr-automation-assistant/SKILL.md) — Pull Request automation
|
|
188
|
+
|
|
189
|
+
---
|
|
190
|
+
|
|
191
|
+
## Version History | 版本歷程
|
|
192
|
+
|
|
193
|
+
| Version | Date | Changes |
|
|
194
|
+
|---------|------|---------|
|
|
195
|
+
| 1.0.0 | 2026-04-23 | Initial release — XSPEC-081 Phase 1 |
|
|
196
|
+
|
|
197
|
+
---
|
|
198
|
+
|
|
199
|
+
## License | 授權
|
|
200
|
+
|
|
201
|
+
This skill is released under [MIT License](https://opensource.org/licenses/MIT) and [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
|
|
202
|
+
|
|
203
|
+
**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
|
package/package.json
CHANGED
package/standards-registry.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
-
"version": "5.
|
|
3
|
+
"version": "5.2.0",
|
|
4
4
|
"lastUpdated": "2026-04-16",
|
|
5
5
|
"description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
|
|
6
6
|
"formats": {
|
|
@@ -58,14 +58,14 @@
|
|
|
58
58
|
"standards": {
|
|
59
59
|
"name": "universal-dev-standards",
|
|
60
60
|
"url": "https://github.com/AsiaOstrich/universal-dev-standards",
|
|
61
|
-
"version": "5.
|
|
61
|
+
"version": "5.2.0"
|
|
62
62
|
},
|
|
63
63
|
"skills": {
|
|
64
64
|
"name": "universal-dev-standards",
|
|
65
65
|
"url": "https://github.com/AsiaOstrich/universal-dev-standards",
|
|
66
66
|
"localPath": "skills",
|
|
67
67
|
"rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills",
|
|
68
|
-
"version": "5.
|
|
68
|
+
"version": "5.2.0",
|
|
69
69
|
"note": "Skills are now included in the main repository under skills/"
|
|
70
70
|
}
|
|
71
71
|
},
|
|
@@ -704,6 +704,17 @@
|
|
|
704
704
|
"skillName": "ai-collaboration-standards",
|
|
705
705
|
"description": "Guidelines for AI collaboration to prevent hallucination and ensure evidence-based responses"
|
|
706
706
|
},
|
|
707
|
+
{
|
|
708
|
+
"id": "agent-behavior-discipline",
|
|
709
|
+
"name": "Agent Behavior Discipline",
|
|
710
|
+
"nameZh": "Agent 行為紀律標準",
|
|
711
|
+
"source": {
|
|
712
|
+
"human": "core/agent-behavior-discipline.md",
|
|
713
|
+
"ai": "ai/standards/agent-behavior-discipline.ai.yaml"
|
|
714
|
+
},
|
|
715
|
+
"category": "core",
|
|
716
|
+
"description": "Four behavioral disciplines for AI agents: Ask (surface assumptions), Simple (minimum code), Precision (scope only what's needed), Test (loop until verified)"
|
|
717
|
+
},
|
|
707
718
|
{
|
|
708
719
|
"id": "ai-friendly-architecture",
|
|
709
720
|
"name": "AI-Friendly Architecture",
|
|
@@ -2053,4 +2064,4 @@
|
|
|
2053
2064
|
"description": "MISSING vs OUTDATED distinction, semver-aware severity (PATCH/MINOR/MAJOR), and automation integration (pre-commit hook, release gate) for multi-locale documentation"
|
|
2054
2065
|
}
|
|
2055
2066
|
]
|
|
2056
|
-
}
|
|
2067
|
+
}
|