universal-dev-standards 5.10.0 → 5.11.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.
Files changed (85) hide show
  1. package/bundled/core/adversarial-test.md +3 -0
  2. package/bundled/core/behavior-snapshot.md +1 -1
  3. package/bundled/core/capability-declaration.md +3 -0
  4. package/bundled/core/cd-deployment-strategies.md +3 -0
  5. package/bundled/core/chaos-injection-tests.md +3 -0
  6. package/bundled/core/circuit-breaker.md +3 -0
  7. package/bundled/core/container-security.md +3 -0
  8. package/bundled/core/cost-budget-test.md +3 -0
  9. package/bundled/core/data-migration-testing.md +3 -0
  10. package/bundled/core/disaster-recovery-drill.md +3 -0
  11. package/bundled/core/dual-phase-output.md +3 -0
  12. package/bundled/core/failure-source-taxonomy.md +3 -0
  13. package/bundled/core/feature-manifest-standard.md +1 -1
  14. package/bundled/core/flaky-test-management.md +3 -0
  15. package/bundled/core/full-coverage-testing.md +3 -0
  16. package/bundled/core/health-check-standards.md +3 -0
  17. package/bundled/core/immutability-first.md +3 -0
  18. package/bundled/core/llm-output-validation.md +3 -0
  19. package/bundled/core/no-cicd-deployment.md +3 -0
  20. package/bundled/core/pipeline-security-gates.md +3 -0
  21. package/bundled/core/policy-as-code-testing.md +3 -0
  22. package/bundled/core/prompt-regression.md +3 -0
  23. package/bundled/core/property-based-testing.md +3 -0
  24. package/bundled/core/recovery-recipe-registry.md +3 -0
  25. package/bundled/core/release-quality-manifest.md +3 -0
  26. package/bundled/core/replay-test.md +3 -0
  27. package/bundled/core/retry-standards.md +3 -0
  28. package/bundled/core/rollback-standards.md +3 -0
  29. package/bundled/core/sast-advanced.md +1 -1
  30. package/bundled/core/secure-op.md +3 -0
  31. package/bundled/core/security-decision.md +3 -0
  32. package/bundled/core/server-ops-security.md +3 -0
  33. package/bundled/core/skill-standard-alignment-check.md +3 -0
  34. package/bundled/core/smoke-test.md +3 -0
  35. package/bundled/core/standard-admission-criteria.md +3 -0
  36. package/bundled/core/standard-lifecycle-management.md +3 -0
  37. package/bundled/core/supply-chain-attestation.md +3 -0
  38. package/bundled/core/timeout-standards.md +3 -0
  39. package/bundled/core/token-budget.md +3 -0
  40. package/bundled/locales/zh-CN/CHANGELOG.md +13 -3
  41. package/bundled/locales/zh-CN/CLAUDE.md +1 -1
  42. package/bundled/locales/zh-CN/README.md +3 -3
  43. package/bundled/locales/zh-CN/SECURITY.md +1 -2
  44. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +127 -15
  45. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +141 -25
  46. package/bundled/locales/zh-CN/skills/adr-assistant/SKILL.md +43 -0
  47. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +35 -0
  48. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +35 -0
  49. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +35 -0
  50. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +24 -0
  51. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +37 -0
  52. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +33 -0
  53. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +34 -0
  54. package/bundled/locales/zh-CN/skills/logging-guide/SKILL.md +33 -0
  55. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +19 -0
  56. package/bundled/locales/zh-CN/skills/retrospective-assistant/SKILL.md +38 -0
  57. package/bundled/locales/zh-CN/skills/testing-guide/SKILL.md +36 -0
  58. package/bundled/locales/zh-TW/CHANGELOG.md +13 -3
  59. package/bundled/locales/zh-TW/CLAUDE.md +1 -1
  60. package/bundled/locales/zh-TW/README.md +3 -3
  61. package/bundled/locales/zh-TW/SECURITY.md +1 -2
  62. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +127 -15
  63. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +141 -25
  64. package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +43 -0
  65. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +35 -0
  66. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +35 -0
  67. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +35 -0
  68. package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md +661 -267
  69. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +24 -0
  70. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +37 -0
  71. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +33 -0
  72. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +34 -0
  73. package/bundled/locales/zh-TW/skills/logging-guide/SKILL.md +33 -0
  74. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -0
  75. package/bundled/locales/zh-TW/skills/retrospective-assistant/SKILL.md +38 -0
  76. package/bundled/locales/zh-TW/skills/testing-guide/SKILL.md +36 -0
  77. package/bundled/skills/README.md +1 -1
  78. package/bundled/skills/spec-driven-dev/SKILL.md +41 -0
  79. package/package.json +1 -1
  80. package/src/commands/update.js +35 -0
  81. package/src/config/ai-agent-paths.js +8 -0
  82. package/src/i18n/messages.js +3 -0
  83. package/src/utils/integration-generator.js +18 -2
  84. package/standards-registry.json +3 -3
  85. package/bundled/locales/zh-TW/docs/MIGRATION-V5.md +0 -79
@@ -38,3 +38,46 @@ CAPTURE ──► ANALYZE ──► DECIDE ──► RECORD ──► LINK
38
38
 
39
39
  - 核心规范:[adr-standards.md](../../../../core/adr-standards.md)
40
40
  - 详细指南:[guide.md](./guide.md)
41
+
42
+
43
+ ## Next Steps Guidance | 下一步引導
44
+
45
+ After `/adr` completes, the AI assistant should suggest:
46
+
47
+ > **ADR created. Suggested next steps:**
48
+ > - Execute `/sdd` to create a spec if the decision requires implementation
49
+ > - Execute `/commit` to commit the ADR file
50
+ > - Update related SPECs to reference this ADR
51
+ > - Share with team for review if status is `Proposed`
52
+
53
+ > **ADR 已建立。建議下一步:**
54
+ > - 執行 `/sdd` 建立規格(若決策需要實作)
55
+ > - 執行 `/commit` 提交 ADR 檔案
56
+ > - 更新相關規格以引用此 ADR
57
+ > - 若狀態為 `Proposed`,分享給團隊審查
58
+
59
+ ## AI Agent Behavior | AI 代理行為
60
+
61
+ When the user invokes `/adr`, the AI assistant MUST:
62
+
63
+ 1. **Check existing ADRs** — Search `docs/adr/` to determine next ADR number
64
+ 2. **Guide interactively** — Ask about context, drivers, and options step by step
65
+ 3. **Generate the file** — Write ADR to `docs/adr/ADR-NNN-title.md`
66
+ 4. **Suggest links** — Identify related SPECs or ADRs to cross-reference
67
+ 5. **Offer next steps** — Show the Next Steps Guidance above
68
+
69
+ When the user invokes `/adr list`:
70
+ 1. Scan `docs/adr/` directory
71
+ 2. Parse status from each ADR file
72
+ 3. Display as a table: Number, Title, Status, Date
73
+
74
+ When the user invokes `/adr supersede [ADR-NNN]`:
75
+ 1. Read the existing ADR
76
+ 2. Guide creation of a new ADR
77
+ 3. Update old ADR status to `Superseded by ADR-NNN`
78
+ 4. Add `Supersedes ADR-NNN` to new ADR
79
+
80
+ ## Reference | 參考
81
+
82
+ - Core Standard: [adr-standards.md](../../core/adr-standards.md)
83
+ - Detailed Guide: [guide.md](./guide.md)
@@ -173,3 +173,38 @@ This project uses **English** certainty tags.
173
173
  此技能依据 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。
174
174
 
175
175
  **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
176
+
177
+
178
+ ## Next Steps Guidance | 下一步引導
179
+
180
+ After `/ai-collaboration` completes, the AI assistant should suggest:
181
+
182
+ > **AI 協作行為規範已掌握。建議下一步 / AI collaboration behavior standards understood. Suggested next steps:**
183
+ > - 執行 `/ai-instructions` 建立或更新 CLAUDE.md 等 AI 指令檔案 ⭐ **Recommended / 推薦** — 將協作標準寫入專案配置 / Write collaboration standards into project configuration
184
+ > - 執行 `/ai-friendly-architecture` 設計 AI 友善架構 — 從長期架構層面優化 AI 協作 / Optimize AI collaboration at the architecture level
185
+ > - 執行 `/review` 運用確定性標籤進行程式碼審查 — 實踐基於證據的分析 / Practice evidence-based analysis
186
+
187
+ ---
188
+
189
+ ## Related Standards
190
+
191
+ - [Anti-Hallucination Standards](../../core/anti-hallucination.md)
192
+ - [Code Review Checklist](../../core/code-review-checklist.md)
193
+ - [Testing Standards](../../core/testing-standards.md)
194
+
195
+ ---
196
+
197
+ ## Version History
198
+
199
+ | Version | Date | Changes |
200
+ |---------|------|---------|
201
+ | 1.1.0 | 2026-01-25 | Added: Unified Tag System with Certainty and Derivation tag categories |
202
+ | 1.0.0 | 2025-12-24 | Added: Standard sections (Purpose, Related Standards, Version History, License) |
203
+
204
+ ---
205
+
206
+ ## License
207
+
208
+ This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
209
+
210
+ **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -219,3 +219,38 @@ documentation:
219
219
  本技能以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
220
220
 
221
221
  **来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
222
+
223
+
224
+ ## Next Steps Guidance | 下一步引導
225
+
226
+ After `/ai-friendly-architecture` completes, the AI assistant should suggest:
227
+
228
+ > **AI 友善架構指南已掌握。建議下一步 / AI-friendly architecture guide understood. Suggested next steps:**
229
+ > - 執行 `/sdd` 將 AI 友善架構設計納入正式規格 ⭐ **Recommended / 推薦** — 確保架構決策有規格追蹤 / Ensure architecture decisions are tracked in specs
230
+ > - 建立 `.ai-context.yaml` 和 `QUICK-REF.md` — 立即實作 AI 友善結構 / Implement AI-friendly structure immediately
231
+ > - 執行 `/ai-instructions` 更新 CLAUDE.md 以反映架構配置 — 讓 AI 指令檔案與架構保持同步 / Keep AI instruction files in sync with architecture
232
+
233
+ ---
234
+
235
+ ## Related Standards
236
+
237
+ - [AI-Friendly Architecture](../../core/ai-friendly-architecture.md) - Core architecture standard
238
+ - [Project Structure](../../core/project-structure.md) - Directory organization
239
+ - [Documentation Structure](../../core/documentation-structure.md) - Documentation layering
240
+ - [Anti-Hallucination](../../core/anti-hallucination.md) - AI accuracy standards
241
+
242
+ ---
243
+
244
+ ## Version History
245
+
246
+ | Version | Date | Changes |
247
+ |---------|------|---------|
248
+ | 1.0.0 | 2026-01-25 | Initial release |
249
+
250
+ ---
251
+
252
+ ## License
253
+
254
+ This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
255
+
256
+ **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -212,3 +212,38 @@ project/
212
212
  本技能以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
213
213
 
214
214
  **来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
215
+
216
+
217
+ ## Next Steps Guidance
218
+
219
+ After `/ai-instructions` completes, suggest:
220
+
221
+ > - Create or update project's `CLAUDE.md` / `AGENTS.md` ⭐ **Recommended** — Apply standards immediately
222
+ > - Run `/ai-friendly-architecture` to optimize AI collaboration at the architecture level
223
+ > - Run `/ai-collaboration` to review AI behavior guidelines
224
+
225
+ ---
226
+
227
+ ## Related Standards
228
+
229
+ - [AI Instruction File Standards](../../core/ai-instruction-standards.md) - Core standard
230
+ - [Documentation Writing Standards](../../core/documentation-writing-standards.md) - Writing guidelines
231
+ - [Anti-Hallucination Guidelines](../../core/anti-hallucination.md) - AI accuracy rules
232
+ - [AI-Friendly Architecture](../../core/ai-friendly-architecture.md) - Context optimization
233
+
234
+ ---
235
+
236
+ ## Version History
237
+
238
+ | Version | Date | Changes |
239
+ |---------|------|---------|
240
+ | 2.0.0 | 2026-04-28 | Add Gemini CLI, OpenAI Codex CLI; update Cursor (MDC format, deprecated .cursorrules); update OpenCode (AGENTS.md primary); update Copilot (multiple file types); update Windsurf (Workflows); add AGENTS.md cross-tool standard section |
241
+ | 1.0.0 | 2026-01-25 | Initial release |
242
+
243
+ ---
244
+
245
+ ## License
246
+
247
+ This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
248
+
249
+ **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -29,3 +29,27 @@ description: |
29
29
 
30
30
  - 详细指南:[contract-testing.md](../../../../options/testing/contract-testing.md)
31
31
  - 技能指南:[guide.md](./guide.md)
32
+
33
+
34
+ ## Next Steps Guidance | 下一步引導
35
+
36
+ After `/contract-test` completes:
37
+
38
+ > **合約測試引導完成。建議下一步:**
39
+ > - 執行 `/ci-cd` 將合約驗證加入 CI 管線
40
+ > - 執行 `/api-design` 完善 API 設計
41
+ > - 執行 `/testing` 整合到整體測試策略
42
+
43
+ ## Reference | 參考
44
+
45
+ - Detailed guide: [contract-testing.md](../../options/testing/contract-testing.md)
46
+ - Related: [api-design-assistant](../api-design-assistant/SKILL.md)
47
+
48
+ ## AI Agent Behavior | AI 代理行為
49
+
50
+ When `/contract-test` is invoked:
51
+ 1. **Assess** — Ask about architecture (monolith, microservices, number of APIs)
52
+ 2. **Recommend** — Suggest strategy based on architecture
53
+ 3. **Guide** — Walk through setup for chosen strategy
54
+ 4. **Generate** — Create example contract test files
55
+ 5. **Verify** — If `verify` subcommand, scan for contracts and report coverage
@@ -418,3 +418,40 @@ MIT
418
418
  本 Skill 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
419
419
 
420
420
  **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
421
+
422
+
423
+ ## Next Steps Guidance | 下一步引導
424
+
425
+ After `/docs-guide` completes, the AI assistant should suggest:
426
+
427
+ > **文件結構與需求已釐清。建議下一步 / Documentation structure and requirements clarified. Suggested next steps:**
428
+ > - 執行 `/docs` 根據指南直接產生專案文件 ⭐ **Recommended / 推薦** — 立即將文件指南化為行動 / Turn documentation guidelines into action immediately
429
+ > - 執行 `/changelog` 建立或更新 CHANGELOG.md — 確保變更歷史完整 / Ensure change history is complete
430
+ > - 執行 `/sdd` 將文件需求納入規格驅動開發 — 確保文件與功能同步 / Ensure docs stay in sync with features
431
+
432
+ ---
433
+
434
+ ## Related Standards
435
+
436
+ - [Documentation Writing Standards](../../core/documentation-writing-standards.md) - Content requirements
437
+ - [Documentation Structure](../../core/documentation-structure.md) - File organization
438
+ - [Changelog Standards](../../core/changelog-standards.md) - CHANGELOG format
439
+ - [Changelog Guide Skill](../changelog-guide/SKILL.md) - CHANGELOG skill
440
+
441
+ ---
442
+
443
+ ## Version History
444
+
445
+ | Version | Date | Changes |
446
+ |---------|------|---------|
447
+ | 2.1.0 | 2026-03-17 | Added: Diátaxis classification, LLM discovery, quality metrics, enhanced ADR template, translation-friendly writing |
448
+ | 2.0.0 | 2026-01-12 | Added: Project type matrix, document templates, documentation pyramid |
449
+ | 1.0.0 | 2025-12-24 | Initial release |
450
+
451
+ ---
452
+
453
+ ## License
454
+
455
+ This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
456
+
457
+ **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -267,3 +267,36 @@ export const ErrorCodes = {
267
267
  此技能採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权。
268
268
 
269
269
  **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
270
+
271
+
272
+ ## Next Steps Guidance | 下一步引導
273
+
274
+ After `/errors` completes, the AI assistant should suggest:
275
+
276
+ > **錯誤碼設計已完成。建議下一步 / Error code design completed. Suggested next steps:**
277
+ > - 執行 `/sdd` 將錯誤碼設計納入正式規格 ⭐ **Recommended / 推薦** — 確保錯誤碼在規格中有完整定義 / Ensure error codes are fully defined in specs
278
+ > - 執行 `/logging` 設定結構化日誌以配合錯誤碼 — 讓錯誤碼與日誌系統整合 / Integrate error codes with logging system
279
+ > - 執行 `/tdd` 為錯誤處理邏輯撰寫測試 — 確保每個錯誤碼都有對應的測試 / Ensure each error code has corresponding tests
280
+
281
+ ---
282
+
283
+ ## Related Standards
284
+
285
+ - [Error Code Standards](../../core/error-code-standards.md)
286
+ - [Logging Standards](../../core/logging-standards.md)
287
+
288
+ ---
289
+
290
+ ## Version History
291
+
292
+ | Version | Date | Changes |
293
+ |---------|------|---------|
294
+ | 1.0.0 | 2025-12-30 | Initial release |
295
+
296
+ ---
297
+
298
+ ## License
299
+
300
+ This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
301
+
302
+ **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -216,3 +216,37 @@ git push origin feature/my-feature
216
216
  本技能採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
217
217
 
218
218
  **來源**:[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
219
+
220
+
221
+ ## Next Steps Guidance | 下一步引導
222
+
223
+ After `/git-flow` completes, the AI assistant should suggest:
224
+
225
+ > **Git 工作流程已設定。建議下一步 / Git workflow configured. Suggested next steps:**
226
+ > - 執行 `git checkout -b feature/<描述>` 建立功能分支開始開發 ⭐ **Recommended / 推薦** — 立即套用所選的分支策略 / Apply the chosen branching strategy immediately
227
+ > - 執行 `/commit` 學習提交訊息規範 — 確保提交訊息格式一致 / Ensure consistent commit message format
228
+ > - 執行 `/checkin` 了解簽入品質門檻 — 在提交前確保程式碼品質 / Ensure code quality before commits
229
+
230
+ ---
231
+
232
+ ## Related Standards
233
+
234
+ - [Git Workflow](../../core/git-workflow.md) - Core Git workflow standard
235
+ - [Commit Message Guide](../../core/commit-message-guide.md) - Commit message conventions
236
+ - [Checkin Standards](../../core/checkin-standards.md) - Pre-commit quality gates
237
+
238
+ ---
239
+
240
+ ## Version History
241
+
242
+ | Version | Date | Changes |
243
+ |---------|------|---------|
244
+ | 1.0.0 | 2025-12-24 | Added: Standard sections (Purpose, Related Standards, Version History, License) |
245
+
246
+ ---
247
+
248
+ ## License
249
+
250
+ This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
251
+
252
+ **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -283,3 +283,36 @@ logger.error('处理订单失败', {
283
283
  此技能採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权。
284
284
 
285
285
  **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
286
+
287
+
288
+ ## Next Steps Guidance | 下一步引導
289
+
290
+ After `/logging` completes, the AI assistant should suggest:
291
+
292
+ > **日誌標準已掌握。建議下一步 / Logging standards understood. Suggested next steps:**
293
+ > - 根據日誌指南在程式碼中實作結構化日誌 ⭐ **Recommended / 推薦** — 立即將日誌標準應用到專案 / Apply logging standards to the project immediately
294
+ > - 執行 `/errors` 設計錯誤碼以配合日誌系統 — 讓錯誤追蹤更有效率 / Make error tracking more efficient
295
+ > - 執行 `/sdd` 將可觀測性需求納入規格 — 確保日誌需求在規格中有定義 / Ensure logging requirements are defined in specs
296
+
297
+ ---
298
+
299
+ ## Related Standards
300
+
301
+ - [Logging Standards](../../core/logging-standards.md)
302
+ - [Error Code Standards](../../core/error-code-standards.md)
303
+
304
+ ---
305
+
306
+ ## Version History
307
+
308
+ | Version | Date | Changes |
309
+ |---------|------|---------|
310
+ | 1.0.0 | 2025-12-30 | Initial release |
311
+
312
+ ---
313
+
314
+ ## License
315
+
316
+ This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
317
+
318
+ **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -149,3 +149,22 @@ project/
149
149
  - [核心:文档结构](../../core/documentation-structure.md)
150
150
  - [指南:文件归档决策指南](../../core/guides/file-placement-guide.md)
151
151
  - [AI:项目结构选项](../../../../options/project-structure/)
152
+
153
+
154
+ ## Next Steps Guidance | 下一步引導
155
+
156
+ After `/project-structure` completes, the AI assistant should suggest:
157
+
158
+ > **專案結構已建立或審查完成。建議下一步 / Project structure created or reviewed. Suggested next steps:**
159
+ > - 執行 `/sdd` 開始規格驅動開發,將專案結構納入正式規格 ⭐ **Recommended / 推薦** — 確保結構決策有規格追蹤 / Ensures structure decisions are tracked in specs
160
+ > - 執行 `/docs` 產生專案文件(README、ARCHITECTURE.md 等) — 讓結構決策有文件記錄 / Document structure decisions
161
+ > - 執行 `/ai-friendly-architecture` 設定 AI 上下文配置 — 讓 AI 助手更好地理解專案結構 / Help AI assistants understand the project structure
162
+
163
+ ---
164
+
165
+ ## Related Standards
166
+
167
+ - [Core: Project Structure](../../core/project-structure.md)
168
+ - [Core: Documentation Structure](../../core/documentation-structure.md)
169
+ - [Guide: File Placement Decision Guide](../../core/guides/file-placement-guide.md)
170
+ - [AI: Project Structure Options](../../ai/options/project-structure/)
@@ -28,3 +28,41 @@ description: |
28
28
 
29
29
  - 核心规范:[retrospective-standards.md](../../../../core/retrospective-standards.md)
30
30
  - 详细指南:[guide.md](./guide.md)
31
+
32
+
33
+ ## Next Steps Guidance | 下一步引導
34
+
35
+ After `/retrospective` completes:
36
+
37
+ > **Retrospective complete. Suggested next steps:**
38
+ > - Commit the retrospective report: `/commit`
39
+ > - Create ADRs for architectural decisions identified: `/adr`
40
+ > - Track action items in your issue tracker
41
+ > - Schedule next retrospective
42
+
43
+ > **回顧完成。建議下一步:**
44
+ > - 提交回顧報告:`/commit`
45
+ > - 為識別的架構決策建立 ADR:`/adr`
46
+ > - 在 issue tracker 中追蹤行動項目
47
+ > - 排定下次回顧
48
+
49
+ ## AI Agent Behavior | AI 代理行為
50
+
51
+ When `/retrospective` is invoked:
52
+
53
+ 1. **Check type** — Sprint (default) or Release
54
+ 2. **Gather data** — Scan git log, check `docs/retrospectives/` for previous actions
55
+ 3. **Guide technique** — Use Start-Stop-Continue by default, or specified technique
56
+ 4. **Generate report** — Write to `docs/retrospectives/RETRO-YYYY-MM-DD-[type].md`
57
+ 5. **Review past actions** — Check previous retro for open action items
58
+ 6. **Offer next steps** — Show guidance above
59
+
60
+ When `/retrospective actions` is invoked:
61
+ 1. Scan `docs/retrospectives/` for all retro files
62
+ 2. Parse action items from each
63
+ 3. Display open/in-progress items as table
64
+
65
+ ## Reference | 參考
66
+
67
+ - Core Standard: [retrospective-standards.md](../../core/retrospective-standards.md)
68
+ - Detailed Guide: [guide.md](./guide.md)
@@ -232,3 +232,39 @@ test('method_scenario_expected', () => {
232
232
  本 Skill 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
233
233
 
234
234
  **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
235
+
236
+
237
+ ## Next Steps Guidance | 下一步引導
238
+
239
+ After `/testing` completes, the AI assistant should suggest:
240
+
241
+ > **測試標準與最佳實踐已掌握。建議下一步 / Testing standards and best practices understood. Suggested next steps:**
242
+ > - 執行 `/tdd` 開始測試驅動開發(紅-綠-重構循環) ⭐ **Recommended / 推薦** — 將測試知識立即轉化為實踐 / Turn testing knowledge into practice immediately
243
+ > - 執行 `/coverage` 分析目前程式碼覆蓋率 — 找出測試缺口 / Identify testing gaps
244
+ > - 執行 `/bdd` 撰寫行為驅動的 Given-When-Then 場景 — 從使用者角度定義測試 / Define tests from user perspective
245
+
246
+ ---
247
+
248
+ ## Related Standards
249
+
250
+ - [Testing Standards](../../core/testing-standards.md) - Actionable rules
251
+ - [Testing Theory](./testing-theory.md) - Educational knowledge base
252
+ - [Code Review Checklist](../../core/code-review-checklist.md)
253
+
254
+ ---
255
+
256
+ ## Version History
257
+
258
+ | Version | Date | Changes |
259
+ |---------|------|---------|
260
+ | 1.2.0 | 2026-01-29 | Added links to new testing-theory.md knowledge base |
261
+ | 1.1.0 | 2025-12-29 | Added Testing Theory Essentials YAML section |
262
+ | 1.0.0 | 2025-12-24 | Initial: Standard sections (Purpose, Related Standards, Version History, License) |
263
+
264
+ ---
265
+
266
+ ## License
267
+
268
+ This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
269
+
270
+ **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  source: ../../CHANGELOG.md
3
- source_version: 5.10.0
4
- translation_version: 5.10.0
5
- last_synced: 2026-05-13
3
+ source_version: 5.11.0
4
+ translation_version: 5.11.0
5
+ last_synced: 2026-05-14
6
6
  status: current
7
7
  ---
8
8
 
@@ -17,6 +17,16 @@ status: current
17
17
 
18
18
  ## [Unreleased]
19
19
 
20
+ ## [5.11.0] - 2026-05-14
21
+
22
+ ### 新增 / Added
23
+ - **`spec-driven-development`** SPEC Type Agent 變體:`acceptance-criteria-traceability.ai.yaml` 與 SDD 模板新增 `spec-type: feature | agent | infrastructure` 欄位,以及 Agent SPEC 五段式模板(能力範圍 / 決策邊界 / 可觀測性 / 失敗模式 / 跨 Agent 不變量)。讓 Builder/QA/Planner 風格的 SPEC 可獨立於 feature SPEC 追蹤,並透過新增的 `agent-id` 欄位連回特定 Agent。(XSPEC-205)
24
+ - **`reverse-engineering-standards`** 移植清單雙向驗證:新增路由驅動的發現方法(禁止以 filesystem-glob 為起點)、target→source 雙向掃描,以及對「無對應來源產物」的發現的 `[GAP]` 標記協議。搭配 `testing.ai.yaml` 新增 `migration_testing` 區段,要求以 3 步驟 schema parity pattern 並由 CI gate 強制執行。關閉 UDS Issue #96 與 #97。(XSPEC-206)
25
+
26
+ ### 修復 / Fixed
27
+ - **`uds update` 對 schema 3.x manifest 誤報「CLAUDE.md.md:無法判斷來源」還原失敗**(`cli/src/utils/integration-generator.js`、`cli/src/commands/update.js`):schema 3.x manifest 在 `manifest.integrations` 存的是**檔名**(如 `"CLAUDE.md"`)而非工具名。`integration-generator.js:56` 的 `getToolFileName` fallback 無條件附加 `".md"`,導致 `getToolFilePath("CLAUDE.md")` 回傳 `"CLAUDE.md.md"`,被當成遺失檔案而無法還原(`getSourcePathFromRelative` 對該合成路徑沒有 mapping)。Commit `79532b3`(5.10.0)修了反向案例(工具名輸入),但漏這個檔名變體。修補:從 `SUPPORTED_AI_TOOLS` 預計算 `KNOWN_TOOL_FILES`,對已知整合檔名或已含已知副檔名(`.md`/`.yaml`/`.yml`/`.json`)的輸入短路回傳。`integration-generator.test.js` 新增 5 個 regression test。(XSPEC-208 BUG-208-01)
28
+ - **`uds update` / `uds check` 誤報「Integration UDS Block Integrity:GEMINI.md/AGENTS.md 遺失」警告**(`cli/src/commands/update.js`、`cli/src/i18n/messages.js`):`manifest.integrationBlockHashes` 每次安裝都累加但從不清理。當 `manifest.aiTools` 縮減(如 `["claude-code","gemini-cli"]` → `["claude-code"]`),GEMINI.md 的 hash 仍殘留,`check.js:1491 checkIntegrationBlocksIntegrity` 誤報該檔遺失。修補:在 integration 重生步驟後,依 `manifest.aiTools`(宣告的設定,而非 `results.integrations`,後者在暫時性寫入失敗時會 over-prune)反推預期檔名集合並移除孤兒 hash。被清理的檔名透過新增 i18n key `prunedOrphanedBlockHashes`(en / zh-TW / zh-CN)回報。`update.test.js` 新增 3 個 regression test。在 machine-setup `uds update` 5.1.0-beta.4 → 5.10.0 觸發;於 5.10.0 → 5.11.0 驗證修復。(XSPEC-208 BUG-208-02)
29
+
20
30
  ## [5.10.0] - 2026-05-13
21
31
 
22
32
  ### 新增
@@ -14,7 +14,7 @@ status: current
14
14
 
15
15
  Universal Development Standards 是一個語言無關、框架無關的文件化標準框架。它提供:
16
16
 
17
- - **核心規範** (`core/`):71 個基礎開發標準
17
+ - **核心規範** (`core/`):125 個基礎開發標準
18
18
  - **AI 技能** (`skills/`):用於 AI 輔助開發的 Claude Code 技能
19
19
  - **CLI 工具** (`cli/`):用於採用標準的 Node.js CLI
20
20
  - **整合** (`integrations/`):各種 AI 工具的配置
@@ -14,7 +14,7 @@ status: current
14
14
 
15
15
  > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
16
16
 
17
- **版本**: 5.10.0 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
17
+ **版本**: 5.11.0 | **發布日期**: 2026-05-14 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
18
18
 
19
19
  語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流,確保不同技術堆疊之間的一致性、品質和可維護性。
20
20
 
@@ -63,8 +63,8 @@ npx universal-dev-standards init
63
63
  <!-- UDS_STATS_TABLE_START -->
64
64
  | 類別 | 數量 | 說明 |
65
65
  |----------|-------|-------------|
66
- | **核心標準** | 78 | 通用開發準則 |
67
- | **AI Skills** | 48 | 互動式技能 |
66
+ | **核心標準** | 125 | 通用開發準則 |
67
+ | **AI Skills** | 54 | 互動式技能 |
68
68
  | **斜線命令** | 48 | 快速操作 |
69
69
  | **CLI 指令** | 6 | list, init, configure, check, update, skills |
70
70
  <!-- UDS_STATS_TABLE_END -->
@@ -13,8 +13,7 @@ status: current
13
13
  <!-- UDS_SUPPORTED_VERSIONS_START -->
14
14
  | 版本 | 支援狀態 |
15
15
  |------|--------|
16
- | 5.1.0-beta.5 | ✅ 預發布版本 |
17
- | 5.0.0 | ✅ 最新正式版 |
16
+ | 5.11.0 | ✅ 最新正式版 |
18
17
  | < 5.0.0 | ❌ 已終止支援 |
19
18
  <!-- UDS_SUPPORTED_VERSIONS_END -->
20
19