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
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/ci-cd-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-03-24
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 引导 CI/CD 管线设计、配置和优化。
9
- 使用时机:设置管线、优化构建时间、配置部署阶段。
10
- 关键字:CI/CD, pipeline, GitHub Actions, deployment, build, 持续集成, 持续部署。
8
+ 引导 CI/CD 流水线的设计、配置与优化。
9
+ Use when: 搭建流水线、缩短构建时间、配置部署阶段。
10
+ Not for: 没有 CI/CD 平台的部署——请用 /deploy;版本号递增与晋级——请用 /release。
11
+ Keywords: CI/CD, pipeline, GitHub Actions, deployment, build, 持续集成, 持续部署, 流水线.
11
12
  ---
12
13
 
13
14
  # CI/CD 管线助手
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/code-review-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-02-10
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 使用标准化检查清单执行系统性代码审查。
9
- 使用时机:审查代码、PR 审查、代码品质检查。
10
- 关键字:review, code review, PR, checklist, 审查, 代码, 品质。
8
+ [UDS] 系统性代码审查的参考资料:八大审查类别,以及 BLOCKING/IMPORTANT/SUGGESTION 评论前缀。
9
+ Use when: 审查 pull request 或 diff、决定审查意见的措辞与优先级、与团队议定审查范围。
10
+ Not for: 执行有关卡的审查流程——该部分已移至采用层(XSPEC-095);提交前的关卡验证——请用 /checkin。
11
+ Keywords: code review, pull request review, review checklist, BLOCKING, comment prefix, 代码审查, 审查类别, 评论前缀, 审查清单.
11
12
  ---
12
13
 
13
14
  # 代码审查助手
@@ -1,14 +1,15 @@
1
1
  ---
2
2
  source: ../../../../skills/commit-standards/SKILL.md
3
3
  source_version: 1.0.0
4
- source_hash: bc13c6166e8d
5
- translation_version: 1.0.0
6
- last_synced: 2026-07-09
4
+ source_hash: 4a341b634146
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
8
  description: |
9
- [UDS] 根据 Conventional Commits 规范产生格式正确的 commit message。
10
- 使用时机:提交代码、撰写 commit message、检查提交格式。
11
- 关键字:commit, conventional commits, 提交, 消息, feat, fix, refactor。
9
+ [UDS] 生成符合 Conventional Commits 规范的 commit message,包含双语格式。
10
+ Use when: 为已暂存的变更撰写 commit message、选择 type 与 scope、产出英文与中文并列的主旨与正文。
11
+ Not for: 判断这份变更是否已可提交——请用 /checkin;把多个 commit 汇整成发布说明——请用 /changelog。
12
+ Keywords: commit message, Conventional Commits, feat, fix, refactor, scope, bilingual, 提交信息, 双语 commit, 提交规范.
12
13
  ---
13
14
 
14
15
  # Commit Message 助手
@@ -1,14 +1,15 @@
1
1
  ---
2
2
  source: ../../../../skills/contract-test-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- source_hash: c8b082114d48
5
- translation_version: 1.0.0
6
- last_synced: 2026-07-09
4
+ source_hash: 35b654f0b277
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
8
  description: |
9
- [UDS] 引导 API 和微服务的契约测试策略。
10
- 使用时机:API 契约、微服务、消费者驱动测试。
11
- 关键字:contract test, Pact, OpenAPI, 契约测试。
9
+ [UDS] 引导 API 与微服务的契约测试策略。
10
+ Use when: API 契约、微服务、消费者驱动测试、提供者验证。
11
+ Not for: 一开始的 API 接口设计——请用 /api-design;经由 UI 的用户可见流程——请用 /e2e。
12
+ Keywords: contract test, Pact, OpenAPI, consumer-driven, provider, 契约测试, 消费者驱动, 提供者验证.
12
13
  ---
13
14
 
14
15
  # 契约测试助手
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/database-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-03-23
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 引导数据库设计、迁移规划和查询优化。
9
- 使用时机:schema 设计、迁移规划、查询优化、索引策略。
10
- 关键字:database, schema, migration, SQL, index, query, 数据库, 迁移, 查询。
8
+ 引导数据库设计、迁移与查询优化。
9
+ Use when: schema 设计、迁移规划、查询优化、索引策略。
10
+ Not for: 应用程序代码迁移或框架升级——请用 /migrate;数据之上的 API 契约——请用 /api-design。
11
+ Keywords: database, schema, migration, SQL, index, query, 数据库, 迁移, 查询, 索引策略.
11
12
  ---
12
13
 
13
14
  # 数据库助手
@@ -2,15 +2,16 @@
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-07-09
7
- source_hash: fc0996a2853c
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
+ source_hash: d84c8caee08d
8
8
  status: current
9
9
  scope: universal
10
10
  description: |
11
- [UDS] 无 CI/CD 平台环境下的可靠部署指引(不依赖 GitHub Actions / GitLab CI)。
12
- Use when: deploying to VPS, air-gapped servers, or environments without CI/CD infrastructure.
13
- Keywords: deployment, no-cicd, shell script, blue-green, smoke test, rollback, 无CI/CD, 部署.
11
+ 引导在没有 CI/CD 平台(GitHub Actions/GitLab CI)的情况下完成可靠部署。
12
+ Use when: 部署到 VPS、离线隔离的服务器,或任何没有 CI/CD 基础设施的环境。
13
+ Not for: 建立在 GitHub Actions 或 GitLab CI 上的流水线——请用 /ci-cd;版本号递增与发布晋级——请用 /release。
14
+ Keywords: deployment, no-cicd, shell script, blue-green, smoke test, rollback, 无 CI/CD, 部署, 蓝绿部署, 回滚.
14
15
  allowed-tools: Read, Bash(cat VERSION:*), Bash(git describe:*), Bash(which nginx:*), Bash(which rsync:*)
15
16
  argument-hint: "[项目类型: node/python/docker/go]"
16
17
  ---
@@ -2,15 +2,16 @@
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-07-09
7
- source_hash: e7e6aae82545
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
+ source_hash: bc54ca1f49d5
8
8
  status: current
9
9
  scope: partial
10
10
  description: |
11
- [UDS] /methodology: 选择并追踪开发方法论(SDD/BDD/TDD)。
12
- Use when: 选择方法论、切换开发模式、查询当前方法论状态。
13
- 若要查询各阶段对应命令请用 /dev-workflow。
11
+ [UDS] 为项目选择并追踪当前采用的开发方法论(SDD、BDD、TDD)。
12
+ Use when: 决定项目该遵循哪一套方法论、切换方法论、查询目前方法论处于哪个阶段。
13
+ Not for: 查询某个开发阶段该执行哪个命令——请用 /dev-workflow;执行方法论本身——请用 /sdd、/bdd 或 /tdd。
14
+ Keywords: methodology, SDD, BDD, TDD, phase tracking, methodology selection, 方法论, 开发方法选择, 阶段追踪.
14
15
  allowed-tools: Read, Write, Grep, Glob
15
16
  argument-hint: "[动作] [参数]"
16
17
  ---
@@ -1,14 +1,15 @@
1
1
  ---
2
2
  source: ../../../../skills/dev-workflow-guide/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-07-09
6
- source_hash: bb3068d840d8
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
+ source_hash: f90f1fe1f6f2
7
7
  status: current
8
8
  description: |
9
- 将软件开发阶段对应到 UDS 命令与技能。
10
- 使用时机:查找适用的 UDS 命令、规划开发流程、新手入门。
11
- 关键字:workflow, development-phases, commands, 工作流程, 开发阶段。
9
+ [UDS] 把目前的软件开发阶段对应到正确的 UDS 命令与 Skill。
10
+ Use when: 不确定手上的任务该用哪个 UDS 命令、初次上手 UDS、带着一个功能从规划走到发布。
11
+ Not for: 选择或切换方法论——请用 /methodology;实际执行某阶段的工作——请用该阶段自己的 Skill。
12
+ Keywords: workflow, development phase, command routing, which command, UDS guide, 开发阶段, 命令对照, 流程指南.
12
13
  ---
13
14
 
14
15
  # 开发工作流程指南
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/docs-generator/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-02-10
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 从项目源文件生成使用文档(速查表、参考手册、使用指南)。
9
- 使用时机:生成文档、建立速查表、生成参考手册。
10
- 关键字:docgen, documentation, cheatsheet, reference, 文档生成, 速查表, 参考手册。
8
+ [UDS] 从项目源文件生成使用文档(速查表、参考手册、使用指南)。
9
+ Use when: 从 CLI 与 Skill 定义产出速查表或功能参考手册、命令变更后重新生成文档、确认生成的文档是否为最新。
10
+ Not for: 决定项目需要哪些文档或手写叙述性内容——请用 /documentation-guide;变更日志条目——请用 /changelog。
11
+ Keywords: docgen, usage docs, cheatsheet, feature reference, generated documentation, 使用文档, 速查表, 文档生成, 参考手册.
11
12
  ---
12
13
 
13
14
  # 文档生成器
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/documentation-guide/SKILL.md
3
3
  source_version: 2.1.0
4
- translation_version: 2.1.0
5
- last_synced: 2026-03-17
4
+ translation_version: 2.2.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 引導文件结构、内容需求和项目文件最佳实踐。
9
- 使用时机:建立 README、文件、docs 目录、项目设置、技術文件。
10
- 关鍵字:README, docs, documentation, CONTRIBUTING, CHANGELOG, ARCHITECTURE, API docs, 文件, 说明文件, 技術文件.
8
+ 引导文档结构、内容需求与项目文档的最佳实践。
9
+ Use when: 创建 README、撰写文档、规划 docs 目录、项目初始设置、技术文档。
10
+ Not for: 从源代码机械式生成文档——请用 /docgen;变更日志条目——请用 /changelog。
11
+ Keywords: README, docs, documentation, CONTRIBUTING, CHANGELOG, ARCHITECTURE, API docs, 文档, 说明文档, 技术文档.
11
12
  ---
12
13
 
13
14
  # 文件指南
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/durable-execution-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-03-24
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 引导工作流程故障恢复,包含检查点、重试与回滚策略。
9
- 使用时机:工作流中途失败、需要重试逻辑、设计容错流程。
10
- 关键字:durable, execution, checkpoint, retry, rollback, recovery, 持久执行, 恢复。
8
+ [UDS] 引导容错工作流设计,包含检查点、重试策略与回滚计划。
9
+ Use when: 长时间运行的工作流总是中途失败、设计检查点的粒度、选择重试或退避策略。
10
+ Not for: 处理正在发生中的线上事故——请用 /incident;部署回滚的实现机制——请用 /deploy。
11
+ Keywords: durable execution, checkpoint, retry, backoff, idempotency, rollback, 持久执行, 检查点, 重试策略, 幂等.
11
12
  ---
12
13
 
13
14
  # 持久执行助手
@@ -1,10 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/e2e-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-04-10
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
- description: "[UDS] 从 BDD 场景生成 E2E 测试骨架,支持框架检测与覆盖差距分析"
7
+ description: |
8
+ [UDS] 从 BDD 的 .feature 场景生成 E2E 测试骨架,并支持框架检测与覆盖缺口分析。
9
+ Use when: 把已完成的 .feature 场景转成可运行的 E2E 骨架、检测项目使用的 E2E 框架、找出没有 E2E 覆盖的 AC。
10
+ Not for: 跨多个故事且带有共享状态的旅程——请用 journey-test Skill;编写 .feature 场景本身——请用 /bdd。
11
+ Keywords: E2E, end-to-end test, feature file, test skeleton, framework detection, 端对端测试, 测试骨架, 场景转测试, 覆盖缺口.
8
12
  ---
9
13
 
10
14
  # E2E 助手
@@ -2,12 +2,13 @@
2
2
  name: errors
3
3
  description: |
4
4
  设计一致的错误码,遵循 PREFIX_CATEGORY_NUMBER 格式。
5
- 使用时机:定義错误码、建立错误处理、设计 API。
6
- 关鍵字:error code, error handling, error format, API errors, 错误码, 错误处理。
5
+ Use when: 定义错误码、建立错误处理机制、设计 API。
6
+ Not for: 日志格式与级别——请用 /logging-guide;处理已经到达生产环境的错误——请用 /incident。
7
+ Keywords: error code, error handling, error format, API errors, 错误码, 错误处理, 错误格式.
7
8
  source: ../../../../skills/error-code-guide/SKILL.md
8
9
  source_version: 1.0.0
9
- translation_version: 1.0.0
10
- last_synced: 2026-01-08
10
+ translation_version: 1.1.0
11
+ last_synced: 2026-08-17
11
12
  status: current
12
13
  ---
13
14
 
@@ -1,14 +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
8
  description: |
9
- 指導 Git 分支策略、分支命名与合併操作。
10
- 使用时机:建立分支、合併、Pull Request、Git 工作流程問題。
11
- 关鍵字:branch, merge, PR, pull request, GitFlow, GitHub Flow, 分支, 合併, 工作流程。
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, 分支, 合并, 工作流程, 分支命名.
12
13
  ---
13
14
 
14
15
  # Git 工作流程指南
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/incident-response-assistant/SKILL.md
3
3
  source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-03-26
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 引导事故回应、根因分析和事后复盘文档撰写。
9
- 使用时机:生产事故、故障响应、事后复盘撰写、根因分析。
10
- 关键字:incident, outage, post-mortem, RCA, root cause, 事故, 故障, 根因分析。
8
+ 引导事故响应、根因分析与事后复盘文档撰写。
9
+ Use when: 生产环境事故、服务中断响应、撰写事后复盘、根因分析(RCA)。
10
+ Not for: 在故障发生前设计重试与检查点——请用 /durable;设置告警阈值与 Error Budget 策略——请用 /slo。
11
+ Keywords: incident, outage, post-mortem, RCA, root cause, 事故, 服务中断, 事后复盘, 根因分析.
11
12
  ---
12
13
 
13
14
  # 事故回应助手
@@ -2,13 +2,16 @@
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-07-09
7
- source_hash: 9230eb251afd
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
+ source_hash: 62c9c1574b9f
8
8
  status: current
9
9
  scope: partial
10
10
  description: |
11
- [UDS] 从项目描述生成连贯的用户旅程测试计划(TESTPLAN)与 E2E 骨架。
11
+ [UDS] 从项目描述生成连贯的用户旅程测试计划(TESTPLAN)与旅程 E2E 骨架。
12
+ Use when: 新项目从第一天就需要一条测试旅程、测试跨多个故事延续的状态、建立以用户画像驱动的旅程计划。
13
+ Not for: 单一 AC 的独立 E2E 骨架——请用 /e2e;测量实际达成的代码覆盖率——请用 /coverage。
14
+ Keywords: user journey, TESTPLAN, journey test, persona, cross-story state, 用户旅程, 旅程测试, 测试计划, 用户画像.
12
15
  allowed-tools: Read, Write, Grep, Glob
13
16
  argument-hint: "[项目描述 | --analyze | --archetype A1|A2|A3]"
14
17
  ---
@@ -2,12 +2,15 @@
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-07-09
7
- source_hash: 2a10faf2dd4c
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
+ source_hash: 3059eb465844
8
8
  status: current
9
9
  description: |
10
- [UDS] 通过知识图追踪规格/决策/代码的影响链(引擎或 Markdown 后备)
10
+ [UDS] 通过知识图谱追踪规格、决策与代码之间的影响链;没有引擎时以 Markdown 后备方案运作。
11
+ Use when: 想知道某份规格或决策会影响到什么、找出哪些代码实现了某个产物、追踪规格、ADR 与模块之间的依赖关系。
12
+ Not for: 没有规格或决策锚点的纯文本搜索——请用 Grep;撰写规格本身——请用 /sdd。
13
+ Keywords: knowledge graph, impact chain, traceability, spec impact, decision graph, 知识图谱, 影响链, 规格追踪, 依赖关系.
11
14
  ---
12
15
 
13
16
  # 知识图
@@ -1,14 +1,15 @@
1
1
  ---
2
2
  name: logging
3
3
  description: |
4
- 实现结构化日志,包含正确的日志级别和敏感数据处理。
5
- 使用时机:新增日志、调试、设置可观测性。
6
- 关键字:logging, log level, structured logging, observability, 日志, 记录, 结构化日志。
4
+ 实现结构化日志,包含适当的日志级别与敏感数据处理。
5
+ Use when: 加入日志、调试、建立可观测性。
6
+ Not for: 指标、追踪与告警设计——请用 /observability;错误码分类体系——请用 /error-code-guide。
7
+ Keywords: logging, log level, structured logging, observability, 日志, 结构化日志, 日志级别, 敏感数据.
7
8
  source: ../../../../skills/logging-guide/SKILL.md
8
9
  source_version: 1.4.0
9
- translation_version: 1.4.0
10
- last_synced: 2026-07-08
11
- source_hash: cf114de1df86
10
+ translation_version: 1.5.0
11
+ last_synced: 2026-08-17
12
+ source_hash: ca969fdf7847
12
13
  status: current
13
14
  ---
14
15
 
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/metrics-dashboard-assistant/SKILL.md
3
3
  source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-03-26
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 追踪开发指标、代码品质指示器与专案健康状态。
9
- 使用时机:评估专案健康、追踪技术债、监控品质趋势。
10
- 关键字:metrics, dashboard, quality, coverage, complexity, debt, 指标, 品质, 技术债。
8
+ [UDS] 长期追踪开发指标、代码质量指标与技术债。
9
+ Use when: 评估项目的持续健康状态、分类技术债并观察其趋势、向团队汇报代码质量。
10
+ Not for: 初次评估一个不熟悉的代码库——请用 /discover;单看测试覆盖率——请用 /coverage 或 /ac-coverage。
11
+ Keywords: metrics, code quality, technical debt, project health, debt trend, 开发指标, 技术债, 项目健康度, 质量趋势.
11
12
  ---
12
13
 
13
14
  # 开发指标助手
@@ -1,14 +1,15 @@
1
1
  ---
2
2
  source: ../../../../skills/migration-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- source_hash: 5d58f55f3f68
5
- translation_version: 1.0.0
6
- last_synced: 2026-07-09
4
+ source_hash: 317e388b2b82
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
8
  description: |
9
- 引导代码迁移、框架升级与技术现代化。
10
- 使用时机:框架升级、语言迁移、API 版本更新、依赖现代化。
11
- 关键字:migration, upgrade, modernize, framework, dependency, 迁移, 升级, 现代化。
9
+ [UDS] 引导系统性的代码迁移、框架升级与技术现代化。
10
+ Use when: 规划框架或主版本升级、评估迁移风险、在 API 迁移前先抓取契约测试的固定样本。
11
+ Not for: 维持同一套框架的原地改善——请用 /refactor;数据库 schema 设计——请用 /database。
12
+ Keywords: migration, framework upgrade, modernization, breaking change, dependency upgrade, 迁移, 升级, 技术现代化, 破坏性变更.
12
13
  ---
13
14
 
14
15
  # 迁移助手
@@ -1,10 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/observability-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-04-10
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
- description: "[UDS] 引导可观测性设置、指标设计和告警配置"
7
+ description: |
8
+ 引导可观测性建设、指标设计与告警配置。
9
+ Use when: 新服务的埋点、SLO 定义、告警设计、成熟度评估。
10
+ Not for: 设置数值目标与 Error Budget 策略——请用 /slo;日志格式与级别——请用 /logging-guide。
11
+ Keywords: observability, metrics, traces, golden signals, alerting, SLO, 可观测性, 指标, 追踪, 告警.
8
12
  ---
9
13
 
10
14
  # 可观测性助手
@@ -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-07-16
7
- source_hash: e66c388ce04a
5
+ translation_version: 2.1.0
6
+ last_synced: 2026-08-17
7
+ source_hash: 357586a2f4d0
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-07-16
7
- source_hash: 375b1ddb3613
5
+ translation_version: 2.1.0
6
+ last_synced: 2026-08-17
7
+ source_hash: 208202753de4
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
 
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/pr-automation-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-03-23
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 引导 Pull Request 创建、审查自动化和合并策略。
9
- 使用时机:创建 PR、自动化审查、配置合并策略。
10
- 关键字:pull request, PR, merge, review, GitHub, GitLab, 合并请求, 审查。
8
+ 引导 pull request 创建、审查自动化与合并策略。
9
+ Use when: 创建 PR、自动化审查流程、配置合并策略。
10
+ Not for: 审查本身的内容实质——请用 /code-review;分支命名与合并策略——请用 /git-workflow-guide。
11
+ Keywords: pull request, PR, merge, review, GitHub, GitLab, 合并请求, 审查自动化, 合并策略.
11
12
  ---
12
13
 
13
14
  # PR 自动化助手
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/project-discovery/SKILL.md
3
3
  source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-03-26
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 在既有代码库新增功能前的 Phase 0 评估,评估项目健康度、架构与风险。
9
- 使用时机:新增功能前、项目健康度检查、风险评估。
10
- 关键字:discover, assessment, health, risk, 评估, 健康度, 风险, 架构。
8
+ [UDS] 在既有代码库新增功能之前,评估项目健康度、架构与风险。
9
+ Use when: 接手不熟悉或老旧的项目、动工前先估算风险、建立风险登记簿。
10
+ Not for: 对已经熟悉的代码库做持续指标追踪——请用 /metrics;从代码回推规格——请用 /reverse。
11
+ Keywords: discovery, project assessment, legacy onboarding, risk register, technical debt, 现状评估, 项目盘点, 风险登记簿, 老旧系统.
11
12
  ---
12
13
 
13
14
  # 项目现况评估
@@ -1,9 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/project-structure-guide/SKILL.md
3
3
  source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-03-04
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
+ description: |
8
+ 依各语言的最佳实践组织项目目录结构的指南。
9
+ Use when: 创建项目、重整结构、新增模块、配置构建流程、决定文件该放哪里。
10
+ Not for: 专门为 AI 导览而设计的结构——请用 /ai-friendly-architecture;原地重整既有代码——请用 /refactor。
11
+ Keywords: project, structure, directory, layout, gitignore, scaffold, file placement, utils, helpers, shared, 项目结构, 目录布局, 文件摆放.
7
12
  ---
8
13
 
9
14
  # 项目结构指南
@@ -2,14 +2,15 @@
2
2
  name: push
3
3
  source: ../../../../skills/push/SKILL.md
4
4
  source_version: 2.0.0
5
- translation_version: 2.0.0
6
- last_synced: 2026-07-16
7
- source_hash: cb3cc9fb2313
5
+ translation_version: 2.1.0
6
+ last_synced: 2026-08-17
7
+ source_hash: 3242aa64fe0d
8
8
  scope: universal
9
9
  description: |
10
- [UDS] AI 辅助 git push 安全层:质量门禁 + 协作护栏。
11
- Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches.
12
- Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁.
10
+ AI 辅助的 git push 安全层,提供质量关卡与协作护栏。
11
+ Use when: 推送 commit、强制推送、推送到受保护分支、推送 feature 分支。
12
+ Not for: 撰写 commit 内容——请用 /commit;分支与合并策略的决策——请用 /git-workflow-guide。
13
+ Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁, 强制推送.
13
14
  allowed-tools: Read, Bash(git:*), Bash(npm:*), Bash(pnpm:*), Bash(yarn:*), Bash(bun:*)
14
15
  argument-hint: "[--force] [--target <branch>] [--skip-gates] [--no-pr]"
15
16
  ---
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/refactoring-assistant/SKILL.md
3
3
  source_version: 2.0.0
4
- translation_version: 2.0.0
5
- last_synced: 2026-02-10
4
+ translation_version: 2.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 引导重构决策、推荐策略,并提供逐步执行工作流程。
9
- 使用时机:重构代码、评估重构 vs 重写、处理遗留代码。
10
- 关键字:refactor, strategy, legacy, technical debt, 重构, 策略, 遗留代码, 技术债。
8
+ [UDS] 引导重构决策与策略选择,包含「重构还是重写」这个判断。
9
+ Use when: 代码已经难以修改、在战术性与架构性重构之间做选择、要在老旧代码里安全地动手。
10
+ Not for: 换到不同框架或主版本——请用 /migrate;清除调试残留与死代码——请用 /sweep。
11
+ Keywords: refactor, rewrite, strangler, legacy code, technical debt, code smell, 重构, 重写, 技术债, 坏味道.
11
12
  ---
12
13
 
13
14
  # 重构助手