@pigcloud/skills 1.0.11 → 1.1.2

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 (298) hide show
  1. package/CHANGELOG.md +25 -20
  2. package/README.en.md +41 -75
  3. package/README.md +26 -39
  4. package/bin/cli.js +260 -151
  5. package/bin/rules-loader.js +271 -484
  6. package/codex-commands/README.md +25 -23
  7. package/codex-commands/commands/analyze.md +21 -22
  8. package/codex-commands/commands/build.md +22 -22
  9. package/codex-commands/commands/design.md +21 -22
  10. package/codex-commands/commands/distill.md +21 -21
  11. package/codex-commands/commands/doc.md +21 -22
  12. package/codex-commands/commands/infra.md +21 -21
  13. package/codex-commands/commands/init.md +20 -20
  14. package/codex-commands/commands/kb.md +21 -20
  15. package/codex-commands/commands/perf.md +21 -21
  16. package/codex-commands/commands/prd.md +21 -22
  17. package/codex-commands/commands/review.md +21 -22
  18. package/codex-commands/commands/security.md +21 -22
  19. package/codex-commands/commands/test.md +21 -21
  20. package/codex-commands/commands/workflow.md +21 -20
  21. package/package.json +5 -2
  22. package/rules/core/index.md +26 -41
  23. package/rules/delivery/index.md +25 -0
  24. package/rules/design/index.md +25 -0
  25. package/rules/discovery/index.md +25 -0
  26. package/rules/implementation/index.md +25 -0
  27. package/rules/index.md +24 -39
  28. package/rules/overlays/index.md +19 -19
  29. package/rules/overlays/pig-cloud.md +20 -45
  30. package/rules/shared/index.md +25 -0
  31. package/rules/skill-stage-map.json +26 -0
  32. package/rules/stages.json +48 -0
  33. package/rules/validation/index.md +25 -0
  34. package/scripts/add-skill-reference-nav.js +3 -0
  35. package/scripts/bootstrap-skill-specs.js +96 -0
  36. package/scripts/ci-validator.sh +51 -114
  37. package/scripts/generate-skill-prompt-library.js +3 -0
  38. package/scripts/golden-prompt-suite.current.js +211 -0
  39. package/scripts/migrate-skill-packages.js +309 -0
  40. package/scripts/run-golden-replays.js +110 -79
  41. package/scripts/validate-rules.js +128 -125
  42. package/scripts/validate-skill-replay-signals.js +45 -57
  43. package/scripts/validate-skill-shapes.js +153 -127
  44. package/scripts/validate-skill-stop-rules.js +54 -46
  45. package/skills/01-discovery/ambiguity-detection/SKILL.md +30 -0
  46. package/skills/01-discovery/ambiguity-detection/assets/golden-prompt-suite.current.js +22 -0
  47. package/skills/01-discovery/ambiguity-detection/references/README.md +17 -0
  48. package/skills/01-discovery/ambiguity-detection/references/cases.md +26 -0
  49. package/skills/01-discovery/ambiguity-detection/references/prompt-template.md +18 -0
  50. package/skills/01-discovery/ambiguity-detection/skill-spec.json +26 -0
  51. package/skills/01-discovery/business-analysis/SKILL.md +30 -0
  52. package/skills/01-discovery/business-analysis/assets/golden-prompt-suite.current.js +22 -0
  53. package/skills/01-discovery/business-analysis/references/README.md +17 -0
  54. package/skills/01-discovery/business-analysis/references/cases.md +26 -0
  55. package/skills/01-discovery/business-analysis/references/prompt-template.md +18 -0
  56. package/skills/01-discovery/business-analysis/skill-spec.json +26 -0
  57. package/skills/01-discovery/impact-analysis/SKILL.md +30 -0
  58. package/skills/01-discovery/impact-analysis/assets/golden-prompt-suite.current.js +22 -0
  59. package/skills/01-discovery/impact-analysis/references/README.md +17 -0
  60. package/skills/01-discovery/impact-analysis/references/cases.md +26 -0
  61. package/skills/01-discovery/impact-analysis/references/prompt-template.md +18 -0
  62. package/skills/01-discovery/impact-analysis/skill-spec.json +26 -0
  63. package/skills/01-discovery/requirement-discovery/SKILL.md +30 -0
  64. package/skills/01-discovery/requirement-discovery/assets/golden-prompt-suite.current.js +24 -0
  65. package/skills/01-discovery/requirement-discovery/references/README.md +17 -0
  66. package/skills/01-discovery/requirement-discovery/references/cases.md +28 -0
  67. package/skills/01-discovery/requirement-discovery/references/prompt-template.md +18 -0
  68. package/skills/01-discovery/requirement-discovery/skill-spec.json +26 -0
  69. package/skills/02-design/api-design/SKILL.md +29 -0
  70. package/skills/02-design/api-design/assets/golden-prompt-suite.current.js +22 -0
  71. package/skills/02-design/api-design/references/README.md +17 -0
  72. package/skills/02-design/api-design/references/cases.md +26 -0
  73. package/skills/02-design/api-design/references/prompt-template.md +18 -0
  74. package/skills/02-design/api-design/skill-spec.json +25 -0
  75. package/skills/02-design/architecture-design/SKILL.md +29 -0
  76. package/skills/02-design/architecture-design/assets/golden-prompt-suite.current.js +22 -0
  77. package/skills/02-design/architecture-design/references/README.md +17 -0
  78. package/skills/02-design/architecture-design/references/cases.md +26 -0
  79. package/skills/02-design/architecture-design/references/prompt-template.md +18 -0
  80. package/skills/02-design/architecture-design/skill-spec.json +25 -0
  81. package/skills/02-design/database-design/SKILL.md +29 -0
  82. package/skills/02-design/database-design/assets/golden-prompt-suite.current.js +22 -0
  83. package/skills/02-design/database-design/references/README.md +17 -0
  84. package/skills/02-design/database-design/references/cases.md +26 -0
  85. package/skills/02-design/database-design/references/prompt-template.md +18 -0
  86. package/skills/02-design/database-design/skill-spec.json +25 -0
  87. package/skills/02-design/task-breakdown/SKILL.md +29 -0
  88. package/skills/02-design/task-breakdown/assets/golden-prompt-suite.current.js +22 -0
  89. package/skills/02-design/task-breakdown/references/README.md +17 -0
  90. package/skills/02-design/task-breakdown/references/cases.md +26 -0
  91. package/skills/02-design/task-breakdown/references/prompt-template.md +18 -0
  92. package/skills/02-design/task-breakdown/skill-spec.json +25 -0
  93. package/skills/03-implementation/backend-development/SKILL.md +29 -0
  94. package/skills/03-implementation/backend-development/assets/golden-prompt-suite.current.js +22 -0
  95. package/skills/03-implementation/backend-development/references/README.md +17 -0
  96. package/skills/03-implementation/backend-development/references/cases.md +26 -0
  97. package/skills/03-implementation/backend-development/references/prompt-template.md +18 -0
  98. package/skills/03-implementation/backend-development/skill-spec.json +25 -0
  99. package/skills/03-implementation/bug-fix/SKILL.md +29 -0
  100. package/skills/03-implementation/bug-fix/assets/golden-prompt-suite.current.js +22 -0
  101. package/skills/03-implementation/bug-fix/references/README.md +17 -0
  102. package/skills/03-implementation/bug-fix/references/cases.md +26 -0
  103. package/skills/03-implementation/bug-fix/references/prompt-template.md +18 -0
  104. package/skills/03-implementation/bug-fix/skill-spec.json +25 -0
  105. package/skills/03-implementation/database-change/SKILL.md +29 -0
  106. package/skills/03-implementation/database-change/assets/golden-prompt-suite.current.js +22 -0
  107. package/skills/03-implementation/database-change/references/README.md +17 -0
  108. package/skills/03-implementation/database-change/references/cases.md +26 -0
  109. package/skills/03-implementation/database-change/references/prompt-template.md +18 -0
  110. package/skills/03-implementation/database-change/skill-spec.json +25 -0
  111. package/skills/03-implementation/frontend-development/SKILL.md +29 -0
  112. package/skills/03-implementation/frontend-development/assets/golden-prompt-suite.current.js +22 -0
  113. package/skills/03-implementation/frontend-development/references/README.md +17 -0
  114. package/skills/03-implementation/frontend-development/references/cases.md +26 -0
  115. package/skills/03-implementation/frontend-development/references/prompt-template.md +18 -0
  116. package/skills/03-implementation/frontend-development/skill-spec.json +25 -0
  117. package/skills/04-validation/code-review/SKILL.md +29 -0
  118. package/skills/04-validation/code-review/assets/golden-prompt-suite.current.js +22 -0
  119. package/skills/04-validation/code-review/references/README.md +17 -0
  120. package/skills/04-validation/code-review/references/cases.md +26 -0
  121. package/skills/04-validation/code-review/references/prompt-template.md +18 -0
  122. package/skills/04-validation/code-review/skill-spec.json +25 -0
  123. package/skills/04-validation/performance-review/SKILL.md +29 -0
  124. package/skills/04-validation/performance-review/assets/golden-prompt-suite.current.js +22 -0
  125. package/skills/04-validation/performance-review/references/README.md +17 -0
  126. package/skills/04-validation/performance-review/references/cases.md +26 -0
  127. package/skills/04-validation/performance-review/references/prompt-template.md +18 -0
  128. package/skills/04-validation/performance-review/skill-spec.json +25 -0
  129. package/skills/04-validation/regression-check/SKILL.md +29 -0
  130. package/skills/04-validation/regression-check/assets/golden-prompt-suite.current.js +22 -0
  131. package/skills/04-validation/regression-check/references/README.md +17 -0
  132. package/skills/04-validation/regression-check/references/cases.md +26 -0
  133. package/skills/04-validation/regression-check/references/prompt-template.md +18 -0
  134. package/skills/04-validation/regression-check/skill-spec.json +25 -0
  135. package/skills/04-validation/security-review/SKILL.md +29 -0
  136. package/skills/04-validation/security-review/assets/golden-prompt-suite.current.js +22 -0
  137. package/skills/04-validation/security-review/references/README.md +17 -0
  138. package/skills/04-validation/security-review/references/cases.md +26 -0
  139. package/skills/04-validation/security-review/references/prompt-template.md +18 -0
  140. package/skills/04-validation/security-review/skill-spec.json +25 -0
  141. package/skills/04-validation/unit-test/SKILL.md +29 -0
  142. package/skills/04-validation/unit-test/assets/golden-prompt-suite.current.js +22 -0
  143. package/skills/04-validation/unit-test/references/README.md +17 -0
  144. package/skills/04-validation/unit-test/references/cases.md +26 -0
  145. package/skills/04-validation/unit-test/references/prompt-template.md +18 -0
  146. package/skills/04-validation/unit-test/skill-spec.json +25 -0
  147. package/skills/05-delivery/change-log/SKILL.md +29 -0
  148. package/skills/05-delivery/change-log/assets/golden-prompt-suite.current.js +22 -0
  149. package/skills/05-delivery/change-log/references/README.md +17 -0
  150. package/skills/05-delivery/change-log/references/cases.md +26 -0
  151. package/skills/05-delivery/change-log/references/prompt-template.md +18 -0
  152. package/skills/05-delivery/change-log/skill-spec.json +25 -0
  153. package/skills/05-delivery/deployment-guide/SKILL.md +29 -0
  154. package/skills/05-delivery/deployment-guide/assets/golden-prompt-suite.current.js +22 -0
  155. package/skills/05-delivery/deployment-guide/references/README.md +17 -0
  156. package/skills/05-delivery/deployment-guide/references/cases.md +26 -0
  157. package/skills/05-delivery/deployment-guide/references/prompt-template.md +18 -0
  158. package/skills/05-delivery/deployment-guide/skill-spec.json +25 -0
  159. package/skills/05-delivery/release-check/SKILL.md +29 -0
  160. package/skills/05-delivery/release-check/assets/golden-prompt-suite.current.js +22 -0
  161. package/skills/05-delivery/release-check/references/README.md +17 -0
  162. package/skills/05-delivery/release-check/references/cases.md +26 -0
  163. package/skills/05-delivery/release-check/references/prompt-template.md +18 -0
  164. package/skills/05-delivery/release-check/skill-spec.json +25 -0
  165. package/skills/05-delivery/release-validation/SKILL.md +29 -0
  166. package/skills/05-delivery/release-validation/assets/golden-prompt-suite.current.js +22 -0
  167. package/skills/05-delivery/release-validation/references/README.md +17 -0
  168. package/skills/05-delivery/release-validation/references/cases.md +26 -0
  169. package/skills/05-delivery/release-validation/references/prompt-template.md +18 -0
  170. package/skills/05-delivery/release-validation/skill-spec.json +25 -0
  171. package/skills/shared/codebase-learning/SKILL.md +29 -0
  172. package/skills/shared/codebase-learning/assets/golden-prompt-suite.current.js +22 -0
  173. package/skills/shared/codebase-learning/references/README.md +17 -0
  174. package/skills/shared/codebase-learning/references/cases.md +26 -0
  175. package/skills/shared/codebase-learning/references/prompt-template.md +18 -0
  176. package/skills/shared/codebase-learning/skill-spec.json +25 -0
  177. package/skills/shared/evidence-collector/SKILL.md +29 -0
  178. package/skills/shared/evidence-collector/assets/golden-prompt-suite.current.js +22 -0
  179. package/skills/shared/evidence-collector/references/README.md +17 -0
  180. package/skills/shared/evidence-collector/references/cases.md +26 -0
  181. package/skills/shared/evidence-collector/references/prompt-template.md +18 -0
  182. package/skills/shared/evidence-collector/skill-spec.json +25 -0
  183. package/skills/shared/framework-guide/SKILL.md +28 -0
  184. package/skills/shared/framework-guide/assets/golden-prompt-suite.current.js +22 -0
  185. package/skills/shared/framework-guide/references/README.md +17 -0
  186. package/skills/shared/framework-guide/references/cases.md +26 -0
  187. package/skills/shared/framework-guide/references/prompt-template.md +18 -0
  188. package/skills/shared/framework-guide/skill-spec.json +24 -0
  189. package/rules/bundles.json +0 -358
  190. package/rules/coding/analysis.md +0 -27
  191. package/rules/coding/backend/cache-invalidation.md +0 -30
  192. package/rules/coding/backend/cache-keying.md +0 -30
  193. package/rules/coding/backend/cache.md +0 -37
  194. package/rules/coding/backend/database.md +0 -32
  195. package/rules/coding/backend/feign.md +0 -30
  196. package/rules/coding/backend/index.md +0 -42
  197. package/rules/coding/backend/query.md +0 -32
  198. package/rules/coding/backend/remote.md +0 -33
  199. package/rules/coding/backend/transaction-boundary.md +0 -30
  200. package/rules/coding/backend/transaction-rollback.md +0 -30
  201. package/rules/coding/backend/transaction.md +0 -38
  202. package/rules/coding/boundary.md +0 -25
  203. package/rules/coding/implementation.md +0 -26
  204. package/rules/coding/index.md +0 -38
  205. package/rules/coding/scaffold.md +0 -28
  206. package/rules/coding/testing.md +0 -29
  207. package/rules/coding/validation.md +0 -29
  208. package/rules/core/code-quality.md +0 -30
  209. package/rules/core/evidence.md +0 -26
  210. package/rules/core/interface.md +0 -26
  211. package/rules/core/iteration.md +0 -26
  212. package/rules/core/layer-boundary.md +0 -25
  213. package/rules/core/logging.md +0 -26
  214. package/rules/core/security.md +0 -26
  215. package/rules/core/task-boundary.md +0 -27
  216. package/rules/docs/api.md +0 -34
  217. package/rules/docs/capture-summary.md +0 -29
  218. package/rules/docs/capture.md +0 -34
  219. package/rules/docs/contract.md +0 -30
  220. package/rules/docs/decision-log.md +0 -32
  221. package/rules/docs/examples.md +0 -28
  222. package/rules/docs/index.md +0 -49
  223. package/rules/docs/reference.md +0 -32
  224. package/rules/overlays/pig-cloud/controller.md +0 -33
  225. package/rules/overlays/pig-cloud/dto-vo.md +0 -33
  226. package/rules/overlays/pig-cloud/entity.md +0 -32
  227. package/rules/overlays/pig-cloud/exception.md +0 -32
  228. package/rules/overlays/pig-cloud/layering.md +0 -31
  229. package/rules/overlays/pig-cloud/mapper.md +0 -32
  230. package/rules/overlays/pig-cloud/query-style.md +0 -32
  231. package/rules/overlays/pig-cloud/rest-response.md +0 -33
  232. package/rules/overlays/pig-cloud/service.md +0 -33
  233. package/rules/overlays/pig-cloud/transactions.md +0 -32
  234. package/rules/overlays/pig-cloud/validation.md +0 -33
  235. package/rules/product/acceptance.md +0 -25
  236. package/rules/product/briefing.md +0 -27
  237. package/rules/product/index.md +0 -36
  238. package/rules/product/intake.md +0 -27
  239. package/rules/product/modeling.md +0 -25
  240. package/rules/product/project-context.md +0 -29
  241. package/rules/review/code.md +0 -35
  242. package/rules/review/evidence.md +0 -31
  243. package/rules/review/index.md +0 -50
  244. package/rules/review/java.md +0 -42
  245. package/rules/review/performance.md +0 -38
  246. package/rules/review/rubric.md +0 -28
  247. package/rules/review/security.md +0 -38
  248. package/rules/review/ts.md +0 -33
  249. package/rules/review/vue.md +0 -33
  250. package/rules/skill-profile-map.json +0 -59
  251. package/rules/skill-profile-map.md +0 -29
  252. package/rules/workflow/handoff.md +0 -25
  253. package/rules/workflow/index.md +0 -37
  254. package/rules/workflow/refinement.md +0 -29
  255. package/rules/workflow/router.md +0 -25
  256. package/rules/workflow/selection.md +0 -25
  257. package/rules/workflow/stop.md +0 -25
  258. package/skills/api-contract-docs/SKILL.md +0 -77
  259. package/skills/business-fact-extraction/SKILL.md +0 -337
  260. package/skills/business-fact-extraction/scripts/write-knowledge-base.js +0 -228
  261. package/skills/code-review/SKILL.md +0 -136
  262. package/skills/code-review/references/findings-template.md +0 -51
  263. package/skills/code-review/references/performance-checklist.md +0 -213
  264. package/skills/code-review/references/rubric.md +0 -232
  265. package/skills/code-review/references/rules.md +0 -32
  266. package/skills/code-review/references/security-checklist.md +0 -178
  267. package/skills/code-review/references/stack-notes.md +0 -25
  268. package/skills/code-review/references/template-review.md +0 -39
  269. package/skills/code-review/scripts/lint-code-review.mjs +0 -431
  270. package/skills/domain-modeling/SKILL.md +0 -81
  271. package/skills/domain-modeling/references/README.md +0 -134
  272. package/skills/domain-modeling/references/distillation-checklist.md +0 -44
  273. package/skills/domain-modeling/references/test-cases-template.md +0 -128
  274. package/skills/environment-deploy/SKILL.md +0 -81
  275. package/skills/feature-build/SKILL.md +0 -122
  276. package/skills/feature-build/references/coding-checklist.md +0 -97
  277. package/skills/feature-build/references/comment-specification.md +0 -89
  278. package/skills/knowledge-capture/SKILL.md +0 -93
  279. package/skills/performance-audit/SKILL.md +0 -118
  280. package/skills/project-bootstrap/SKILL.md +0 -81
  281. package/skills/references/anti-rationalization.md +0 -144
  282. package/skills/references/business-fact-extraction.md +0 -415
  283. package/skills/references/engineering-delivery-method.md +0 -64
  284. package/skills/references/engineering-delivery-template.md +0 -81
  285. package/skills/references/golden-prompt-suite.js +0 -436
  286. package/skills/references/golden-prompt-suite.md +0 -33
  287. package/skills/references/project-requirement-alignment.md +0 -42
  288. package/skills/references/rule-loading-map.md +0 -117
  289. package/skills/references/skill-authoring-standard.md +0 -74
  290. package/skills/references/skill-boundary-template.md +0 -71
  291. package/skills/references/skill-enhanced-template.md +0 -103
  292. package/skills/references/skill-reference-matrix.md +0 -62
  293. package/skills/security-audit/SKILL.md +0 -119
  294. package/skills/spec-refinement/SKILL.md +0 -149
  295. package/skills/technical-design/SKILL.md +0 -106
  296. package/skills/technical-design/references/solid-checklist.md +0 -199
  297. package/skills/test-design/SKILL.md +0 -92
  298. package/skills/workflow-router/SKILL.md +0 -86
@@ -1,23 +1,25 @@
1
- # Pig Skills Codex Commands
2
-
3
- 鏈彃浠舵彁渚?Pig Skills skill pack 鐨勫懡浠ゅ紡鍏ュ彛銆?
4
- 鍏堝畨瑁?skill pack锛屽啀閲嶅惎 Codex锛屽懡浠ゆ墠浼氱敓鏁堛€?
5
-
6
- ## Commands
7
-
8
- - `/spec-refinement` -> `spec-refinement`
9
- - `/design` -> `technical-design`
10
- - `/build` -> `feature-build`
11
- - `/review` -> `code-review`
12
- - `/security` -> `security-audit`
13
- - `/perf` -> `performance-audit`
14
- - `/test` -> `test-design`
15
- - `/doc` -> `api-contract-docs`
16
- - `/distill` -> `domain-modeling`
17
- - `/workflow` -> `workflow-router`
18
- - `/kb` -> `knowledge-capture`
19
- - `/init` -> `project-bootstrap`
20
- - `/infra` -> `environment-deploy`
21
-
22
- 杩欎簺鍛戒护椤典繚鎸佺煭灏忥紝鏄负浜嗚 Codex 鏇村揩瀹氫綅鍒版纭殑 skill銆?
23
-
1
+ # Pig Skills Codex Commands
2
+
3
+ 这个命令包把 Codex `/` 命令映射到当前仓库的 canonical skills,并尽量把每个命令停在正确的阶段。
4
+
5
+ ## Commands
6
+
7
+ - `/analyze` -> `requirement-discovery`
8
+ - `/prd` -> `business-analysis`
9
+ - `/design` -> `architecture-design`
10
+ - `/build` -> `backend-development` / `frontend-development` / `database-change` / `bug-fix`
11
+ - `/review` -> `code-review`
12
+ - `/security` -> `security-review`
13
+ - `/perf` -> `performance-review`
14
+ - `/test` -> `unit-test`
15
+ - `/doc` -> `api-design`
16
+ - `/distill` -> `business-analysis`
17
+ - `/workflow` -> `ambiguity-detection`
18
+ - `/kb` -> `evidence-collector`
19
+ - `/init` -> `codebase-learning`
20
+ - `/infra` -> `deployment-guide`
21
+
22
+ ## Notes
23
+
24
+ - 单个命令如果覆盖多个阶段,说明里会标出默认 skill 和可替换 skill。
25
+ - 命令包只负责路由,不把领域规则写成另一个规则库。
@@ -1,22 +1,21 @@
1
- # /analyze
2
-
3
- 鎶婂凡缁忕‘璁ょ殑闇€姹傛敹鏁涙垚鐮斿彂鍙墽琛岀殑瑙勬牸銆?
4
-
5
- ## Route
6
-
7
- - 瀵瑰簲 skill锛歚spec-refinement`
8
- - 閫傜敤锛氶渶姹傛媶瑙c€佽竟鐣屾⒊鐞嗐€佷緷璧栫‘璁ゃ€侀獙鏀舵爣鍑嗚ˉ鍏?
9
- - 涓嶉€傜敤锛氳繕娌℃敹鍙g殑浜у搧璁ㄨ
10
-
11
- ## Workflow
12
-
13
- 1. 鍏堢‘璁よ緭鍏ュ凡缁忔敹鏁涘埌鍙墽琛岃鏍笺€?
14
- 2. 鎶婄洰鏍囥€佽竟鐣屻€佷緷璧栥€佺害鏉熷拰楠屾敹鏉′欢鏁寸悊鎴愬彲鎵ц瑙勬牸銆?
15
- 3. 杈撳嚭鐮斿彂鍒嗘瀽缁撴灉锛屾槑纭悗缁疄鐜版墍闇€杈撳叆銆?
16
- 4. 蹇呰鏃朵氦缁?`technical-design` 鎴?`knowledge-capture`銆?
17
-
18
- ## Guardrails
19
-
20
- - 涓嶇洿鎺ュ啓瀹炵幇浠g爜銆?
21
- - 涓嶆妸鏈‘璁ゅ亣璁惧綋缁撹銆?
22
-
1
+ # /analyze
2
+
3
+ 把模糊输入收敛成清晰的需求问题,再决定下一步是设计、分析还是继续澄清。
4
+
5
+ ## Route
6
+
7
+ - 对应 skill: `requirement-discovery`
8
+ - 适用: 需求还不够清楚、信息不完整、边界不明确
9
+ - 不适用: 已经是明确实现任务,或者只是代码修改
10
+
11
+ ## Workflow
12
+
13
+ 1. 先讲清楚目标、背景、约束和成功标准。
14
+ 2. 标出已知信息、未知信息和必须确认的点。
15
+ 3. 只做必要澄清,不提前进入设计或编码。
16
+ 4. 如果输入已经足够稳定,再交给 `architecture-design` 或 `business-analysis`。
17
+
18
+ ## Guardrails
19
+
20
+ - 不要把模糊问题直接包装成实现计划。
21
+ - 不要跳过边界确认。
@@ -1,22 +1,22 @@
1
- # /build
2
-
3
- 鎸夋柟妗堣鑼冨疄鐜板凡缁忔敹鍙g殑闇€姹傘€?
4
-
5
- ## Route
6
-
7
- - 瀵瑰簲 skill锛歚feature-build`
8
- - 閫傜敤锛氬紑鍙戝疄鐜般€佸閲忔敼閫犮€佹帴鍙h仈鍔ㄣ€佽惤鍦颁唬鐮?
9
- - 涓嶉€傜敤锛氶渶姹傝繕娌℃敹鍙o紝鎴栬€呰璁¤繕娌$ǔ瀹?
10
-
11
- ## Workflow
12
-
13
- 1. 鍏堢‘璁よ緭鍏ユ潵鑷?`spec-refinement` 鎴?`technical-design`銆?
14
- 2. 鎸夊垎灞傘€佷簨鍔″拰杩斿洖鍊艰鑼冨疄鐜般€?
15
- 3. 淇濇寔鏀瑰姩鏈€灏忥紝浼樺厛鍙獙璇併€?
16
- 4. 浜ょ粰 `test-design` 鍜?`code-review` 鏀跺彛銆?
17
-
18
- ## Guardrails
19
-
20
- - 涓嶇粫杩囨灦鏋勭害鏉熴€?
21
- - 涓嶆妸涓存椂淇ˉ褰撲綔鏈€缁堝疄鐜般€?
22
-
1
+ # /build
2
+
3
+ 把已经确认的变更落成代码,默认面向后端,必要时切到前端、数据库或缺陷修复 skill。
4
+
5
+ ## Route
6
+
7
+ - 默认 skill: `backend-development`
8
+ - 可替换 skill: `frontend-development`、`database-change`、`bug-fix`
9
+ - 适用: 进入具体编码、补实现、修 bug
10
+ - 不适用: 需求还没确认,或者仍在做方案选择
11
+
12
+ ## Workflow
13
+
14
+ 1. 先确认输入来自 `requirement-discovery` 或 `architecture-design`。
15
+ 2. 选定单一实现面,避免把不同层的工作混在一起。
16
+ 3. 每次只推进一个可验证的小改动。
17
+ 4. 完成后交给 `unit-test` 和 `code-review`。
18
+
19
+ ## Guardrails
20
+
21
+ - 不要把设计争论留在实现阶段。
22
+ - 不要在没有验证的情况下继续堆改动。
@@ -1,22 +1,21 @@
1
- # /design
2
-
3
- 鎶婂凡缁忔敹鍙g殑闇€姹傝ˉ鎴愬彲瀹炵幇鐨勬妧鏈柟妗堛€?
4
-
5
- ## Route
6
-
7
- - 瀵瑰簲 skill锛歚technical-design`
8
- - 閫傜敤锛氭灦鏋勯€夊瀷銆佹ā鍧楁媶鍒嗐€佹帴鍙h璁°€佹暟鎹祦璁捐銆佸疄鐜板墠琛ュ厖璁捐
9
- - 涓嶉€傜敤锛氬皻鏈敹鍙g殑闇€姹傝璁?
10
-
11
- ## Workflow
12
-
13
- 1. 璇诲彇 `spec-refinement` 鐨勭粨璁恒€?
14
- 2. 鎷嗗垎妯″潡銆佹帴鍙c€佹暟鎹粨鏋勩€佷簨鍔¤竟鐣屽拰寮傚父璺緞銆?
15
- 3. 杈撳嚭鏂规鑽夊浘銆佸叧閿喅绛栧拰钀藉湴椤哄簭銆?
16
- 4. 缁?`feature-build` 鍑嗗瀹炵幇杈撳叆銆?
17
-
18
- ## Guardrails
19
-
20
- - 涓嶉噸鏂板彂鏁i渶姹傝寖鍥淬€?
21
- - 涓嶈烦杩囨灦鏋勭害鏉熺洿鎺ュ啓瀹炵幇銆?
22
-
1
+ # /design
2
+
3
+ 把已经确认的需求收敛成可执行设计,重点是边界、依赖和方案选择。
4
+
5
+ ## Route
6
+
7
+ - 对应 skill: `architecture-design`
8
+ - 适用: 需要定方案、定边界、定依赖关系
9
+ - 不适用: 需求还没确认,或者已经进入具体编码
10
+
11
+ ## Workflow
12
+
13
+ 1. 承接 `requirement-discovery` 的结论。
14
+ 2. 说明系统边界、依赖方向和关键 trade-off。
15
+ 3. 只输出能指导实现的设计,不写实现细节。
16
+ 4. 设计稳定后交给 `task-breakdown`。
17
+
18
+ ## Guardrails
19
+
20
+ - 不要把设计写成代码说明。
21
+ - 不要绕过关键决策直接进入实现。
@@ -1,21 +1,21 @@
1
- # /distill
2
-
3
- 把业务事实提炼成可复用的领域知识。
4
-
5
- ## Route
6
-
7
- - 对应 skill:`domain-modeling`
8
- - 适用:领域边界、实体关系、核心概念、规则沉淀
9
- - 不适用:纯接口变更说明
10
-
11
- ## Workflow
12
-
13
- 1. 识别业务对象、边界和核心规则。
14
- 2. 抽取实体、关系、状态和约束。
15
- 3. 输出可复用的领域索引和冲突点。
16
- 4. 不把命名本身当作领域模型。
17
-
18
- ## Guardrails
19
-
20
- - 不忽略规则冲突。
21
- - 不把实现细节冒充领域知识。
1
+ # /distill
2
+
3
+ 把业务事实和上下文提炼成可复用的业务理解。
4
+
5
+ ## Route
6
+
7
+ - 对应 skill:`business-analysis`
8
+ - 适用:需要整理业务语义、术语、边界和约束
9
+ - 不适用:只是在写纯接口说明或纯实现说明
10
+
11
+ ## Workflow
12
+
13
+ 1. 识别业务对象、规则和关键术语。
14
+ 2. 归纳成稳定、可复用的业务结论。
15
+ 3. 如果需要长期留档,再交给 `evidence-collector`。
16
+ 4. 不要把命名本身直接当成领域模型结论。
17
+
18
+ ## Guardrails
19
+
20
+ - 不要忽略业务规则冲突。
21
+ - 不要把实现细节伪装成业务知识。
@@ -1,22 +1,21 @@
1
- # /doc
2
-
3
- 鎶婃帴鍙e拰鍙樻洿鏁寸悊鎴愬彲瀵规帴鐨勬枃妗c€?
4
-
5
- ## Route
6
-
7
- - 瀵瑰簲 skill锛歚api-contract-docs`
8
- - 閫傜敤锛氭帴鍙h鏄庛€佸彉鏇磋鏄庛€佽仈璋冭鏄庛€佸悓姝ユ枃妗?
9
- - 涓嶉€傜敤锛氱函浠g爜瀹℃煡
10
-
11
- ## Workflow
12
-
13
- 1. 鍏堢‘璁ゆ帴鍙h竟鐣屽拰杈撳叆杈撳嚭銆?
14
- 2. 鎻愮偧璇锋眰銆佸搷搴斻€侀敊璇爜鍜岃皟鐢ㄩ『搴忋€?
15
- 3. 杈撳嚭鍙仈璋冪殑鏂囨。鑽夋銆?
16
- 4. 鍙樻洿鍚庡悓姝ュ埌鐭ヨ瘑娌夋穩銆?
17
-
18
- ## Guardrails
19
-
20
- - 涓嶉仐婕忛敊璇繑鍥炲拰绾︽潫銆?
21
- - 涓嶆妸绌烘硾璇存槑褰撴垚鏂囨。浜や粯銆?
22
-
1
+ # /doc
2
+
3
+ 把接口或契约说明收敛成可以落地的设计文档。
4
+
5
+ ## Route
6
+
7
+ - 对应 skill:`api-design`
8
+ - 适用:接口契约、请求响应、兼容性、字段约束
9
+ - 不适用:纯业务讨论或纯实现任务
10
+
11
+ ## Workflow
12
+
13
+ 1. 先确认要写的是接口、契约还是交付文档。
14
+ 2. 把请求、响应、错误和兼容性讲清楚。
15
+ 3. 只保留对实现和联调有帮助的信息。
16
+ 4. 如果是部署或发布文档,再交给 `deployment-guide`。
17
+
18
+ ## Guardrails
19
+
20
+ - 不要把 API 文档写成泛化的产品说明。
21
+ - 不要忽略兼容性和错误语义。
@@ -1,21 +1,21 @@
1
- # /infra
2
-
3
- 准备或管理开发依赖的基础设施。
4
-
5
- ## Route
6
-
7
- - 对应 skill:`environment-deploy`
8
- - 适用:Docker Compose、依赖服务启动、开发联调环境准备
9
- - 不适用:业务需求分析
10
-
11
- ## Workflow
12
-
13
- 1. 识别需要启动的基础设施组件。
14
- 2. 只拉起最小可用组合。
15
- 3. 输出启动状态和常见失败点。
16
- 4. 不把生产部署和本地开发混在一起。
17
-
18
- ## Guardrails
19
-
20
- - 不默认启动多余服务。
21
- - 不混淆生产环境和本地环境。
1
+ # /infra
2
+
3
+ 准备和管理开发依赖、运行依赖或交付前置环境。
4
+
5
+ ## Route
6
+
7
+ - 对应 skill:`deployment-guide`
8
+ - 适用:Docker Compose、依赖服务、开发联调环境、启动脚本
9
+ - 不适用:业务需求分析
10
+
11
+ ## Workflow
12
+
13
+ 1. 先识别需要启动或配置的基础设施组件。
14
+ 2. 只拉起最小可用组合。
15
+ 3. 说明启动状态、常见失败点和恢复办法。
16
+ 4. 不要把生产部署和本地开发环境混在一起。
17
+
18
+ ## Guardrails
19
+
20
+ - 不要默认启动多余服务。
21
+ - 不要混淆生产环境和本地环境。
@@ -1,20 +1,20 @@
1
- # /init
2
-
3
- 初始化项目或模块脚手架。
4
-
5
- ## Route
6
-
7
- - 对应 skill:`project-bootstrap`
8
- - 适用:新建项目、模块初始化、标准目录生成
9
- - 不适用:业务分析
10
-
11
- ## Workflow
12
-
13
- 1. 确认初始化对象是项目还是模块。
14
- 2. 生成标准目录、基础配置和依赖边界。
15
- 3. 输出后续应该进入的 skill。
16
- 4. 不触碰具体业务逻辑。
17
-
18
- ## Guardrails
19
-
20
- - 不跳过基础配置检查。
1
+ # /init
2
+
3
+ 进入新代码库或新模块时,先完成基础认知和落地准备。
4
+
5
+ ## Route
6
+
7
+ - 对应 skill:`codebase-learning`
8
+ - 适用:首次接手项目、初始化工作区、整理目录和基础约定
9
+ - 不适用:已经明确知道要改什么的实现任务
10
+
11
+ ## Workflow
12
+
13
+ 1. 先确认是项目级还是模块级初始化。
14
+ 2. 搞清楚目录结构、依赖入口和基本约定。
15
+ 3. 输出后续应该进入的 skill。
16
+ 4. 不要在这里直接做业务实现。
17
+
18
+ ## Guardrails
19
+
20
+ - 不要跳过基础约定检查。
@@ -1,20 +1,21 @@
1
- # /kb
2
-
3
- 把项目事实整理成可检索、可复用、可过期治理的知识中心。
4
-
5
- ## Route
6
-
7
- - 对应 skill:`knowledge-capture`
8
- - 适用:项目概览、模块索引、领域知识、方案沉淀、交接归档
9
-
10
- ## Workflow
11
-
12
- 1. 收集事实、来源、适用场景和限制条件。
13
- 2. 分类沉淀到项目、模块、领域、方案或协作索引。
14
- 3. 标明哪些内容可复用,哪些内容应过期清理。
15
- 4. 让归档结果反哺后续分析和实现。
16
-
17
- ## Guardrails
18
-
19
- - 不堆文档。
20
- - 不把未经验证的信息当知识沉淀。
1
+ # /kb
2
+
3
+ 把已经验证过的事实沉淀成可复用、可追溯的知识。
4
+
5
+ ## Route
6
+
7
+ - 对应 skill: `evidence-collector`
8
+ - 适用: 事实沉淀、证据整理、交接总结
9
+ - 不适用: 还没有证据,或者只是猜测
10
+
11
+ ## Workflow
12
+
13
+ 1. 收集来源、证据和适用场景。
14
+ 2. 区分事实、推断和未确认内容。
15
+ 3. 只沉淀已经验证过的内容。
16
+ 4. 如果还要整理业务语义,再交给 `business-analysis`。
17
+
18
+ ## Guardrails
19
+
20
+ - 不要把未验证内容写成知识。
21
+ - 不要把长文档当成证据。
@@ -1,21 +1,21 @@
1
- # /perf
2
-
3
- 妫€鏌ユ€ц兘鐑偣銆佺摱棰堝拰鍥炲綊椋庨櫓銆?
4
-
5
- ## Route
6
-
7
- - 瀵瑰簲 skill锛歚performance-audit`
8
- - 閫傜敤锛歂+1銆佺紦瀛樸€佺储寮曘€佹壒閲忔搷浣溿€佺儹鐐硅矾寰?
9
- - 涓嶉€傜敤锛氱函瀹夊叏瀹℃煡鎴栫函闇€姹傝璁?
10
-
11
- ## Workflow
12
-
13
- 1. 鎵惧嚭楂橀璺緞鍜屽ぇ鏁版嵁閲忚矾寰勩€?
14
- 2. 妫€鏌ユ暟鎹簱璁块棶銆佺紦瀛樺懡涓€佸惊鐜皟鐢ㄥ拰鎵瑰鐞嗐€?
15
- 3. 杈撳嚭鍙獙璇佺殑鎬ц兘椋庨櫓鍜屼紭鍖栭『搴忋€?
16
- 4. 蹇呰鏃朵氦缁?`code-review` 鎴?`feature-build`銆?
17
-
18
- ## Guardrails
19
-
20
- - 涓嶇敤娉涙硾寤鸿鏇夸唬瀹氫綅缁撹銆?
21
-
1
+ # /perf
2
+
3
+ 审查变更里的性能风险,重点看延迟、吞吐、内存和热点路径。
4
+
5
+ ## Route
6
+
7
+ - 对应 skill: `performance-review`
8
+ - 适用: latency、throughput、memory、load、hot path
9
+ - 不适用: 只需要一般代码审查
10
+
11
+ ## Workflow
12
+
13
+ 1. 找出具体慢路径和资源压力点。
14
+ 2. 说明瓶颈类型和影响范围。
15
+ 3. 只输出性能相关结论。
16
+ 4. 必要时再交给 `code-review` 或 `backend-development`。
17
+
18
+ ## Guardrails
19
+
20
+ - 不要用“可能会慢”代替具体路径。
21
+ - 不要把性能审查变成实现重写。
@@ -1,22 +1,21 @@
1
- # /prd
2
-
3
- 鎶婁骇鍝佹剰鍥炬敹鍙f垚缁欑爺鍙戝垎鏋愪娇鐢ㄧ殑闇€姹傝緭鍏ャ€?
4
-
5
- ## Route
6
-
7
- - 瀵瑰簲 skill锛歚spec-refinement`
8
- - 閫傜敤锛氫骇鍝佺洰鏍囥€佷笟鍔¤儗鏅€佽寖鍥磋鍓€佷紭鍏堢骇銆侀獙鏀跺彛寰勩€侀渶姹傚垵绋?
9
- - 涓嶉€傜敤锛氬凡缁忚繘鍏ュ疄鐜扮粏鑺傜殑鐮斿彂鍒嗘瀽
10
-
11
- ## Workflow
12
-
13
- 1. 鍏堢‘璁よ繖鏄骇鍝佷晶闇€姹傦紝涓嶇洿鎺ヨ繘鍏ヨ璁℃垨缂栫爜銆?
14
- 2. 鏀堕泦鐩爣銆佽寖鍥淬€佺害鏉熴€佷紭鍏堢骇鍜岄獙鏀舵爣鍑嗐€?
15
- 3. 杈撳嚭缁撴瀯鍖栫殑 PRD-ready brief銆?
16
- 4. 浜ょ粰 `technical-design`銆?
17
-
18
- ## Guardrails
19
-
20
- - 涓嶆浛浠g爺鍙戦渶姹傚垎鏋愩€?
21
- - 涓嶈烦杩囬渶姹傛敹鍙g洿鎺ュ啓鏈€缁堢粨璁恒€?
22
-
1
+ # /prd
2
+
3
+ 把 PRD、brief 或产品说明整理成可交给设计阶段的业务结论。
4
+
5
+ ## Route
6
+
7
+ - 对应 skill: `business-analysis`
8
+ - 适用: PRD、产品目标、业务规则、角色、业务流程整理
9
+ - 不适用: 已经明确要写实现方案
10
+
11
+ ## Workflow
12
+
13
+ 1. 提炼业务目标、角色、流程和规则。
14
+ 2. 区分需求、前提、验收和开放问题。
15
+ 3. 用业务语言输出,不提前写技术实现。
16
+ 4. 再交给 `architecture-design`。
17
+
18
+ ## Guardrails
19
+
20
+ - 不要把 PRD 直接改写成代码任务。
21
+ - 不要忽略业务冲突和未决问题。
@@ -1,22 +1,21 @@
1
- # /review
2
-
3
- 瀹℃煡浠g爜鍙樻洿銆佽川閲忛闄╁拰璺ㄦā鍧楀奖鍝嶃€?
4
-
5
- ## Route
6
-
7
- - 瀵瑰簲 skill锛歚code-review`
8
- - 閫傜敤锛歅R 瀹℃煡銆乨iff 瀹℃牳銆佷笂绾垮墠妫€鏌ャ€佹鏋惰鑼冩牳瀵?
9
- - 涓嶉€傜敤锛氱函闇€姹傝璁?
10
-
11
- ## Workflow
12
-
13
- 1. 鍏堢‘璁ゅ彉鏇磋寖鍥达紝涓嶅彧鐪嬪崟鏂囦欢銆?
14
- 2. 鏍稿鏋舵瀯銆佽竟鐣屻€佸洖褰掗闄╁拰绾︽潫銆?
15
- 3. 杈撳嚭闂绾у埆銆侀闄╁拰淇寤鸿銆?
16
- 4. 蹇呰鏃惰ˉ `security-audit` 鎴?`performance-audit`銆?
17
-
18
- ## Guardrails
19
-
20
- - 鍙鏌ュ凡缁忓彂鐢熺殑鍙樻洿銆?
21
- - 涓嶈烦杩囪瘉鎹洿鎺ヤ笅缁撹銆?
22
-
1
+ # /review
2
+
3
+ 审查已经提交的变更,重点找出可证实、可执行的质量问题。
4
+
5
+ ## Route
6
+
7
+ - 对应 skill: `code-review`
8
+ - 适用: diff、PR、重构结果、需要审查的代码变更
9
+ - 不适用: 还没有实现内容可审
10
+
11
+ ## Workflow
12
+
13
+ 1. 先看变更意图和影响面。
14
+ 2. 找出正确性、可维护性和回归风险问题。
15
+ 3. 只给能落地的审查结论。
16
+ 4. 如果发现安全或性能问题,再切到对应 review skill。
17
+
18
+ ## Guardrails
19
+
20
+ - 不要在 review 阶段重写实现。
21
+ - 不要把未验证的猜测写成结论。
@@ -1,22 +1,21 @@
1
- # /security
2
-
3
- 瀹℃煡瀹夊叏椋庨櫓銆佹潈闄愯竟鐣屽拰鏁忔劅鏁版嵁鏆撮湶銆?
4
-
5
- ## Route
6
-
7
- - 瀵瑰簲 skill锛歚security-audit`
8
- - 閫傜敤锛氬畨鍏ㄥ鏌ャ€佹潈闄愭鏌ャ€佹暟鎹毚闇叉鏌ャ€佸悎瑙勯闄╂鏌?
9
- - 涓嶉€傜敤锛氭櫘閫氶渶姹傝璁?
10
-
11
- ## Workflow
12
-
13
- 1. 鍏堢‘璁よ緭鍏ユ槸宸茬粡鍙戠敓鐨勫彉鏇存垨鍙鏌ョ殑鏂规銆?
14
- 2. 鎷嗗垎鎺ュ彛銆佹潈闄愩€佹暟鎹祦鍚戝拰鏁忔劅淇℃伅椋庨櫓銆?
15
- 3. 杈撳嚭瀹夊叏鍙戠幇銆佷紭鍏堢骇鍜屼慨澶嶅缓璁€?
16
- 4. 蹇呰鏃朵氦缁?`knowledge-capture` 鎴?`feature-build`銆?
17
-
18
- ## Guardrails
19
-
20
- - 涓嶇洿鎺ヤ慨鏀圭敓浜т唬鐮併€?
21
- - 涓嶆妸涓€鑸川閲忛棶棰樿鍒ゆ垚瀹夊叏缁撹銆?
22
-
1
+ # /security
2
+
3
+ 审查变更里的认证、权限、数据暴露和滥用风险。
4
+
5
+ ## Route
6
+
7
+ - 对应 skill: `security-review`
8
+ - 适用: auth、secret、用户输入、数据访问、信任边界
9
+ - 不适用: 只需要一般代码审查
10
+
11
+ ## Workflow
12
+
13
+ 1. 找出可能被不可信输入触达的敏感路径。
14
+ 2. 说明攻击面、影响对象和最小修复方式。
15
+ 3. 只输出安全相关的审查结论。
16
+ 4. 如果需要事实支撑,再交给 `evidence-collector`。
17
+
18
+ ## Guardrails
19
+
20
+ - 不要把安全审查变成实现重写。
21
+ - 不要把没有证据的风险写成 findings。
@@ -1,21 +1,21 @@
1
- # /test
2
-
3
- 把验收标准转成可执行的测试设计。
4
-
5
- ## Route
6
-
7
- - 对应 skill:`test-design`
8
- - 适用:测试策略、用例设计、回归矩阵、验证路径
9
- - 不适用:需求还不明确,或者只是想“快速跑一下”
10
-
11
- ## Workflow
12
-
13
- 1. 先确认验收标准或实现结果。
14
- 2. 转成测试策略、用例、回归和边界场景。
15
- 3. 输出可执行的验证方案。
16
- 4. 必要时交给 `code-review` 或 `feature-build`。
17
-
18
- ## Guardrails
19
-
20
- - 不跳过前置条件。
21
- - 不把“跑过一次”当作完整验证。
1
+ # /test
2
+
3
+ 把验证目标落成可执行的测试方案和测试实现。
4
+
5
+ ## Route
6
+
7
+ - 对应 skill: `unit-test`
8
+ - 适用: 单元测试、边界场景、回归保护
9
+ - 不适用: 需求还不清楚,或者只是想先跑一下
10
+
11
+ ## Workflow
12
+
13
+ 1. 先确认要验证的行为。
14
+ 2. 补齐测试策略、用例和边界场景。
15
+ 3. 输出可以直接执行的验证方案。
16
+ 4. 必要时交给 `regression-check`、`code-review` 或 `backend-development`。
17
+
18
+ ## Guardrails
19
+
20
+ - 不要跳过前置条件。
21
+ - 不要把“跑一次”当成完整验证。