universal-dev-standards 6.0.0 → 6.1.1
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/commit-message/bilingual.ai.yaml +19 -1
- package/bundled/ai/standards/checkin-standards.ai.yaml +3 -3
- package/bundled/ai/standards/documentation-writing-standards.ai.yaml +1 -1
- package/bundled/ai/standards/frontend-design-standards.ai.yaml +33 -3
- package/bundled/ai/standards/push-standards.ai.yaml +14 -3
- package/bundled/ai/standards/requirement-engineering.ai.yaml +42 -3
- package/bundled/ai/standards/self-review-protocol.ai.yaml +15 -10
- package/bundled/ai/standards/verification-evidence.ai.yaml +88 -5
- package/bundled/core/checkin-standards.md +3 -3
- package/bundled/core/documentation-writing-standards.md +1 -1
- package/bundled/core/feature-discovery-standards.md +191 -0
- package/bundled/core/frontend-design-standards.md +93 -4
- package/bundled/core/multi-environment-e2e-testing.md +195 -0
- package/bundled/core/push-standards.md +82 -0
- package/bundled/core/requirement-engineering.md +2 -2
- package/bundled/core/self-review-protocol.md +13 -8
- package/bundled/core/verification-evidence.md +170 -10
- package/bundled/locales/COVERAGE.md +27 -21
- package/bundled/locales/zh-CN/CHANGELOG.md +38 -3
- package/bundled/locales/zh-CN/CLAUDE.md +1 -1
- package/bundled/locales/zh-CN/MAINTENANCE.md +42 -661
- package/bundled/locales/zh-CN/README.md +10 -10
- package/bundled/locales/zh-CN/SECURITY.md +2 -2
- package/bundled/locales/zh-CN/ai/options/commit-message/bilingual.ai.yaml +6 -1
- package/bundled/locales/zh-CN/core/browser-compatibility-standards.md +17 -7
- package/bundled/locales/zh-CN/core/cost-budget-test.md +1 -1
- package/bundled/locales/zh-CN/core/cross-flow-regression.md +8 -7
- package/bundled/locales/zh-CN/core/flaky-test-management.md +1 -1
- package/bundled/locales/zh-CN/core/flow-based-testing.md +8 -8
- package/bundled/locales/zh-CN/core/frontend-design-standards.md +1 -1
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +74 -2
- package/bundled/locales/zh-CN/core/license-compliance.md +3 -1
- package/bundled/locales/zh-CN/core/logging-standards.md +83 -7
- package/bundled/locales/zh-CN/core/mock-boundary.md +58 -6
- package/bundled/locales/zh-CN/core/packaging-standards.md +2 -1
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +24 -4
- package/bundled/locales/zh-CN/core/prompt-regression.md +1 -1
- package/bundled/locales/zh-CN/core/replay-test.md +1 -1
- package/bundled/locales/zh-CN/core/requirement-engineering.md +1 -1
- package/bundled/locales/zh-CN/core/security-testing.md +24 -7
- package/bundled/locales/zh-CN/core/self-review-protocol.md +17 -12
- package/bundled/locales/zh-CN/core/smoke-test.md +1 -1
- package/bundled/locales/zh-CN/core/verification-evidence.md +252 -41
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +6 -2
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +16 -25
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +1 -1
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +10 -3
- package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +21 -19
- package/bundled/locales/zh-CN/skills/brainstorm-assistant/guide.md +14 -11
- package/bundled/locales/zh-CN/skills/dev-methodology/guide.md +1 -1
- package/bundled/locales/zh-CN/skills/logging-guide/SKILL.md +29 -6
- package/bundled/locales/zh-CN/skills/spec-derivation/guide.md +1 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +38 -3
- package/bundled/locales/zh-TW/CLAUDE.md +1 -1
- package/bundled/locales/zh-TW/MAINTENANCE.md +32 -8
- package/bundled/locales/zh-TW/README.md +10 -10
- package/bundled/locales/zh-TW/SECURITY.md +2 -2
- package/bundled/locales/zh-TW/ai/options/commit-message/bilingual.ai.yaml +6 -1
- package/bundled/locales/zh-TW/core/cost-budget-test.md +1 -1
- package/bundled/locales/zh-TW/core/flaky-test-management.md +1 -1
- package/bundled/locales/zh-TW/core/flow-based-testing.md +8 -8
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +1 -1
- package/bundled/locales/zh-TW/core/license-compliance.md +3 -1
- package/bundled/locales/zh-TW/core/logging-standards.md +2 -2
- package/bundled/locales/zh-TW/core/mock-boundary.md +1 -1
- package/bundled/locales/zh-TW/core/packaging-standards.md +2 -1
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +24 -4
- package/bundled/locales/zh-TW/core/prompt-regression.md +1 -1
- package/bundled/locales/zh-TW/core/replay-test.md +1 -1
- package/bundled/locales/zh-TW/core/requirement-engineering.md +1 -1
- package/bundled/locales/zh-TW/core/security-testing.md +24 -7
- package/bundled/locales/zh-TW/core/self-review-protocol.md +16 -11
- package/bundled/locales/zh-TW/core/smoke-test.md +1 -1
- package/bundled/locales/zh-TW/core/verification-evidence.md +260 -31
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +6 -2
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +16 -25
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +1 -1
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +10 -3
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +21 -19
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md +14 -11
- package/bundled/locales/zh-TW/skills/dev-methodology/guide.md +1 -1
- package/bundled/locales/zh-TW/skills/logging-guide/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/spec-derivation/guide.md +1 -1
- package/bundled/skills/brainstorm-assistant/SKILL.md +22 -20
- package/bundled/skills/brainstorm-assistant/guide.md +10 -7
- package/bundled/skills/spec-driven-dev/SKILL.md +11 -0
- package/package.json +3 -3
- package/src/commands/check.js +23 -13
- package/src/commands/init.js +58 -17
- package/src/i18n/messages.js +6 -6
- package/standards-registry.json +10 -10
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../README.md
|
|
3
|
-
source_version:
|
|
4
|
-
translation_version:
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
source_hash:
|
|
3
|
+
source_version: 6.0.0
|
|
4
|
+
translation_version: 6.0.0
|
|
5
|
+
last_synced: 2026-07-08
|
|
6
|
+
source_hash: add024721b5a
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -15,7 +15,7 @@ status: current
|
|
|
15
15
|
|
|
16
16
|
> **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
|
|
17
17
|
|
|
18
|
-
**版本**: 6.
|
|
18
|
+
**版本**: 6.1.1 | **發布日期**: 2026-07-18 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
|
|
19
19
|
|
|
20
20
|
語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流,確保不同技術堆疊之間的一致性、品質和可維護性。
|
|
21
21
|
|
|
@@ -62,7 +62,7 @@ npx universal-dev-standards init
|
|
|
62
62
|
| 我想要... | 文件 |
|
|
63
63
|
|---|---|
|
|
64
64
|
| **UDS 新手?** 5 分鐘快速入門 | [docs/user/GETTING-STARTED.md](../../docs/user/GETTING-STARTED.md) |
|
|
65
|
-
| 依 Tier 和分類瀏覽所有
|
|
65
|
+
| 依 Tier 和分類瀏覽所有 55 個 Skills | [docs/user/SKILLS-INDEX.md](../../docs/user/SKILLS-INDEX.md) |
|
|
66
66
|
| 查看所有斜線命令 | [docs/user/COMMANDS-INDEX.md](../../docs/user/COMMANDS-INDEX.md) |
|
|
67
67
|
| 快速參考卡 | [docs/user/CHEATSHEET.md](../../docs/user/CHEATSHEET.md) |
|
|
68
68
|
| 常見問題 | [docs/user/FAQ.md](../../docs/user/FAQ.md) |
|
|
@@ -76,10 +76,10 @@ npx universal-dev-standards init
|
|
|
76
76
|
<!-- UDS_STATS_TABLE_START -->
|
|
77
77
|
| 類別 | 數量 | 說明 |
|
|
78
78
|
|----------|-------|-------------|
|
|
79
|
-
| **核心標準** |
|
|
79
|
+
| **核心標準** | 149 | 通用開發準則 |
|
|
80
80
|
| **AI Skills** | 55 | 互動式技能 |
|
|
81
81
|
| **斜線命令** | 51 | 快速操作 |
|
|
82
|
-
| **CLI 指令** |
|
|
82
|
+
| **CLI 指令** | 21 | 專案設定與維護 |
|
|
83
83
|
<!-- UDS_STATS_TABLE_END -->
|
|
84
84
|
|
|
85
85
|
> **5.0 新功能?** 請參閱[預發布說明](../../docs/PRE-RELEASE.md)了解新功能詳情。
|
|
@@ -117,8 +117,8 @@ graph TD
|
|
|
117
117
|
|
|
118
118
|
| AI 工具 | 狀態 | Skills | 斜線命令 | 設定檔 |
|
|
119
119
|
| :--- | :--- | :---: | :---: | :--- |
|
|
120
|
-
| **Claude Code** | ✅ 完整支援 | **
|
|
121
|
-
| **OpenCode** | ✅ 完整支援 | **
|
|
120
|
+
| **Claude Code** | ✅ 完整支援 | **55** | **51** | `CLAUDE.md` |
|
|
121
|
+
| **OpenCode** | ✅ 完整支援 | **55** | **51** | `AGENTS.md` |
|
|
122
122
|
| **Cursor** | ✅ 完整支援 | **核心** | **模擬支援** | `.cursorrules` |
|
|
123
123
|
| **Roo Code** | ✅ 完整支援 | **核心** | **工作流** | `.roo/rules/` |
|
|
124
124
|
| **Gemini CLI** | 🧪 預覽版 | **18+** | **20+** | `GEMINI.md` |
|
|
@@ -13,8 +13,8 @@ status: current
|
|
|
13
13
|
<!-- UDS_SUPPORTED_VERSIONS_START -->
|
|
14
14
|
| 版本 | 支援狀態 |
|
|
15
15
|
|------|--------|
|
|
16
|
-
|
|
|
17
|
-
| <
|
|
16
|
+
| 6.0.0 | ✅ 最新正式版 |
|
|
17
|
+
| < 6.0.0 | ❌ 已終止支援 |
|
|
18
18
|
<!-- UDS_SUPPORTED_VERSIONS_END -->
|
|
19
19
|
|
|
20
20
|
> **說明**:僅最新正式版與當前預發布分支會收到安全更新。
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
id: bilingual
|
|
5
5
|
meta:
|
|
6
6
|
parent: commit-message
|
|
7
|
-
version: "1.
|
|
7
|
+
version: "1.1.0"
|
|
8
8
|
description: 混合團隊的雙語格式
|
|
9
9
|
language: zh-TW
|
|
10
10
|
|
|
@@ -85,6 +85,11 @@ rules:
|
|
|
85
85
|
instruction: 以雙語撰寫內文,英文優先
|
|
86
86
|
priority: recommended
|
|
87
87
|
|
|
88
|
+
- id: mid-conversation-language-drift-check
|
|
89
|
+
trigger: AI 助手在長對話中處理大量非目標語言內容(程式碼、log、英文文件)後切回使用者對話文字時
|
|
90
|
+
instruction: 下一段使用者對話文字送出前先自我核對是否使用目標語言,不需等使用者指出;使用者已指出語言跑掉時,下一則回覆立即修正,不重複道歉拖延
|
|
91
|
+
priority: recommended
|
|
92
|
+
|
|
88
93
|
examples:
|
|
89
94
|
simple: "feat(auth): Add login form. 新增登入表單."
|
|
90
95
|
with_body: |
|
|
@@ -1,18 +1,18 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/flow-based-testing.md
|
|
3
|
-
source_version: 1.3.
|
|
4
|
-
translation_version: 1.3.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
source_hash:
|
|
7
|
-
status:
|
|
3
|
+
source_version: 1.3.1
|
|
4
|
+
translation_version: 1.3.1
|
|
5
|
+
last_synced: 2026-07-08
|
|
6
|
+
source_hash: afadaebc0f49
|
|
7
|
+
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
# 流程式測試(Flow-Based Testing)
|
|
11
11
|
|
|
12
12
|
> **Language**: [English](../../../core/flow-based-testing.md) | 繁體中文
|
|
13
13
|
|
|
14
|
-
**版本**: 1.3.
|
|
15
|
-
**最後更新**: 2026-
|
|
14
|
+
**版本**: 1.3.1
|
|
15
|
+
**最後更新**: 2026-06-18
|
|
16
16
|
**適用範圍**: 所有具備多步驟工作流程的軟體專案
|
|
17
17
|
**Scope**: universal
|
|
18
18
|
**產業標準**: ISO/IEC/IEEE 29119-4(測試技術)、ISTQB Foundation Syllabus
|
|
@@ -120,7 +120,7 @@ describe("Flow Branch: Quota exceeded path", () => {
|
|
|
120
120
|
|
|
121
121
|
## 與其他標準的關係
|
|
122
122
|
|
|
123
|
-
- **test-completeness-dimensions
|
|
123
|
+
- **test-completeness-dimensions**:定義了 **8** 個維度。Flow Completeness 與 Branch Coverage(決策表)的細節在本標準中說明——它們並非該標準中編號的維度 9/10(該標準僅有 8 個維度)
|
|
124
124
|
- **behavior-driven-development**:BDD Scenario Outline 表格對應到決策表展開
|
|
125
125
|
- **mock-boundary**:流程測試必須遵守 mock boundary 規則(不 mock 自身模組邏輯)
|
|
126
126
|
- **e2e-testing**:旅程測試在 ST 或 E2E 層級執行;流程測試可在 IT 層級搭配真實 DB 執行
|
|
@@ -3,7 +3,7 @@ source: ../../../core/license-compliance.md
|
|
|
3
3
|
source_version: 2.1.0
|
|
4
4
|
translation_version: 2.1.0
|
|
5
5
|
last_synced: 2026-06-10
|
|
6
|
-
source_hash:
|
|
6
|
+
source_hash: 8ac1763bd1a1
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -15,6 +15,8 @@ status: current
|
|
|
15
15
|
> **AI 最佳化版本**: `ai/standards/license-compliance.ai.yaml`
|
|
16
16
|
> **Agent Spec**: ASPEC-001 (cross-project/aspec/ASPEC-001-license-compliance-agent.md)
|
|
17
17
|
|
|
18
|
+
**Scope**: universal
|
|
19
|
+
|
|
18
20
|
## 概述
|
|
19
21
|
|
|
20
22
|
針對 AI 增強開發的完整授權合規標準,涵蓋一般 OSS 實務(Tier 1)以及針對 AI 生成程式碼的 AI 專屬規則(Tier 2)。
|
|
@@ -3,7 +3,7 @@ source: ../../../core/packaging-standards.md
|
|
|
3
3
|
source_version: 1.1.0
|
|
4
4
|
translation_version: 1.1.0
|
|
5
5
|
last_synced: 2026-06-10
|
|
6
|
-
source_hash:
|
|
6
|
+
source_hash: 69ff3afd3c1e
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -278,6 +278,7 @@ python -c "import zipfile; zipfile.ZipFile('dist/patch.zip').namelist()"
|
|
|
278
278
|
- [Pipeline 整合標準](pipeline-integration-standards.md) — CI/CD pipeline 設定
|
|
279
279
|
- [Check-in 標準](checkin-standards.md) — 打包前的品質關卡
|
|
280
280
|
- [版本控制標準](versioning.md) — 套件產出物使用的版本號
|
|
281
|
+
- [供應鏈證明標準](supply-chain-attestation.md) — 打包產出物的 SBOM / SLSA 溯源 / 簽章(此處的格式完整性屬於封存檔層級;證明則補充了從原始碼到產出物的溯源)
|
|
281
282
|
|
|
282
283
|
---
|
|
283
284
|
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
source: ../../../core/pipeline-security-gates.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
source_hash:
|
|
5
|
+
last_synced: 2026-07-08
|
|
6
|
+
source_hash: b234d1eb2344
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -15,7 +15,7 @@ status: current
|
|
|
15
15
|
|
|
16
16
|
## 概述
|
|
17
17
|
|
|
18
|
-
本標準定義嵌入 CI pipeline 各階段的安全檢查點,涵蓋 SAST、DAST、SCA(含 SBOM
|
|
18
|
+
本標準定義嵌入 CI pipeline 各階段的安全檢查點,涵蓋 SAST、DAST、SCA(含 SBOM)、機密掃描,以及發布前的供應鏈簽章驗證,並明確規定各類發現的阻斷(Block)、警告(Warn)、記錄(Log)行為。
|
|
19
19
|
|
|
20
20
|
---
|
|
21
21
|
|
|
@@ -24,6 +24,7 @@ status: current
|
|
|
24
24
|
- **機密掃描在 pre-commit**:所有包含機密的提交都必須被阻擋,不得例外
|
|
25
25
|
- **SAST 在建置後**:Critical 和 High 等級發現阻斷 pipeline
|
|
26
26
|
- **SCA + SBOM 在封包階段**:追蹤相依套件風險並產生物料清單
|
|
27
|
+
- **Attestation 驗證在發布前**:封包後、部署前 MUST 驗證 artifact 的 checksum、簽章與 SLSA provenance(消費 supply-chain-attestation 標準的產出,不得「產生 SBOM 卻不驗」)
|
|
27
28
|
- **DAST 在 staging 部署後**:對運行中的應用進行動態掃描
|
|
28
29
|
- **安全閘門失敗 = pipeline 失敗**:不得視為可忽略的警告
|
|
29
30
|
- **任何繞過都需審計軌跡**:禁止靜默跳過安全閘門
|
|
@@ -71,7 +72,24 @@ status: current
|
|
|
71
72
|
|
|
72
73
|
---
|
|
73
74
|
|
|
74
|
-
### 4.
|
|
75
|
+
### 4. Pre-Deploy — Artifact Attestation Verification(供應鏈簽章驗證)
|
|
76
|
+
|
|
77
|
+
| 項目 | 說明 |
|
|
78
|
+
|------|------|
|
|
79
|
+
| 驗證範圍 | 已封包的發布 artifact(檔案壓縮檔 / 容器映像)|
|
|
80
|
+
| 推薦工具 | cosign(`verify-blob` / `verify`)、sha256sum、slsa-verifier |
|
|
81
|
+
| 阻斷條件 | 簽章驗證失敗、checksum 不符、SLSA provenance 缺失 |
|
|
82
|
+
| 警告條件 | SLSA 等級低於目標(公開發布建議 ≥ L2)|
|
|
83
|
+
|
|
84
|
+
封包階段(gate 3)產生 SBOM 後,**部署/發布前 MUST 驗證** artifact 的完整性與來源證明,
|
|
85
|
+
避免「產生了 SBOM/簽章卻從不驗證」的假保證:比對 `checksums.txt` 的 SHA256、以
|
|
86
|
+
`cosign verify-blob` 驗 SBOM 與 provenance 簽章、確認 SLSA provenance 存在。完整的
|
|
87
|
+
產生與驗證指令、Release Bundle 結構見
|
|
88
|
+
[supply-chain-attestation.md](../../../core/supply-chain-attestation.md)。
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
### 5. Post-Staging Deploy — DAST(動態應用安全測試)
|
|
75
93
|
|
|
76
94
|
| 項目 | 說明 |
|
|
77
95
|
|------|------|
|
|
@@ -110,6 +128,7 @@ status: current
|
|
|
110
128
|
|---------|------|
|
|
111
129
|
| 機密管理 | 整合 HashiCorp Vault 或 AWS Secrets Manager 進行機密注入 |
|
|
112
130
|
| SBOM 註冊表 | 上傳 SBOM 至 dependency-track 或 grype-db 持續監控 |
|
|
131
|
+
| Artifact 簽章 | 發布前以 cosign 驗證 SBOM/provenance 簽章與 checksum(見 supply-chain-attestation)|
|
|
113
132
|
| 事故回應 | Critical 發現自動建立事故單 |
|
|
114
133
|
|
|
115
134
|
---
|
|
@@ -119,6 +138,7 @@ status: current
|
|
|
119
138
|
- [security-standards.md](../../../core/security-standards.md) — 應用安全基礎標準
|
|
120
139
|
- [pipeline-integration-standards.md](../../../core/pipeline-integration-standards.md) — CI 管線整合標準
|
|
121
140
|
- [deployment-standards.md](../../../core/deployment-standards.md) — 部署基礎原則
|
|
141
|
+
- [supply-chain-attestation.md](../../../core/supply-chain-attestation.md) — SBOM / SLSA provenance / cosign 簽章的產生與驗證(gate 4 消費)
|
|
122
142
|
- AI 格式:[pipeline-security-gates.ai.yaml](../../../ai/standards/pipeline-security-gates.ai.yaml)
|
|
123
143
|
|
|
124
144
|
---
|
|
@@ -1,18 +1,18 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/security-testing.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
source_hash:
|
|
7
|
-
status:
|
|
3
|
+
source_version: 1.1.0
|
|
4
|
+
translation_version: 1.1.0
|
|
5
|
+
last_synced: 2026-07-08
|
|
6
|
+
source_hash: 242e9016416c
|
|
7
|
+
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
# 資安測試標準
|
|
11
11
|
|
|
12
12
|
> **Language**: [English](../../../core/security-testing.md) | 繁體中文
|
|
13
13
|
|
|
14
|
-
**版本**: 1.
|
|
15
|
-
**最後更新**: 2026-
|
|
14
|
+
**版本**: 1.1.0
|
|
15
|
+
**最後更新**: 2026-06-19
|
|
16
16
|
**適用範圍**: 所有軟體專案
|
|
17
17
|
**Scope**: universal
|
|
18
18
|
**產業標準**: OWASP Testing Guide v4, NIST SP 800-115, ISO/IEC 27001
|
|
@@ -80,6 +80,23 @@ status: stale
|
|
|
80
80
|
|
|
81
81
|
---
|
|
82
82
|
|
|
83
|
+
## 發現事項修復生命週期
|
|
84
|
+
|
|
85
|
+
上述各層負責偵測發現,CVE 政策則設定解決時限(SLA),但一個發現事項還需要一個**有負責人的生命週期**——否則「阻擋 merge」就是唯一定義好的動作,偵測之後的一切都沒有定義。每個資安發現(SAST / DAST / 機密 / 相依套件 CVE)都遵循以下狀態機。
|
|
86
|
+
|
|
87
|
+
| 狀態 | 意義 | 負責人 | 結束條件 |
|
|
88
|
+
|-------|---------|-------|----------------|
|
|
89
|
+
| **Detected(已偵測)** | 由某一層(SAST/DAST/機密/稽核)提出 | 掃描閘門(CI) | 已指派嚴重度 |
|
|
90
|
+
| **Triaged(已分診)** | 已確認嚴重度與有效性(真實 vs 誤判) | 資安審查者 | 真實 → 轉為 In-Progress;誤判 → 標記為 `suppressed` 並記錄理由 |
|
|
91
|
+
| **In-Progress(處理中)** | 修復正在實作 | 受影響元件的程式碼負責人 | 修復已提交 |
|
|
92
|
+
| **Resolved(已解決)** | 修復已合併 | 程式碼負責人 | 原掃描重新執行後乾淨無發現 |
|
|
93
|
+
| **Verified(已驗證)** | 重新掃描確認發現已消失 | 掃描閘門(CI) | 發現事項關閉 |
|
|
94
|
+
|
|
95
|
+
- **閘門**:任何 Critical/High 發現若狀態非 `Verified`(或 `Triaged → suppressed` 且附有理由),皆**阻擋發布**,與上述 CVE 回應政策的 SLA 一致。
|
|
96
|
+
- **不得靜默關閉**:發現事項只能透過 `Verified`(重新掃描乾淨)或資安審查者明確記錄的 `suppressed` 決定離開此生命週期——絕不可透過刪除,也不可由修復作者自行核准關閉。
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
83
100
|
## 反模式
|
|
84
101
|
|
|
85
102
|
- 將所有 CVE 視為同等緊急
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/self-review-protocol.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-07-09
|
|
6
6
|
status: current
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -10,8 +10,8 @@ status: current
|
|
|
10
10
|
|
|
11
11
|
> **語言**: [English](../../../core/self-review-protocol.md) | 繁體中文
|
|
12
12
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最後更新**: 2026-
|
|
13
|
+
**版本**: 1.1.0
|
|
14
|
+
**最後更新**: 2026-07-09
|
|
15
15
|
**適用範圍**: 所有軟體專案(新建、重構、遷移、維護)
|
|
16
16
|
**範圍**: partial
|
|
17
17
|
**業界標準**: ISO/IEC 25010(文件可維護性)、IEEE 1063-2001(軟體使用者文件)
|
|
@@ -34,7 +34,7 @@ status: current
|
|
|
34
34
|
|
|
35
35
|
多次 Claude 輔助編輯 session(如 `dev-platform/.claude/skills/eval-source/SKILL.md` v1.1.0 → v1.1.1、v1.2.0 → v1.2.1)觀察到一致模式:**每次大型 markdown 編輯都引入 3-6 處小型內部不一致**,內部推理看不出來,但完整 re-read 立刻 surface。
|
|
36
36
|
|
|
37
|
-
這些不一致歸納為 **6 大類**,且固定觸發後續 patch commit。在 commit 前加入強制 re-read 步驟後,此模式消失(eval-source v1.3.0 為首次無 patch follow-up 的 SKILL.md
|
|
37
|
+
這些不一致歸納為 **6 大類**,且固定觸發後續 patch commit。在 commit 前加入強制 re-read 步驟後,此模式消失(eval-source v1.3.0 為首次無 patch follow-up 的 SKILL.md 變更)。第 7 大類(語言與術語一致性)為後續因不同動機(跨對話 AI 輸出漂移,非原始 patch 週期模式)新增,詳見下方。
|
|
38
38
|
|
|
39
39
|
---
|
|
40
40
|
|
|
@@ -56,7 +56,7 @@ status: current
|
|
|
56
56
|
|
|
57
57
|
---
|
|
58
58
|
|
|
59
|
-
##
|
|
59
|
+
## 7 類常見內部不一致
|
|
60
60
|
|
|
61
61
|
### 1. Diagram / Flow 與 step list 不同步
|
|
62
62
|
**範例**:工作流程圖 7 格但文件實際定義 8 步驟
|
|
@@ -82,12 +82,16 @@ status: current
|
|
|
82
82
|
**範例**:example 寫「D1/D2/D3」但 rule 明說 D3 不強制,且當前案例正好把 D3 降為後續追蹤
|
|
83
83
|
**檢查**:example 中每個具體值是否與當前 rule 一致;example 不應與最新案例經驗矛盾
|
|
84
84
|
|
|
85
|
+
### 7. 語言與術語一致性
|
|
86
|
+
**範例**:雙語文件某段落中英文夾雜,或日文假名/韓文諺文混入繁體中文段落;或同一份文件內「XSPEC」「gate」「pipeline」等專案慣用術語寫法不一致
|
|
87
|
+
**檢查**:掃描非目標語言文字是否出現在非預期段落(如日文假名 U+3040–U+30FF、韓文諺文 U+AC00–U+D7A3 混入 zh-TW 段落)、同段落語言混雜、以及同一檔案內既有慣用術語拼法是否一致
|
|
88
|
+
|
|
85
89
|
---
|
|
86
90
|
|
|
87
91
|
## 流程
|
|
88
92
|
|
|
89
93
|
1. **edit 完成後、commit 前**,用 file-reading 工具重新讀過**完整檔案**(不只 diff)
|
|
90
|
-
2. 依上方
|
|
94
|
+
2. 依上方 7 類逐項對照
|
|
91
95
|
3. **發現問題** → 直接 Edit 修補後再 commit(同一 commit 包含修正,不要分開 ship)
|
|
92
96
|
4. **若已 commit 才發現** → 新增 patch commit(如 v1.2.1 對 v1.2.0)
|
|
93
97
|
|
|
@@ -104,19 +108,19 @@ status: current
|
|
|
104
108
|
### ADR / DEC
|
|
105
109
|
在 `## 後續追蹤` 表格新增一行:
|
|
106
110
|
```
|
|
107
|
-
| Self-review pass | 本 DEC | ✅ YYYY-MM-DD (
|
|
111
|
+
| Self-review pass | 本 DEC | ✅ YYYY-MM-DD (7 類無 issue) |
|
|
108
112
|
```
|
|
109
113
|
|
|
110
114
|
### XSPEC SDD Delta
|
|
111
115
|
在「不改動清單」section(如 §N.6)後追加:
|
|
112
116
|
```
|
|
113
|
-
> Self-review pass: YYYY-MM-DD (
|
|
117
|
+
> Self-review pass: YYYY-MM-DD (7 類無 issue)
|
|
114
118
|
```
|
|
115
119
|
|
|
116
120
|
### Commit message body
|
|
117
121
|
最後一行附:
|
|
118
122
|
```
|
|
119
|
-
Self-review (protocol v1.
|
|
123
|
+
Self-review (protocol v1.1.0): N issues found, M applied in same commit / 0 found.
|
|
120
124
|
```
|
|
121
125
|
|
|
122
126
|
---
|
|
@@ -164,3 +168,4 @@ Self-review (protocol v1.0.0): N issues found, M applied in same commit / 0 foun
|
|
|
164
168
|
## Self-Review Pass
|
|
165
169
|
|
|
166
170
|
> Self-review pass: 2026-05-26 (6 類無 issue;本標準首稿同步 self-review)
|
|
171
|
+
> Self-review pass: 2026-07-09(7 類無 issue —— 依 XSPEC-324 新增第 7 類「語言與術語一致性」)
|