universal-dev-standards 6.6.0 → 6.7.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 (177) hide show
  1. package/bundled/ai/standards/ai-response-navigation.ai.yaml +30 -3
  2. package/bundled/core/ai-response-navigation.md +62 -9
  3. package/bundled/locales/zh-CN/CHANGELOG.md +21 -2
  4. package/bundled/locales/zh-CN/README.md +1 -1
  5. package/bundled/locales/zh-CN/SECURITY.md +1 -1
  6. package/bundled/locales/zh-CN/core/ai-response-navigation.md +54 -8
  7. package/bundled/locales/zh-CN/skills/ac-coverage/SKILL.md +8 -4
  8. package/bundled/locales/zh-CN/skills/adr-assistant/SKILL.md +7 -6
  9. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +7 -2
  10. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +6 -5
  11. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +6 -5
  12. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +6 -5
  13. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +6 -5
  14. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +6 -5
  15. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +6 -5
  16. package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +7 -6
  17. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +6 -5
  18. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +6 -5
  19. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +6 -5
  20. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +6 -5
  21. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +7 -6
  22. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +7 -6
  23. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +6 -5
  24. package/bundled/locales/zh-CN/skills/deploy-assistant/SKILL.md +7 -6
  25. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +7 -6
  26. package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md +7 -6
  27. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +6 -5
  28. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +6 -5
  29. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +6 -5
  30. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +7 -3
  31. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +5 -4
  32. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +6 -5
  33. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +6 -5
  34. package/bundled/locales/zh-CN/skills/journey-test-assistant/SKILL.md +7 -4
  35. package/bundled/locales/zh-CN/skills/knowledge-graph/SKILL.md +7 -4
  36. package/bundled/locales/zh-CN/skills/logging-guide/SKILL.md +7 -6
  37. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +6 -5
  38. package/bundled/locales/zh-CN/skills/migration-assistant/SKILL.md +7 -6
  39. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +7 -3
  40. package/bundled/locales/zh-CN/skills/orchestrate/SKILL.md +7 -6
  41. package/bundled/locales/zh-CN/skills/plan/SKILL.md +7 -6
  42. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +6 -5
  43. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +6 -5
  44. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +7 -2
  45. package/bundled/locales/zh-CN/skills/push/SKILL.md +7 -6
  46. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +6 -5
  47. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +6 -5
  48. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +6 -5
  49. package/bundled/locales/zh-CN/skills/retrospective-assistant/SKILL.md +6 -5
  50. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +7 -6
  51. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +7 -3
  52. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +6 -5
  53. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +6 -5
  54. package/bundled/locales/zh-CN/skills/skill-builder/SKILL.md +7 -4
  55. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +7 -3
  56. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +7 -4
  57. package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md +7 -6
  58. package/bundled/locales/zh-CN/skills/sweep/SKILL.md +7 -6
  59. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +6 -5
  60. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +6 -5
  61. package/bundled/locales/zh-CN/skills/testing-guide/SKILL.md +7 -6
  62. package/bundled/locales/zh-TW/CHANGELOG.md +21 -2
  63. package/bundled/locales/zh-TW/README.md +1 -1
  64. package/bundled/locales/zh-TW/SECURITY.md +1 -1
  65. package/bundled/locales/zh-TW/core/ai-response-navigation.md +54 -8
  66. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +7 -3
  67. package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +7 -3
  68. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +6 -5
  69. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +7 -3
  70. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +7 -3
  71. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +7 -3
  72. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +7 -3
  73. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +7 -3
  74. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +7 -3
  75. package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +8 -4
  76. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +7 -3
  77. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +7 -3
  78. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +7 -3
  79. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +7 -3
  80. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +7 -3
  81. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +7 -3
  82. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +7 -3
  83. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +6 -5
  84. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +6 -5
  85. package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +7 -3
  86. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +7 -3
  87. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +7 -3
  88. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +7 -3
  89. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +7 -3
  90. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +7 -3
  91. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +7 -3
  92. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +7 -3
  93. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +7 -3
  94. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +7 -3
  95. package/bundled/locales/zh-TW/skills/logging-guide/SKILL.md +8 -4
  96. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +7 -3
  97. package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +7 -3
  98. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +7 -3
  99. package/bundled/locales/zh-TW/skills/orchestrate/SKILL.md +6 -5
  100. package/bundled/locales/zh-TW/skills/plan/SKILL.md +6 -5
  101. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +7 -3
  102. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +7 -3
  103. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +6 -5
  104. package/bundled/locales/zh-TW/skills/push/SKILL.md +6 -5
  105. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +7 -3
  106. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +7 -3
  107. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +7 -3
  108. package/bundled/locales/zh-TW/skills/retrospective-assistant/SKILL.md +7 -3
  109. package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +7 -3
  110. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +7 -3
  111. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +7 -3
  112. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +7 -3
  113. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +7 -3
  114. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +7 -3
  115. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +7 -3
  116. package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +7 -3
  117. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +6 -5
  118. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +7 -3
  119. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +7 -3
  120. package/bundled/locales/zh-TW/skills/testing-guide/SKILL.md +8 -3
  121. package/bundled/skills/ac-coverage/SKILL.md +5 -1
  122. package/bundled/skills/adr-assistant/SKILL.md +1 -0
  123. package/bundled/skills/ai-collaboration-standards/SKILL.md +1 -0
  124. package/bundled/skills/ai-friendly-architecture/SKILL.md +1 -0
  125. package/bundled/skills/ai-instruction-standards/SKILL.md +1 -0
  126. package/bundled/skills/api-design-assistant/SKILL.md +1 -0
  127. package/bundled/skills/atdd-assistant/SKILL.md +5 -1
  128. package/bundled/skills/audit-assistant/SKILL.md +5 -1
  129. package/bundled/skills/bdd-assistant/SKILL.md +5 -1
  130. package/bundled/skills/brainstorm-assistant/SKILL.md +5 -1
  131. package/bundled/skills/changelog-guide/SKILL.md +5 -1
  132. package/bundled/skills/checkin-assistant/SKILL.md +5 -1
  133. package/bundled/skills/ci-cd-assistant/SKILL.md +1 -0
  134. package/bundled/skills/code-review-assistant/SKILL.md +5 -1
  135. package/bundled/skills/commit-standards/SKILL.md +5 -1
  136. package/bundled/skills/contract-test-assistant/SKILL.md +1 -0
  137. package/bundled/skills/database-assistant/SKILL.md +1 -0
  138. package/bundled/skills/deploy-assistant/SKILL.md +1 -0
  139. package/bundled/skills/dev-methodology/SKILL.md +5 -1
  140. package/bundled/skills/dev-workflow-guide/SKILL.md +5 -1
  141. package/bundled/skills/docs-generator/SKILL.md +5 -1
  142. package/bundled/skills/documentation-guide/SKILL.md +1 -0
  143. package/bundled/skills/durable-execution-assistant/SKILL.md +5 -1
  144. package/bundled/skills/e2e-assistant/SKILL.md +5 -1
  145. package/bundled/skills/error-code-guide/SKILL.md +1 -0
  146. package/bundled/skills/git-workflow-guide/SKILL.md +1 -0
  147. package/bundled/skills/incident-response-assistant/SKILL.md +1 -0
  148. package/bundled/skills/journey-test-assistant/SKILL.md +5 -1
  149. package/bundled/skills/knowledge-graph/SKILL.md +5 -1
  150. package/bundled/skills/logging-guide/SKILL.md +1 -0
  151. package/bundled/skills/metrics-dashboard-assistant/SKILL.md +5 -1
  152. package/bundled/skills/migration-assistant/SKILL.md +5 -1
  153. package/bundled/skills/observability-assistant/SKILL.md +1 -0
  154. package/bundled/skills/orchestrate/SKILL.md +1 -0
  155. package/bundled/skills/plan/SKILL.md +1 -0
  156. package/bundled/skills/pr-automation-assistant/SKILL.md +1 -0
  157. package/bundled/skills/project-discovery/SKILL.md +5 -1
  158. package/bundled/skills/project-structure-guide/SKILL.md +1 -0
  159. package/bundled/skills/push/SKILL.md +1 -0
  160. package/bundled/skills/refactoring-assistant/SKILL.md +5 -1
  161. package/bundled/skills/release-standards/SKILL.md +5 -1
  162. package/bundled/skills/requirement-assistant/SKILL.md +5 -1
  163. package/bundled/skills/retrospective-assistant/SKILL.md +1 -0
  164. package/bundled/skills/reverse-engineer/SKILL.md +5 -1
  165. package/bundled/skills/runbook-assistant/SKILL.md +1 -0
  166. package/bundled/skills/security-assistant/SKILL.md +1 -0
  167. package/bundled/skills/security-scan-assistant/SKILL.md +1 -0
  168. package/bundled/skills/skill-builder/SKILL.md +5 -1
  169. package/bundled/skills/slo-assistant/SKILL.md +1 -0
  170. package/bundled/skills/spec-derivation/SKILL.md +5 -1
  171. package/bundled/skills/spec-driven-dev/SKILL.md +5 -1
  172. package/bundled/skills/sweep/SKILL.md +1 -0
  173. package/bundled/skills/tdd-assistant/SKILL.md +5 -1
  174. package/bundled/skills/test-coverage-assistant/SKILL.md +5 -1
  175. package/bundled/skills/testing-guide/SKILL.md +1 -0
  176. package/package.json +1 -1
  177. package/standards-registry.json +7 -7
@@ -2,10 +2,14 @@
2
2
  name: atdd-assistant
3
3
  source: ../../../../skills/atdd-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-02-10
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 引導驗收測試驅動開發(ATDD)流程,用於定義和驗證使用者故事"
8
+ description: |
9
+ [UDS] 驗收測試驅動開發(ATDD)的參考資料:INVEST 準則、Gherkin 驗收條件格式與 Three Amigos 結構。
10
+ Use when: 與 Product Owner 一起定義驗收條件、進行規格工作坊、用 INVEST 檢視使用者故事。
11
+ Not for: 執行 ATDD 生命週期或強制 PO 簽核關卡——該部分已移至採用層(XSPEC-095);撰寫單元測試——請用 /tdd。
12
+ Keywords: ATDD, acceptance test, acceptance criteria, INVEST, specification workshop, Three Amigos, 驗收測試驅動開發, 驗收條件, 規格工作坊.
9
13
  ---
10
14
 
11
15
  # ATDD 助手
@@ -2,10 +2,14 @@
2
2
  name: audit-assistant
3
3
  source: ../../../../skills/audit-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-03-04
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] UDS 健康檢查與回饋系統,診斷安裝完整性與偵測開發模式"
8
+ description: |
9
+ [UDS] 診斷 UDS 安裝的健康狀態,並向上游提交結構化回饋。
10
+ Use when: .standards/ 看起來壞掉或不同步、驗證 manifest 完整性、回報既有 UDS 標準用起來的摩擦點。
11
+ Not for: 稽核你自己應用程式的程式碼品質——請用 /metrics 或 /code-review;相依套件與機密掃描——請用 /scan。
12
+ Keywords: UDS audit, health check, manifest integrity, standards feedback, friction, 安裝健康, 標準稽核, 回饋, 完整性檢查.
9
13
  ---
10
14
 
11
15
  # 審計助手
@@ -2,10 +2,14 @@
2
2
  name: bdd-assistant
3
3
  source: ../../../../skills/bdd-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-02-10
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 引導行為驅動開發(BDD)流程,使用 Given-When-Then 格式撰寫場景"
8
+ description: |
9
+ [UDS] 行為驅動開發(BDD)的參考資料:Gherkin 的 Given-When-Then 格式與 Three Amigos 結構。
10
+ Use when: 撰寫或審查 .feature 場景、選定通用語言、針對行為進行探索式對話。
11
+ Not for: 執行 BDD 生命週期或 RED/GREEN 自動化——該部分已移至採用層(XSPEC-095);把 .feature 檔轉成 E2E 骨架——請用 /e2e。
12
+ Keywords: BDD, Gherkin, Given When Then, feature file, scenario, Three Amigos, 行為驅動開發, 場景, 特性檔, 通用語言.
9
13
  ---
10
14
 
11
15
  # BDD 助手
@@ -2,11 +2,15 @@
2
2
  name: brainstorm-assistant
3
3
  source: ../../../../skills/brainstorm-assistant/SKILL.md
4
4
  source_version: 4.1.0
5
- source_hash: 0c1fa3392232
6
- translation_version: 4.1.0
7
- last_synced: 2026-07-09
5
+ source_hash: 711404f2c4af
6
+ translation_version: 4.2.0
7
+ last_synced: 2026-08-17
8
8
  status: current
9
- description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
9
+ description: |
10
+ [UDS] 在規格出現之前執行的結構化多角色腦力激盪,並附帶評分品質關卡。
11
+ Use when: 想法還很模糊、在敲定方向前探索替代方案、需要多樣性而不是第一個看似合理的答案。
12
+ Not for: 方向已經定了的工作規劃——請用 /plan 或 /sdd;記錄已經做成的決策——請用 /adr。
13
+ Keywords: brainstorm, ideation, divergence, convergence, persona ensemble, devil advocate, 腦力激盪, 發想, 發散收斂, 多角色.
10
14
  ---
11
15
 
12
16
  # 腦力激盪助手
@@ -2,10 +2,14 @@
2
2
  name: changelog-guide
3
3
  source: ../../../../skills/changelog-guide/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-02-10
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 根據 Keep a Changelog 格式產生和維護 CHANGELOG.md 條目"
8
+ description: |
9
+ [UDS] 以 Keep a Changelog 格式產生並維護 CHANGELOG.md 條目。
10
+ Use when: 從 commit 歷史撰寫變更日誌條目、填寫 Unreleased 區段、將變更分類為 Added/Changed/Fixed。
11
+ Not for: 決定下一個版本號或執行發版——請用 /release;撰寫 commit message 本身——請用 /commit。
12
+ Keywords: changelog, CHANGELOG.md, Keep a Changelog, release notes, unreleased, 變更日誌, 發布說明, 版本紀錄.
9
13
  ---
10
14
 
11
15
  # 變更日誌助手
@@ -2,10 +2,14 @@
2
2
  name: checkin-assistant
3
3
  source: ../../../../skills/checkin-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-02-10
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 在提交程式碼前驗證品質關卡,確保程式碼庫穩定性"
8
+ description: |
9
+ [UDS] 提交前品質關卡的參考資料:關卡定義、檢查清單項目,以及絕不可提交的規則。
10
+ Use when: 決定 commit 前必須通過哪些檢查、稽核專案實際強制了哪些品質關卡、確認是否已可簽入。
11
+ Not for: 執行關卡流程或中止 commit——該部分已移至採用層(XSPEC-095);找出並清除除錯殘留——請用 /sweep。
12
+ Keywords: check-in, pre-commit, quality gate, commit readiness, never commit, 簽入, 提交前檢查, 品質關卡, 檢查清單.
9
13
  ---
10
14
 
11
15
  # 簽入助手
@@ -2,10 +2,14 @@
2
2
  name: ci-cd-assistant
3
3
  source: ../../../../skills/ci-cd-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-03-24
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 引導 CI/CD 管線設計、配置和優化"
8
+ description: |
9
+ 引導 CI/CD 管線的設計、設定與最佳化。
10
+ Use when: 建置管線、縮短建置時間、設定部署階段。
11
+ Not for: 沒有 CI/CD 平台的部署——請用 /deploy;版本號遞增與晉級——請用 /release。
12
+ Keywords: CI/CD, pipeline, GitHub Actions, deployment, build, 持續整合, 持續部署, 管線.
9
13
  ---
10
14
 
11
15
  # CI/CD 管線助手
@@ -2,10 +2,14 @@
2
2
  name: code-review-assistant
3
3
  source: ../../../../skills/code-review-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-02-10
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 使用標準化檢查清單執行系統性程式碼審查"
8
+ description: |
9
+ [UDS] 系統性程式碼審查的參考資料:八大審查類別,以及 BLOCKING/IMPORTANT/SUGGESTION 評論前綴。
10
+ Use when: 審查 pull request 或 diff、決定審查意見的措辭與優先序、與團隊議定審查範圍。
11
+ Not for: 執行有關卡的審查流程——該部分已移至採用層(XSPEC-095);提交前的關卡驗證——請用 /checkin。
12
+ Keywords: code review, pull request review, review checklist, BLOCKING, comment prefix, 程式碼審查, 審查類別, 評論前綴, 審查清單.
9
13
  ---
10
14
 
11
15
  # 程式碼審查助手
@@ -3,10 +3,14 @@ name: commit-standards
3
3
  source: ../../../../skills/commit-standards/SKILL.md
4
4
  source_version: 1.0.0
5
5
  source_hash: 8535f438ced8
6
- translation_version: 1.0.0
7
- last_synced: 2026-06-01
6
+ translation_version: 1.1.0
7
+ last_synced: 2026-08-17
8
8
  status: current
9
- description: "[UDS] 根據 Conventional Commits 規範產生格式正確的 commit message"
9
+ description: |
10
+ [UDS] 產生符合 Conventional Commits 規範的 commit message,包含雙語格式。
11
+ Use when: 為已暫存的變更撰寫 commit message、選擇 type 與 scope、產出英文與中文並列的主旨與內文。
12
+ Not for: 判斷這份變更是否已可提交——請用 /checkin;把多個 commit 彙整成發布說明——請用 /changelog。
13
+ Keywords: commit message, Conventional Commits, feat, fix, refactor, scope, bilingual, 提交訊息, 雙語 commit, 提交規範.
10
14
  ---
11
15
 
12
16
  # Commit Message 助手
@@ -3,10 +3,14 @@ name: contract-test-assistant
3
3
  source: ../../../../skills/contract-test-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
5
  source_hash: f67623eb913a
6
- translation_version: 1.0.0
7
- last_synced: 2026-06-01
6
+ translation_version: 1.1.0
7
+ last_synced: 2026-08-17
8
8
  status: current
9
- description: "[UDS] 引導 API 和微服務的合約測試策略"
9
+ description: |
10
+ [UDS] 引導 API 與微服務的合約測試策略。
11
+ Use when: API 合約、微服務、消費者驅動測試、提供者驗證。
12
+ Not for: 一開始的 API 介面設計——請用 /api-design;經由 UI 的使用者可見流程——請用 /e2e。
13
+ Keywords: contract test, Pact, OpenAPI, consumer-driven, provider, 合約測試, 消費者驅動, 提供者驗證.
10
14
  ---
11
15
 
12
16
  # 合約測試助手
@@ -2,10 +2,14 @@
2
2
  name: database-assistant
3
3
  source: ../../../../skills/database-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-03-23
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 引導資料庫設計、遷移規劃和查詢最佳化"
8
+ description: |
9
+ 引導資料庫設計、遷移與查詢最佳化。
10
+ Use when: schema 設計、遷移規劃、查詢最佳化、索引策略。
11
+ Not for: 應用程式碼遷移或框架升級——請用 /migrate;資料之上的 API 合約——請用 /api-design。
12
+ Keywords: database, schema, migration, SQL, index, query, 資料庫, 遷移, 查詢, 索引策略.
9
13
  ---
10
14
 
11
15
  # 資料庫助手
@@ -2,13 +2,14 @@
2
2
  name: deploy
3
3
  source: ../../../../skills/deploy-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-05-28
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  scope: universal
8
8
  description: |
9
- [UDS] 無 CI/CD 平台環境下的可靠部署指引(不依賴 GitHub Actions / GitLab CI)。
10
- Use when: deploying to VPS, air-gapped servers, or environments without CI/CD infrastructure.
11
- Keywords: deployment, no-cicd, shell script, blue-green, smoke test, rollback, 無CI/CD, 部署.
9
+ 引導在沒有 CI/CD 平台(GitHub Actions/GitLab CI)的情況下完成可靠部署。
10
+ Use when: 部署到 VPS、離線隔離的伺服器,或任何沒有 CI/CD 基礎設施的環境。
11
+ Not for: 建立在 GitHub Actions 或 GitLab CI 上的管線——請用 /ci-cd;版本號遞增與發布晉級——請用 /release。
12
+ Keywords: deployment, no-cicd, shell script, blue-green, smoke test, rollback, 無 CI/CD, 部署, 藍綠部署, 回滾.
12
13
  allowed-tools: Read, Bash(cat VERSION:*), Bash(git describe:*), Bash(which nginx:*), Bash(which rsync:*)
13
14
  argument-hint: "[專案類型: node/python/docker/go]"
14
15
  ---
@@ -2,13 +2,14 @@
2
2
  name: methodology
3
3
  source: ../../../../skills/dev-methodology/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-05-28
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  scope: partial
8
8
  description: |
9
- [UDS] /methodology: 選擇並追蹤開發方法論(SDD/BDD/TDD)。
10
- Use when: 選擇方法論、切換開發模式、查詢當前方法論狀態。
11
- 若要查詢各階段對應指令請用 /dev-workflow。
9
+ [UDS] 為專案選擇並追蹤當前採用的開發方法論(SDD、BDD、TDD)。
10
+ Use when: 決定專案該遵循哪一套方法論、切換方法論、查詢目前方法論處於哪個階段。
11
+ Not for: 查詢某個開發階段該執行哪個指令——請用 /dev-workflow;執行方法論本身——請用 /sdd、/bdd 或 /tdd。
12
+ Keywords: methodology, SDD, BDD, TDD, phase tracking, methodology selection, 方法論, 開發方法選擇, 階段追蹤.
12
13
  allowed-tools: Read, Write, Grep, Glob
13
14
  argument-hint: "[動作] [參數]"
14
15
  ---
@@ -2,11 +2,15 @@
2
2
  name: dev-workflow-guide
3
3
  source: ../../../../skills/dev-workflow-guide/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-06-02
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  source_hash: 5bf83f0db544
8
8
  status: current
9
- description: "[UDS] 將軟體開發階段對應到 UDS 指令與功能的指南"
9
+ description: |
10
+ [UDS] 把目前的軟體開發階段對應到正確的 UDS 指令與 Skill。
11
+ Use when: 不確定手上的任務該用哪個 UDS 指令、初次上手 UDS、帶著一個功能從規劃走到發布。
12
+ Not for: 選擇或切換方法論——請用 /methodology;實際執行某階段的工作——請用該階段自己的 Skill。
13
+ Keywords: workflow, development phase, command routing, which command, UDS guide, 開發階段, 指令對照, 流程指南.
10
14
  ---
11
15
 
12
16
  # 開發工作流程指南
@@ -2,10 +2,14 @@
2
2
  name: docs-generator
3
3
  source: ../../../../skills/docs-generator/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-02-10
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 從專案原始檔案產生使用文件(速查表、參考手冊、使用指南)"
8
+ description: |
9
+ [UDS] 從專案原始檔產生使用文件(速查表、參考手冊、使用指南)。
10
+ Use when: 從 CLI 與 Skill 定義產出速查表或功能參考手冊、指令變更後重新產生文件、確認產生的文件是否為最新。
11
+ Not for: 決定專案需要哪些文件或手寫敘述性內容——請用 /documentation-guide;變更日誌條目——請用 /changelog。
12
+ Keywords: docgen, usage docs, cheatsheet, feature reference, generated documentation, 使用文件, 速查表, 文件產生, 參考手冊.
9
13
  ---
10
14
 
11
15
  # 文件產生器
@@ -2,10 +2,14 @@
2
2
  name: documentation-guide
3
3
  source: ../../../../skills/documentation-guide/SKILL.md
4
4
  source_version: 2.1.0
5
- translation_version: 2.1.0
6
- last_synced: 2026-03-17
5
+ translation_version: 2.2.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 引導文件結構、內容需求和專案文件最佳實踐"
8
+ description: |
9
+ 引導文件結構、內容需求與專案文件的最佳實踐。
10
+ Use when: 建立 README、撰寫文件、規劃 docs 目錄、專案初始設定、技術文件。
11
+ Not for: 從原始碼機械式產生文件——請用 /docgen;變更日誌條目——請用 /changelog。
12
+ Keywords: README, docs, documentation, CONTRIBUTING, CHANGELOG, ARCHITECTURE, API docs, 文件, 說明文件, 技術文件.
9
13
  ---
10
14
 
11
15
  # 文件指南
@@ -2,10 +2,14 @@
2
2
  name: durable-execution-assistant
3
3
  source: ../../../../skills/durable-execution-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-03-24
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 引導工作流程故障恢復,包含檢查點、重試與回滾策略"
8
+ description: |
9
+ [UDS] 引導容錯工作流程設計,包含檢查點、重試策略與回滾計畫。
10
+ Use when: 長時間執行的工作流程總是中途失敗、設計檢查點的粒度、選擇重試或退避策略。
11
+ Not for: 處理正在發生中的線上事故——請用 /incident;部署回滾的實作機制——請用 /deploy。
12
+ Keywords: durable execution, checkpoint, retry, backoff, idempotency, rollback, 持久執行, 檢查點, 重試策略, 冪等.
9
13
  ---
10
14
 
11
15
  # 持久執行助手
@@ -2,10 +2,14 @@
2
2
  name: e2e-assistant
3
3
  source: ../../../../skills/e2e-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-04-10
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 從 BDD 場景生成 E2E 測試骨架,支援框架偵測與覆蓋差距分析"
8
+ description: |
9
+ [UDS] 從 BDD 的 .feature 場景產生 E2E 測試骨架,並支援框架偵測與覆蓋缺口分析。
10
+ Use when: 把已完成的 .feature 場景轉成可執行的 E2E 骨架、偵測專案使用的 E2E 框架、找出沒有 E2E 覆蓋的 AC。
11
+ Not for: 跨多個故事且帶有共用狀態的旅程——請用 journey-test Skill;撰寫 .feature 場景本身——請用 /bdd。
12
+ Keywords: E2E, end-to-end test, feature file, test skeleton, framework detection, 端對端測試, 測試骨架, 場景轉測試, 覆蓋缺口.
9
13
  ---
10
14
 
11
15
  # E2E 助手
@@ -1,10 +1,14 @@
1
1
  ---
2
2
  name: errors
3
- description: "[UDS] 設計一致的錯誤碼,遵循 PREFIX_CATEGORY_NUMBER 格式"
3
+ description: |
4
+ 設計一致的錯誤碼,遵循 PREFIX_CATEGORY_NUMBER 格式。
5
+ Use when: 定義錯誤碼、建立錯誤處理機制、設計 API。
6
+ Not for: 日誌格式與層級——請用 /logging-guide;處理已經到達正式環境的錯誤——請用 /incident。
7
+ Keywords: error code, error handling, error format, API errors, 錯誤碼, 錯誤處理, 錯誤格式.
4
8
  source: ../../../../skills/error-code-guide/SKILL.md
5
9
  source_version: 1.0.0
6
- translation_version: 1.0.0
7
- last_synced: 2026-01-08
10
+ translation_version: 1.1.0
11
+ last_synced: 2026-08-17
8
12
  status: current
9
13
  ---
10
14
 
@@ -1,11 +1,15 @@
1
1
  ---
2
2
  source: ../../../../skills/git-workflow-guide/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2025-12-25
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  name: git-flow
8
- description: "[UDS] 指導 Git 分支策略、分支命名與合併操作"
8
+ description: |
9
+ 引導 Git 分支策略、分支命名與合併操作。
10
+ Use when: 建立分支、合併、pull request、Git 工作流程相關問題。
11
+ Not for: 撰寫 commit message——請用 /commit;推送前的安全檢查——請用 /push。
12
+ Keywords: branch, merge, PR, pull request, GitFlow, GitHub Flow, 分支, 合併, 工作流程, 分支命名.
9
13
  ---
10
14
 
11
15
  # Git 工作流程指南
@@ -2,10 +2,14 @@
2
2
  name: incident-response-assistant
3
3
  source: ../../../../skills/incident-response-assistant/SKILL.md
4
4
  source_version: 1.1.0
5
- translation_version: 1.1.0
6
- last_synced: 2026-03-26
5
+ translation_version: 1.2.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 引導事故回應、根因分析和事後檢討文件撰寫"
8
+ description: |
9
+ 引導事故回應、根因分析與事後檢討文件撰寫。
10
+ Use when: 正式環境事故、服務中斷回應、撰寫事後檢討、根因分析(RCA)。
11
+ Not for: 在故障發生前設計重試與檢查點——請用 /durable;設定告警門檻與 Error Budget 政策——請用 /slo。
12
+ Keywords: incident, outage, post-mortem, RCA, root cause, 事故, 服務中斷, 事後檢討, 根因分析.
9
13
  ---
10
14
 
11
15
  # 事故回應助手
@@ -2,10 +2,14 @@
2
2
  name: journey-test-assistant
3
3
  source: ../../../../skills/journey-test-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-05-28
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  scope: partial
8
- description: "[UDS] 從專案描述生成連貫使用者旅程測試計畫(TESTPLAN)與 E2E 骨架"
8
+ description: |
9
+ [UDS] 從專案描述產生連貫的使用者旅程測試計畫(TESTPLAN)與旅程 E2E 骨架。
10
+ Use when: 新專案從第一天就需要一條測試旅程、測試跨多個故事延續的狀態、建立以人物誌驅動的旅程計畫。
11
+ Not for: 單一 AC 的獨立 E2E 骨架——請用 /e2e;量測實際達成的程式碼覆蓋率——請用 /coverage。
12
+ Keywords: user journey, TESTPLAN, journey test, persona, cross-story state, 使用者旅程, 旅程測試, 測試計畫, 人物誌.
9
13
  allowed-tools: Read, Write, Grep, Glob
10
14
  argument-hint: "[專案描述 | --analyze | --archetype A1|A2|A3]"
11
15
  status: stable
@@ -2,10 +2,14 @@
2
2
  name: knowledge-graph
3
3
  source: ../../../../skills/knowledge-graph/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-05-30
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 透過知識圖追蹤規格/決策/程式碼的影響鏈(引擎或 Markdown 後備)"
8
+ description: |
9
+ [UDS] 透過知識圖追蹤規格、決策與程式碼之間的影響鏈;沒有引擎時以 Markdown 後備方案運作。
10
+ Use when: 想知道某份規格或決策會影響到什麼、找出哪些程式碼實作了某個產物、追蹤規格、ADR 與模組之間的相依關係。
11
+ Not for: 沒有規格或決策錨點的純文字搜尋——請用 Grep;撰寫規格本身——請用 /sdd。
12
+ Keywords: knowledge graph, impact chain, traceability, spec impact, decision graph, 知識圖, 影響鏈, 規格追蹤, 相依關係.
9
13
  ---
10
14
 
11
15
  # 知識圖
@@ -1,11 +1,15 @@
1
1
  ---
2
2
  name: logging
3
- description: "[UDS] 實作結構化日誌,包含正確的日誌層級和敏感資料處理"
3
+ description: |
4
+ 實作結構化日誌,包含適當的日誌層級與敏感資料處理。
5
+ Use when: 加入日誌、除錯、建立可觀測性。
6
+ Not for: 指標、追蹤與告警設計——請用 /observability;錯誤碼分類體系——請用 /error-code-guide。
7
+ Keywords: logging, log level, structured logging, observability, 日誌, 結構化日誌, 日誌層級, 敏感資料.
4
8
  source: ../../../../skills/logging-guide/SKILL.md
5
9
  source_version: 1.4.0
6
- translation_version: 1.4.0
7
- last_synced: 2026-07-08
8
- source_hash: cf114de1df86
10
+ translation_version: 1.5.0
11
+ last_synced: 2026-08-17
12
+ source_hash: ca969fdf7847
9
13
  status: current
10
14
  ---
11
15
 
@@ -2,10 +2,14 @@
2
2
  name: metrics-dashboard-assistant
3
3
  source: ../../../../skills/metrics-dashboard-assistant/SKILL.md
4
4
  source_version: 1.1.0
5
- translation_version: 1.1.0
6
- last_synced: 2026-03-26
5
+ translation_version: 1.2.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 追蹤開發指標、程式碼品質指示器與專案健康狀態"
8
+ description: |
9
+ [UDS] 長期追蹤開發指標、程式碼品質指標與技術債。
10
+ Use when: 評估專案的持續健康狀態、分類技術債並觀察其趨勢、向團隊回報程式碼品質。
11
+ Not for: 初次評估一個不熟悉的程式碼庫——請用 /discover;單看測試覆蓋率——請用 /coverage 或 /ac-coverage。
12
+ Keywords: metrics, code quality, technical debt, project health, debt trend, 開發指標, 技術債, 專案健康度, 品質趨勢.
9
13
  ---
10
14
 
11
15
  # 開發指標助手
@@ -3,10 +3,14 @@ name: migration-assistant
3
3
  source: ../../../../skills/migration-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
5
  source_hash: 67b6f33f825e
6
- translation_version: 1.0.0
7
- last_synced: 2026-06-01
6
+ translation_version: 1.1.0
7
+ last_synced: 2026-08-17
8
8
  status: current
9
- description: "[UDS] 引導程式碼遷移、框架升級與技術現代化"
9
+ description: |
10
+ [UDS] 引導系統性的程式碼遷移、框架升級與技術現代化。
11
+ Use when: 規劃框架或主版本升級、評估遷移風險、在 API 遷移前先擷取合約測試的固定樣本。
12
+ Not for: 維持同一套框架的原地改善——請用 /refactor;資料庫 schema 設計——請用 /database。
13
+ Keywords: migration, framework upgrade, modernization, breaking change, dependency upgrade, 遷移, 升級, 技術現代化, 破壞性變更.
10
14
  ---
11
15
 
12
16
  # 遷移助手
@@ -2,10 +2,14 @@
2
2
  name: observability-assistant
3
3
  source: ../../../../skills/observability-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-04-10
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 引導可觀測性設定、指標設計和告警配置"
8
+ description: |
9
+ 引導可觀測性建置、指標設計與告警設定。
10
+ Use when: 新服務的埋點、SLO 定義、告警設計、成熟度評估。
11
+ Not for: 設定數值目標與 Error Budget 政策——請用 /slo;日誌格式與層級——請用 /logging-guide。
12
+ Keywords: observability, metrics, traces, golden signals, alerting, SLO, 可觀測性, 指標, 追蹤, 告警.
9
13
  ---
10
14
 
11
15
  # 可觀測性助手
@@ -2,14 +2,15 @@
2
2
  name: orchestrate
3
3
  source: ../../../../skills/orchestrate/SKILL.md
4
4
  source_version: 2.0.0
5
- translation_version: 2.0.0
6
- last_synced: 2026-06-02
5
+ translation_version: 2.1.0
6
+ last_synced: 2026-08-17
7
7
  source_hash: 40e97479c7da
8
8
  scope: universal
9
9
  description: |
10
- [UDS] 以 Claude 原生 Agent tool 編排多任務執行計畫(DAG-based,無外部引擎)。
11
- Use when: executing a plan.json file with parallel/sequential task dependencies.
12
- Keywords: orchestrate, plan, execute, DAG, task plan, 編排, 執行計畫, 並行.
10
+ 以 Claude 原生 Agent tool 編排多任務執行計畫(以 DAG 為基礎,不需外部引擎)。
11
+ Use when: 執行帶有平行/循序任務相依關係的 plan.json 檔案。
12
+ Not for: 一開始產生計畫——請用 /plan;彼此之間沒有相依關係的單一任務。
13
+ Keywords: orchestrate, plan, execute, DAG, task plan, 編排, 執行計畫, 並行, 任務相依.
13
14
  argument-hint: "<plan.json> [--dry-run]"
14
15
  ---
15
16
 
@@ -2,14 +2,15 @@
2
2
  name: plan
3
3
  source: ../../../../skills/plan/SKILL.md
4
4
  source_version: 2.0.0
5
- translation_version: 2.0.0
6
- last_synced: 2026-06-02
5
+ translation_version: 2.1.0
6
+ last_synced: 2026-08-17
7
7
  source_hash: 6fbb1a1b8040
8
8
  scope: universal
9
9
  description: |
10
- [UDS] 從 Spec 文件、OpenSpec 變更或自由文字需求生成 plan.json。
11
- Use when: converting specifications into executable task plans for /orchestrate.
12
- Keywords: plan, spec, task plan, 計畫, 規格, 任務, plan.json, DAG.
10
+ 從 Spec 文件、OpenSpec 變更或自由文字需求生成 plan.json。
11
+ Use when: 把規格轉換成可供 /orchestrate 執行的任務計畫。
12
+ Not for: 執行產出的計畫——請用 /orchestrate;判斷這個想法值不值得做——請用 /brainstorm。
13
+ Keywords: plan, spec, task plan, plan.json, DAG, 計畫, 規格, 任務, 任務計畫.
13
14
  argument-hint: "[spec-file.md | openspec-dir/ | \"需求描述文字\" | (互動模式)]"
14
15
  ---
15
16
 
@@ -2,10 +2,14 @@
2
2
  name: pr-automation-assistant
3
3
  source: ../../../../skills/pr-automation-assistant/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-03-23
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 引導 Pull Request 建立、審查自動化和合併策略"
8
+ description: |
9
+ 引導 pull request 建立、審查自動化與合併策略。
10
+ Use when: 建立 PR、自動化審查流程、設定合併政策。
11
+ Not for: 審查本身的內容實質——請用 /code-review;分支命名與合併策略——請用 /git-workflow-guide。
12
+ Keywords: pull request, PR, merge, review, GitHub, GitLab, 合併請求, 審查自動化, 合併策略.
9
13
  ---
10
14
 
11
15
  # PR 自動化助手
@@ -2,10 +2,14 @@
2
2
  name: project-discovery
3
3
  source: ../../../../skills/project-discovery/SKILL.md
4
4
  source_version: 1.1.0
5
- translation_version: 1.1.0
6
- last_synced: 2026-03-26
5
+ translation_version: 1.2.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
- description: "[UDS] 在既有程式碼庫新增功能前的 Phase 0 評估,評估專案健康度與風險"
8
+ description: |
9
+ [UDS] 在既有程式碼庫新增功能之前,評估專案健康度、架構與風險。
10
+ Use when: 接手不熟悉或老舊的專案、動工前先估算風險、建立風險登記簿。
11
+ Not for: 對已經熟悉的程式碼庫做持續指標追蹤——請用 /metrics;從程式碼回推規格——請用 /reverse。
12
+ Keywords: discovery, project assessment, legacy onboarding, risk register, technical debt, 現況評估, 專案盤點, 風險登記簿, 老舊系統.
9
13
  ---
10
14
 
11
15
  # 專案現況評估
@@ -2,13 +2,14 @@
2
2
  name: project-structure-guide
3
3
  source: ../../../../skills/project-structure-guide/SKILL.md
4
4
  source_version: 1.1.0
5
- translation_version: 1.1.0
6
- last_synced: 2026-05-28
5
+ translation_version: 1.2.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
8
  description: |
9
- [UDS] 引導依語言特性最佳實踐組織專案目錄結構。
10
- Use when: creating projects, reorganizing structure, adding modules, setting up builds, deciding file placement.
11
- Keywords: project, structure, directory, layout, gitignore, scaffold, file placement, 專案結構, 目錄配置.
9
+ 依各語言的最佳實踐組織專案目錄結構的指南。
10
+ Use when: 建立專案、重整結構、新增模組、設定建置流程、決定檔案該放哪裡。
11
+ Not for: 專門為 AI 導覽而設計的結構——請用 /ai-friendly-architecture;原地重整既有程式碼——請用 /refactor。
12
+ Keywords: project, structure, directory, layout, gitignore, scaffold, file placement, utils, helpers, shared, 專案結構, 目錄配置, 檔案擺放.
12
13
  ---
13
14
 
14
15
  # 專案結構指南