ccjk 14.2.1 → 15.0.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 (526) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +58 -341
  3. package/dist/cli.js +59 -0
  4. package/dist/cli.js.map +1 -0
  5. package/dist/commands/detect.js +15 -0
  6. package/dist/commands/detect.js.map +1 -0
  7. package/dist/commands/doctor.js +68 -0
  8. package/dist/commands/doctor.js.map +1 -0
  9. package/dist/commands/git-install.js +50 -0
  10. package/dist/commands/git-install.js.map +1 -0
  11. package/dist/commands/init.js +102 -0
  12. package/dist/commands/init.js.map +1 -0
  13. package/dist/commands/mcp.js +66 -0
  14. package/dist/commands/mcp.js.map +1 -0
  15. package/dist/commands/menu.js +33 -0
  16. package/dist/commands/menu.js.map +1 -0
  17. package/dist/core/detect.js +24 -0
  18. package/dist/core/detect.js.map +1 -0
  19. package/dist/core/lint.js +49 -0
  20. package/dist/core/lint.js.map +1 -0
  21. package/dist/core/mcp.js +41 -0
  22. package/dist/core/mcp.js.map +1 -0
  23. package/dist/core/paths.js +9 -0
  24. package/dist/core/paths.js.map +1 -0
  25. package/dist/core/providers.js +53 -0
  26. package/dist/core/providers.js.map +1 -0
  27. package/dist/core/settings.js +31 -0
  28. package/dist/core/settings.js.map +1 -0
  29. package/dist/core/slash-templates.js +56 -0
  30. package/dist/core/slash-templates.js.map +1 -0
  31. package/dist/core/tools.js +27 -0
  32. package/dist/core/tools.js.map +1 -0
  33. package/package.json +43 -164
  34. package/README.HONEST.md +0 -176
  35. package/README.en.md +0 -67
  36. package/README.ja.md +0 -67
  37. package/README.ko.md +0 -67
  38. package/README.zh-CN.md +0 -86
  39. package/bin/ccjk.mjs +0 -5
  40. package/bin/ccjk.ts +0 -222
  41. package/dist/chunks/agent-teams.mjs +0 -145
  42. package/dist/chunks/agent.mjs +0 -1439
  43. package/dist/chunks/agents.mjs +0 -3783
  44. package/dist/chunks/api-cli.mjs +0 -135
  45. package/dist/chunks/api-config-selector.mjs +0 -159
  46. package/dist/chunks/api-providers.mjs +0 -144
  47. package/dist/chunks/api.mjs +0 -115
  48. package/dist/chunks/auto-bootstrap.mjs +0 -358
  49. package/dist/chunks/auto-fixer.mjs +0 -95
  50. package/dist/chunks/auto-updater.mjs +0 -507
  51. package/dist/chunks/banner.mjs +0 -173
  52. package/dist/chunks/bash.mjs +0 -187
  53. package/dist/chunks/boost.mjs +0 -474
  54. package/dist/chunks/brain-config.mjs +0 -75
  55. package/dist/chunks/brain-status.mjs +0 -89
  56. package/dist/chunks/ccjk-agents.mjs +0 -416
  57. package/dist/chunks/ccjk-all.mjs +0 -1046
  58. package/dist/chunks/ccjk-config.mjs +0 -445
  59. package/dist/chunks/ccjk-hooks.mjs +0 -1074
  60. package/dist/chunks/ccjk-mcp.mjs +0 -763
  61. package/dist/chunks/ccjk-setup.mjs +0 -765
  62. package/dist/chunks/ccjk-skills.mjs +0 -518
  63. package/dist/chunks/ccr.mjs +0 -109
  64. package/dist/chunks/ccu.mjs +0 -40
  65. package/dist/chunks/check-updates.mjs +0 -117
  66. package/dist/chunks/claude-code-incremental-manager.mjs +0 -761
  67. package/dist/chunks/claude-config.mjs +0 -606
  68. package/dist/chunks/claude-config2.mjs +0 -62
  69. package/dist/chunks/claude-wrapper.mjs +0 -85
  70. package/dist/chunks/clavue-config.mjs +0 -1390
  71. package/dist/chunks/cleanup-migration.mjs +0 -20
  72. package/dist/chunks/cli-hook.mjs +0 -4096
  73. package/dist/chunks/cloud-sync.mjs +0 -29
  74. package/dist/chunks/code-type-resolver.mjs +0 -880
  75. package/dist/chunks/codex-config-switch.mjs +0 -452
  76. package/dist/chunks/codex-provider-manager.mjs +0 -238
  77. package/dist/chunks/codex-uninstaller.mjs +0 -404
  78. package/dist/chunks/codex.mjs +0 -2141
  79. package/dist/chunks/commands.mjs +0 -108
  80. package/dist/chunks/commands2.mjs +0 -421
  81. package/dist/chunks/commit.mjs +0 -140
  82. package/dist/chunks/completion.mjs +0 -517
  83. package/dist/chunks/config-consolidator.mjs +0 -172
  84. package/dist/chunks/config-switch.mjs +0 -334
  85. package/dist/chunks/config.mjs +0 -558
  86. package/dist/chunks/config2.mjs +0 -484
  87. package/dist/chunks/config3.mjs +0 -486
  88. package/dist/chunks/constants.mjs +0 -323
  89. package/dist/chunks/context-opt.mjs +0 -444
  90. package/dist/chunks/context.mjs +0 -974
  91. package/dist/chunks/dashboard.mjs +0 -481
  92. package/dist/chunks/doctor.mjs +0 -1301
  93. package/dist/chunks/eval.mjs +0 -502
  94. package/dist/chunks/evolution.mjs +0 -322
  95. package/dist/chunks/features.mjs +0 -715
  96. package/dist/chunks/fish.mjs +0 -181
  97. package/dist/chunks/fs-operations.mjs +0 -180
  98. package/dist/chunks/health-alerts.mjs +0 -830
  99. package/dist/chunks/help.mjs +0 -341
  100. package/dist/chunks/hook-installer.mjs +0 -48
  101. package/dist/chunks/impact.mjs +0 -651
  102. package/dist/chunks/index.mjs +0 -23
  103. package/dist/chunks/index10.mjs +0 -19
  104. package/dist/chunks/index11.mjs +0 -1171
  105. package/dist/chunks/index12.mjs +0 -218
  106. package/dist/chunks/index13.mjs +0 -679
  107. package/dist/chunks/index14.mjs +0 -1009
  108. package/dist/chunks/index15.mjs +0 -194
  109. package/dist/chunks/index2.mjs +0 -7637
  110. package/dist/chunks/index3.mjs +0 -171
  111. package/dist/chunks/index4.mjs +0 -26
  112. package/dist/chunks/index5.mjs +0 -19
  113. package/dist/chunks/index6.mjs +0 -19092
  114. package/dist/chunks/index7.mjs +0 -616
  115. package/dist/chunks/index8.mjs +0 -1602
  116. package/dist/chunks/index9.mjs +0 -5384
  117. package/dist/chunks/init.mjs +0 -1911
  118. package/dist/chunks/installer.mjs +0 -757
  119. package/dist/chunks/installer2.mjs +0 -103
  120. package/dist/chunks/interview.mjs +0 -2927
  121. package/dist/chunks/json-config.mjs +0 -60
  122. package/dist/chunks/linux.mjs +0 -3863
  123. package/dist/chunks/macos.mjs +0 -69
  124. package/dist/chunks/main.mjs +0 -635
  125. package/dist/chunks/manager.mjs +0 -1048
  126. package/dist/chunks/marketplace.mjs +0 -265
  127. package/dist/chunks/mcp-cli.mjs +0 -205
  128. package/dist/chunks/mcp-performance.mjs +0 -187
  129. package/dist/chunks/mcp.mjs +0 -667
  130. package/dist/chunks/memory-check.mjs +0 -2973
  131. package/dist/chunks/memory-paths.mjs +0 -259
  132. package/dist/chunks/memory-sync.mjs +0 -209
  133. package/dist/chunks/memory.mjs +0 -354
  134. package/dist/chunks/metrics-display.mjs +0 -153
  135. package/dist/chunks/monitor.mjs +0 -1856
  136. package/dist/chunks/notification.mjs +0 -1864
  137. package/dist/chunks/onboarding.mjs +0 -386
  138. package/dist/chunks/package.mjs +0 -3
  139. package/dist/chunks/paradigm.mjs +0 -74
  140. package/dist/chunks/permission-manager.mjs +0 -250
  141. package/dist/chunks/permissions.mjs +0 -265
  142. package/dist/chunks/persistence-manager.mjs +0 -801
  143. package/dist/chunks/persistence.mjs +0 -707
  144. package/dist/chunks/platform.mjs +0 -395
  145. package/dist/chunks/plugin.mjs +0 -1936
  146. package/dist/chunks/powershell.mjs +0 -213
  147. package/dist/chunks/prompts.mjs +0 -244
  148. package/dist/chunks/providers.mjs +0 -263
  149. package/dist/chunks/quick-actions.mjs +0 -335
  150. package/dist/chunks/quick-provider.mjs +0 -755
  151. package/dist/chunks/quick-setup.mjs +0 -421
  152. package/dist/chunks/remote.mjs +0 -497
  153. package/dist/chunks/research.mjs +0 -1904
  154. package/dist/chunks/rollback.mjs +0 -38
  155. package/dist/chunks/session-manager.mjs +0 -1371
  156. package/dist/chunks/session.mjs +0 -878
  157. package/dist/chunks/sessions.mjs +0 -106
  158. package/dist/chunks/silent-updater.mjs +0 -396
  159. package/dist/chunks/simple-config.mjs +0 -122
  160. package/dist/chunks/skill.mjs +0 -117
  161. package/dist/chunks/skill2.mjs +0 -9052
  162. package/dist/chunks/skills-sync.mjs +0 -1343
  163. package/dist/chunks/skills.mjs +0 -577
  164. package/dist/chunks/slash-commands.mjs +0 -208
  165. package/dist/chunks/smart-guide.mjs +0 -247
  166. package/dist/chunks/snapshot.mjs +0 -58
  167. package/dist/chunks/startup.mjs +0 -487
  168. package/dist/chunks/stats.mjs +0 -191
  169. package/dist/chunks/status.mjs +0 -471
  170. package/dist/chunks/team.mjs +0 -63
  171. package/dist/chunks/thinking.mjs +0 -626
  172. package/dist/chunks/trace.mjs +0 -57
  173. package/dist/chunks/uninstall.mjs +0 -852
  174. package/dist/chunks/update.mjs +0 -174
  175. package/dist/chunks/upgrade-manager.mjs +0 -204
  176. package/dist/chunks/upgrade.mjs +0 -133
  177. package/dist/chunks/version-checker.mjs +0 -891
  178. package/dist/chunks/vim.mjs +0 -903
  179. package/dist/chunks/windows.mjs +0 -14
  180. package/dist/chunks/workflows.mjs +0 -633
  181. package/dist/chunks/wsl.mjs +0 -129
  182. package/dist/chunks/zero-config.mjs +0 -871
  183. package/dist/chunks/zsh.mjs +0 -182
  184. package/dist/cli.d.mts +0 -1
  185. package/dist/cli.d.ts +0 -1
  186. package/dist/cli.mjs +0 -2684
  187. package/dist/i18n/locales/en/agent-teams.json +0 -18
  188. package/dist/i18n/locales/en/agentBrowser.json +0 -80
  189. package/dist/i18n/locales/en/agents.json +0 -135
  190. package/dist/i18n/locales/en/api.json +0 -63
  191. package/dist/i18n/locales/en/ccjk-agents.json +0 -33
  192. package/dist/i18n/locales/en/ccjk-all.json +0 -23
  193. package/dist/i18n/locales/en/ccjk-skills.json +0 -22
  194. package/dist/i18n/locales/en/ccjk.json +0 -276
  195. package/dist/i18n/locales/en/ccr.json +0 -65
  196. package/dist/i18n/locales/en/claude-md.json +0 -73
  197. package/dist/i18n/locales/en/cli.json +0 -148
  198. package/dist/i18n/locales/en/cloud-setup.json +0 -31
  199. package/dist/i18n/locales/en/cloud-sync.json +0 -147
  200. package/dist/i18n/locales/en/cloud.json +0 -40
  201. package/dist/i18n/locales/en/cloudPlugins.json +0 -118
  202. package/dist/i18n/locales/en/codex.json +0 -184
  203. package/dist/i18n/locales/en/cometix.json +0 -29
  204. package/dist/i18n/locales/en/common.json +0 -68
  205. package/dist/i18n/locales/en/config.json +0 -108
  206. package/dist/i18n/locales/en/configuration.json +0 -234
  207. package/dist/i18n/locales/en/context.json +0 -85
  208. package/dist/i18n/locales/en/dashboard.json +0 -78
  209. package/dist/i18n/locales/en/errors.json +0 -26
  210. package/dist/i18n/locales/en/evolution.json +0 -54
  211. package/dist/i18n/locales/en/hooks.json +0 -74
  212. package/dist/i18n/locales/en/hooksSync.json +0 -133
  213. package/dist/i18n/locales/en/installation.json +0 -83
  214. package/dist/i18n/locales/en/interview.json +0 -104
  215. package/dist/i18n/locales/en/language.json +0 -19
  216. package/dist/i18n/locales/en/lsp.json +0 -78
  217. package/dist/i18n/locales/en/marketplace.json +0 -116
  218. package/dist/i18n/locales/en/mcp.json +0 -180
  219. package/dist/i18n/locales/en/memory.json +0 -23
  220. package/dist/i18n/locales/en/menu.json +0 -299
  221. package/dist/i18n/locales/en/multi-config.json +0 -79
  222. package/dist/i18n/locales/en/notification.json +0 -307
  223. package/dist/i18n/locales/en/permissions.json +0 -95
  224. package/dist/i18n/locales/en/persistence.json +0 -127
  225. package/dist/i18n/locales/en/plugins.json +0 -146
  226. package/dist/i18n/locales/en/quick-actions.json +0 -78
  227. package/dist/i18n/locales/en/registry.json +0 -54
  228. package/dist/i18n/locales/en/remote.json +0 -93
  229. package/dist/i18n/locales/en/sandbox.json +0 -44
  230. package/dist/i18n/locales/en/setup.json +0 -44
  231. package/dist/i18n/locales/en/shencha.json +0 -14
  232. package/dist/i18n/locales/en/skills.json +0 -100
  233. package/dist/i18n/locales/en/skillsSync.json +0 -74
  234. package/dist/i18n/locales/en/smartGuide.json +0 -49
  235. package/dist/i18n/locales/en/stats.json +0 -20
  236. package/dist/i18n/locales/en/subagent.json +0 -69
  237. package/dist/i18n/locales/en/superpowers.json +0 -117
  238. package/dist/i18n/locales/en/team.json +0 -7
  239. package/dist/i18n/locales/en/thinking.json +0 -65
  240. package/dist/i18n/locales/en/tools.json +0 -42
  241. package/dist/i18n/locales/en/uninstall.json +0 -56
  242. package/dist/i18n/locales/en/updater.json +0 -29
  243. package/dist/i18n/locales/en/vim.json +0 -169
  244. package/dist/i18n/locales/en/workflow.json +0 -55
  245. package/dist/i18n/locales/en/workspace.json +0 -108
  246. package/dist/i18n/locales/zh-CN/agent-teams.json +0 -18
  247. package/dist/i18n/locales/zh-CN/agentBrowser.json +0 -80
  248. package/dist/i18n/locales/zh-CN/agents.json +0 -135
  249. package/dist/i18n/locales/zh-CN/api.json +0 -63
  250. package/dist/i18n/locales/zh-CN/ccjk-agents.json +0 -33
  251. package/dist/i18n/locales/zh-CN/ccjk-all.json +0 -23
  252. package/dist/i18n/locales/zh-CN/ccjk-skills.json +0 -22
  253. package/dist/i18n/locales/zh-CN/ccjk.json +0 -276
  254. package/dist/i18n/locales/zh-CN/ccr.json +0 -65
  255. package/dist/i18n/locales/zh-CN/claude-md.json +0 -73
  256. package/dist/i18n/locales/zh-CN/cli.json +0 -148
  257. package/dist/i18n/locales/zh-CN/cloud-setup.json +0 -31
  258. package/dist/i18n/locales/zh-CN/cloud-sync.json +0 -147
  259. package/dist/i18n/locales/zh-CN/cloud.json +0 -40
  260. package/dist/i18n/locales/zh-CN/cloudPlugins.json +0 -118
  261. package/dist/i18n/locales/zh-CN/codex.json +0 -184
  262. package/dist/i18n/locales/zh-CN/cometix.json +0 -29
  263. package/dist/i18n/locales/zh-CN/common.json +0 -68
  264. package/dist/i18n/locales/zh-CN/config.json +0 -108
  265. package/dist/i18n/locales/zh-CN/configuration.json +0 -232
  266. package/dist/i18n/locales/zh-CN/context.json +0 -85
  267. package/dist/i18n/locales/zh-CN/dashboard.json +0 -78
  268. package/dist/i18n/locales/zh-CN/errors.json +0 -26
  269. package/dist/i18n/locales/zh-CN/evolution.json +0 -54
  270. package/dist/i18n/locales/zh-CN/hooks.json +0 -74
  271. package/dist/i18n/locales/zh-CN/hooksSync.json +0 -133
  272. package/dist/i18n/locales/zh-CN/installation.json +0 -83
  273. package/dist/i18n/locales/zh-CN/interview.json +0 -104
  274. package/dist/i18n/locales/zh-CN/language.json +0 -19
  275. package/dist/i18n/locales/zh-CN/lsp.json +0 -78
  276. package/dist/i18n/locales/zh-CN/marketplace.json +0 -116
  277. package/dist/i18n/locales/zh-CN/mcp.json +0 -180
  278. package/dist/i18n/locales/zh-CN/memory.json +0 -23
  279. package/dist/i18n/locales/zh-CN/menu.json +0 -299
  280. package/dist/i18n/locales/zh-CN/multi-config.json +0 -79
  281. package/dist/i18n/locales/zh-CN/notification.json +0 -307
  282. package/dist/i18n/locales/zh-CN/permissions.json +0 -95
  283. package/dist/i18n/locales/zh-CN/persistence.json +0 -127
  284. package/dist/i18n/locales/zh-CN/plugins.json +0 -146
  285. package/dist/i18n/locales/zh-CN/quick-actions.json +0 -78
  286. package/dist/i18n/locales/zh-CN/registry.json +0 -54
  287. package/dist/i18n/locales/zh-CN/remote.json +0 -93
  288. package/dist/i18n/locales/zh-CN/sandbox.json +0 -44
  289. package/dist/i18n/locales/zh-CN/setup.json +0 -44
  290. package/dist/i18n/locales/zh-CN/shencha.json +0 -14
  291. package/dist/i18n/locales/zh-CN/skills.json +0 -100
  292. package/dist/i18n/locales/zh-CN/skillsSync.json +0 -74
  293. package/dist/i18n/locales/zh-CN/smartGuide.json +0 -49
  294. package/dist/i18n/locales/zh-CN/stats.json +0 -20
  295. package/dist/i18n/locales/zh-CN/subagent.json +0 -69
  296. package/dist/i18n/locales/zh-CN/superpowers.json +0 -117
  297. package/dist/i18n/locales/zh-CN/team.json +0 -7
  298. package/dist/i18n/locales/zh-CN/thinking.json +0 -65
  299. package/dist/i18n/locales/zh-CN/tools.json +0 -42
  300. package/dist/i18n/locales/zh-CN/uninstall.json +0 -56
  301. package/dist/i18n/locales/zh-CN/updater.json +0 -29
  302. package/dist/i18n/locales/zh-CN/vim.json +0 -169
  303. package/dist/i18n/locales/zh-CN/workflow.json +0 -55
  304. package/dist/i18n/locales/zh-CN/workspace.json +0 -108
  305. package/dist/index.d.mts +0 -5658
  306. package/dist/index.d.ts +0 -5658
  307. package/dist/index.mjs +0 -3732
  308. package/dist/shared/ccjk.8oaxX4iR.mjs +0 -90
  309. package/dist/shared/ccjk.B2U7DsPy.mjs +0 -31
  310. package/dist/shared/ccjk.B2f-cwUP.mjs +0 -468
  311. package/dist/shared/ccjk.BAGoDD49.mjs +0 -36
  312. package/dist/shared/ccjk.BBtCGd_g.mjs +0 -899
  313. package/dist/shared/ccjk.BFQ7yr5S.mjs +0 -16
  314. package/dist/shared/ccjk.BLsIiTqO.mjs +0 -449
  315. package/dist/shared/ccjk.BXv8aYs1.mjs +0 -170
  316. package/dist/shared/ccjk.BnsY5WxD.mjs +0 -171
  317. package/dist/shared/ccjk.BoApaI4j.mjs +0 -28
  318. package/dist/shared/ccjk.Bq8TqZG_.mjs +0 -189
  319. package/dist/shared/ccjk.BtrioX1Z.mjs +0 -25
  320. package/dist/shared/ccjk.Bx_rmYfN.mjs +0 -69
  321. package/dist/shared/ccjk.BzPbSEP2.mjs +0 -115
  322. package/dist/shared/ccjk.C1Be3aJN.mjs +0 -254
  323. package/dist/shared/ccjk.C1hANZTu.mjs +0 -19
  324. package/dist/shared/ccjk.C2jHOZVP.mjs +0 -52
  325. package/dist/shared/ccjk.C94P8gCY.mjs +0 -283
  326. package/dist/shared/ccjk.CNhnT6uQ.mjs +0 -636
  327. package/dist/shared/ccjk.COweQ1RR.mjs +0 -5
  328. package/dist/shared/ccjk.CTr4yCZ1.mjs +0 -225
  329. package/dist/shared/ccjk.CfKKcvWy.mjs +0 -126
  330. package/dist/shared/ccjk.Cjgrln_h.mjs +0 -297
  331. package/dist/shared/ccjk.CoCHVXl3.mjs +0 -3951
  332. package/dist/shared/ccjk.CwGZSTAK.mjs +0 -319
  333. package/dist/shared/ccjk.CxpGa6MC.mjs +0 -2724
  334. package/dist/shared/ccjk.D-magaEx.mjs +0 -763
  335. package/dist/shared/ccjk.D0g2ABGg.mjs +0 -171
  336. package/dist/shared/ccjk.D6ycHbak.mjs +0 -270
  337. package/dist/shared/ccjk.D75wivnp.mjs +0 -142
  338. package/dist/shared/ccjk.DDL-4C-k.mjs +0 -100
  339. package/dist/shared/ccjk.DFRPtmK_.mjs +0 -75
  340. package/dist/shared/ccjk.DMV3x5Sd.mjs +0 -299
  341. package/dist/shared/ccjk.DZ2LLOa-.mjs +0 -2195
  342. package/dist/shared/ccjk.DbigonEQ.mjs +0 -698
  343. package/dist/shared/ccjk.DcMvE7lf.mjs +0 -618
  344. package/dist/shared/ccjk.DeWpAShp.mjs +0 -1828
  345. package/dist/shared/ccjk.DhJ1kyDR.mjs +0 -30
  346. package/dist/shared/ccjk.DlTXS9rP.mjs +0 -224
  347. package/dist/shared/ccjk.DopKzo3z.mjs +0 -305
  348. package/dist/shared/ccjk.DsZsc4LR.mjs +0 -1280
  349. package/dist/shared/ccjk.DuzJZlgj.mjs +0 -418
  350. package/dist/shared/ccjk.Dxgd2vjc.mjs +0 -444
  351. package/dist/shared/ccjk.J8YiPsOw.mjs +0 -259
  352. package/dist/shared/ccjk.KfSWcGlE.mjs +0 -38
  353. package/dist/shared/ccjk.MwtjAULc.mjs +0 -1447
  354. package/dist/shared/ccjk.OJKHVSOb.mjs +0 -2005
  355. package/dist/shared/ccjk.OTnevPNE.mjs +0 -225
  356. package/dist/shared/ccjk.RyizuzOI.mjs +0 -21
  357. package/dist/shared/ccjk.T_cX87dY.mjs +0 -15
  358. package/dist/shared/ccjk.bQ7Dh1g4.mjs +0 -249
  359. package/dist/shared/ccjk.gDEDGD_t.mjs +0 -38
  360. package/dist/shared/ccjk.hoqrwWdN.mjs +0 -333
  361. package/dist/shared/ccjk.i_vn-9C3.mjs +0 -317
  362. package/dist/shared/ccjk.lG3ccFjm.mjs +0 -885
  363. package/dist/shared/ccjk.wLJHO0Af.mjs +0 -244
  364. package/dist/shared/ccjk.y-a_1vK4.mjs +0 -5127
  365. package/dist/templates/agents/README.md +0 -78
  366. package/dist/templates/agents/fullstack-developer.json +0 -70
  367. package/dist/templates/agents/go-expert.json +0 -69
  368. package/dist/templates/agents/index.json +0 -64
  369. package/dist/templates/agents/python-expert.json +0 -69
  370. package/dist/templates/agents/react-specialist.json +0 -69
  371. package/dist/templates/agents/testing-automation-expert.json +0 -70
  372. package/dist/templates/agents/typescript-architect.json +0 -69
  373. package/dist/templates/claude-code/common/settings.json +0 -109
  374. package/dist/templates/common/error-prevention.md +0 -267
  375. package/dist/templates/common/karpathy-baseline.md +0 -83
  376. package/dist/templates/common/output-styles/zh-CN/carmack-mode.md +0 -381
  377. package/dist/templates/common/output-styles/zh-CN/dhh-mode.md +0 -265
  378. package/dist/templates/common/output-styles/zh-CN/evan-you-mode.md +0 -539
  379. package/dist/templates/common/output-styles/zh-CN/jobs-mode.md +0 -369
  380. package/dist/templates/common/output-styles/zh-CN/linus-mode.md +0 -135
  381. package/dist/templates/common/output-styles/zh-CN/uncle-bob-mode.md +0 -221
  382. package/dist/templates/common/workflow/continuousDelivery/en/continuous-delivery.md +0 -628
  383. package/dist/templates/common/workflow/continuousDelivery/zh-CN/continuous-delivery.md +0 -628
  384. package/dist/templates/common/workflow/essential/en/agents/ccjk-config-agent.md +0 -187
  385. package/dist/templates/common/workflow/essential/en/agents/ccjk-mcp-agent.md +0 -191
  386. package/dist/templates/common/workflow/essential/en/agents/ccjk-skill-agent.md +0 -249
  387. package/dist/templates/common/workflow/essential/en/agents/ccjk-workflow-agent.md +0 -277
  388. package/dist/templates/common/workflow/essential/en/agents/get-current-datetime.md +0 -29
  389. package/dist/templates/common/workflow/essential/en/agents/init-architect.md +0 -115
  390. package/dist/templates/common/workflow/essential/en/agents/ui-ux-designer.md +0 -91
  391. package/dist/templates/common/workflow/essential/en/feat.md +0 -92
  392. package/dist/templates/common/workflow/essential/en/goal.md +0 -147
  393. package/dist/templates/common/workflow/essential/en/init-project.md +0 -53
  394. package/dist/templates/common/workflow/essential/zh-CN/agents/get-current-datetime.md +0 -29
  395. package/dist/templates/common/workflow/essential/zh-CN/agents/init-architect.md +0 -115
  396. package/dist/templates/common/workflow/essential/zh-CN/agents/ui-ux-designer.md +0 -91
  397. package/dist/templates/common/workflow/essential/zh-CN/feat.md +0 -315
  398. package/dist/templates/common/workflow/essential/zh-CN/goal.md +0 -146
  399. package/dist/templates/common/workflow/essential/zh-CN/init-project.md +0 -53
  400. package/dist/templates/common/workflow/git/en/git-cleanBranches.md +0 -102
  401. package/dist/templates/common/workflow/git/en/git-commit.md +0 -205
  402. package/dist/templates/common/workflow/git/en/git-rollback.md +0 -90
  403. package/dist/templates/common/workflow/git/en/git-worktree.md +0 -276
  404. package/dist/templates/common/workflow/git/zh-CN/git-cleanBranches.md +0 -102
  405. package/dist/templates/common/workflow/git/zh-CN/git-commit.md +0 -205
  406. package/dist/templates/common/workflow/git/zh-CN/git-rollback.md +0 -90
  407. package/dist/templates/common/workflow/git/zh-CN/git-worktree.md +0 -276
  408. package/dist/templates/common/workflow/interview/en/interview.md +0 -67
  409. package/dist/templates/common/workflow/interview/zh-CN/interview.md +0 -67
  410. package/dist/templates/common/workflow/linearMethod/en/linear-method.md +0 -651
  411. package/dist/templates/common/workflow/linearMethod/zh-CN/linear-method.md +0 -752
  412. package/dist/templates/common/workflow/refactoringMaster/en/refactoring-master.md +0 -516
  413. package/dist/templates/common/workflow/refactoringMaster/zh-CN/refactoring-master.md +0 -812
  414. package/dist/templates/common/workflow/sixStep/en/workflow.md +0 -83
  415. package/dist/templates/common/workflow/sixStep/zh-CN/workflow.md +0 -359
  416. package/dist/templates/common/workflow/specFirstTDD/en/spec-first-tdd.md +0 -364
  417. package/dist/templates/common/workflow/specFirstTDD/zh-CN/spec-first-tdd.md +0 -366
  418. package/dist/templates/hooks/README.md +0 -212
  419. package/dist/templates/hooks/git-workflow-hooks.md +0 -551
  420. package/dist/templates/hooks/post-test/coverage.json +0 -21
  421. package/dist/templates/hooks/post-test/summary.json +0 -21
  422. package/dist/templates/hooks/post-test-coverage.md +0 -434
  423. package/dist/templates/hooks/pre-commit/eslint.json +0 -22
  424. package/dist/templates/hooks/pre-commit/prettier.json +0 -22
  425. package/dist/templates/hooks/pre-commit-black.md +0 -274
  426. package/dist/templates/hooks/pre-commit-eslint.md +0 -153
  427. package/dist/templates/hooks/pre-commit-gofmt.md +0 -284
  428. package/dist/templates/hooks/pre-commit-prettier.md +0 -212
  429. package/dist/templates/hooks/pre-commit-type-check.md +0 -377
  430. package/dist/templates/skills/ccjk-init.md +0 -154
  431. package/dist/templates/skills/ccjk-mcp-setup.md +0 -205
  432. package/dist/templates/skills/ccjk-troubleshoot.md +0 -228
  433. package/dist/templates/skills/django-patterns.md +0 -1016
  434. package/dist/templates/skills/git-workflow.md +0 -748
  435. package/dist/templates/skills/go-idioms.md +0 -963
  436. package/dist/templates/skills/index.json +0 -132
  437. package/dist/templates/skills/nextjs-optimization.md +0 -694
  438. package/dist/templates/skills/python-pep8.md +0 -852
  439. package/dist/templates/skills/react-patterns.md +0 -686
  440. package/dist/templates/skills/rust-patterns.md +0 -1057
  441. package/dist/templates/skills/security-best-practices.md +0 -1413
  442. package/dist/templates/skills/testing-best-practices.md +0 -1315
  443. package/dist/templates/skills/ts-best-practices.md +0 -354
  444. package/templates/agents/README.md +0 -78
  445. package/templates/agents/fullstack-developer.json +0 -70
  446. package/templates/agents/go-expert.json +0 -69
  447. package/templates/agents/index.json +0 -64
  448. package/templates/agents/python-expert.json +0 -69
  449. package/templates/agents/react-specialist.json +0 -69
  450. package/templates/agents/testing-automation-expert.json +0 -70
  451. package/templates/agents/typescript-architect.json +0 -69
  452. package/templates/claude-code/common/settings.json +0 -109
  453. package/templates/common/error-prevention.md +0 -267
  454. package/templates/common/karpathy-baseline.md +0 -83
  455. package/templates/common/output-styles/zh-CN/carmack-mode.md +0 -381
  456. package/templates/common/output-styles/zh-CN/dhh-mode.md +0 -265
  457. package/templates/common/output-styles/zh-CN/evan-you-mode.md +0 -539
  458. package/templates/common/output-styles/zh-CN/jobs-mode.md +0 -369
  459. package/templates/common/output-styles/zh-CN/linus-mode.md +0 -135
  460. package/templates/common/output-styles/zh-CN/uncle-bob-mode.md +0 -221
  461. package/templates/common/workflow/continuousDelivery/en/continuous-delivery.md +0 -628
  462. package/templates/common/workflow/continuousDelivery/zh-CN/continuous-delivery.md +0 -628
  463. package/templates/common/workflow/essential/en/agents/ccjk-config-agent.md +0 -187
  464. package/templates/common/workflow/essential/en/agents/ccjk-mcp-agent.md +0 -191
  465. package/templates/common/workflow/essential/en/agents/ccjk-skill-agent.md +0 -249
  466. package/templates/common/workflow/essential/en/agents/ccjk-workflow-agent.md +0 -277
  467. package/templates/common/workflow/essential/en/agents/get-current-datetime.md +0 -29
  468. package/templates/common/workflow/essential/en/agents/init-architect.md +0 -115
  469. package/templates/common/workflow/essential/en/agents/ui-ux-designer.md +0 -91
  470. package/templates/common/workflow/essential/en/feat.md +0 -92
  471. package/templates/common/workflow/essential/en/goal.md +0 -147
  472. package/templates/common/workflow/essential/en/init-project.md +0 -53
  473. package/templates/common/workflow/essential/zh-CN/agents/get-current-datetime.md +0 -29
  474. package/templates/common/workflow/essential/zh-CN/agents/init-architect.md +0 -115
  475. package/templates/common/workflow/essential/zh-CN/agents/ui-ux-designer.md +0 -91
  476. package/templates/common/workflow/essential/zh-CN/feat.md +0 -315
  477. package/templates/common/workflow/essential/zh-CN/goal.md +0 -146
  478. package/templates/common/workflow/essential/zh-CN/init-project.md +0 -53
  479. package/templates/common/workflow/git/en/git-cleanBranches.md +0 -102
  480. package/templates/common/workflow/git/en/git-commit.md +0 -205
  481. package/templates/common/workflow/git/en/git-rollback.md +0 -90
  482. package/templates/common/workflow/git/en/git-worktree.md +0 -276
  483. package/templates/common/workflow/git/zh-CN/git-cleanBranches.md +0 -102
  484. package/templates/common/workflow/git/zh-CN/git-commit.md +0 -205
  485. package/templates/common/workflow/git/zh-CN/git-rollback.md +0 -90
  486. package/templates/common/workflow/git/zh-CN/git-worktree.md +0 -276
  487. package/templates/common/workflow/interview/en/interview.md +0 -67
  488. package/templates/common/workflow/interview/zh-CN/interview.md +0 -67
  489. package/templates/common/workflow/linearMethod/en/linear-method.md +0 -651
  490. package/templates/common/workflow/linearMethod/zh-CN/linear-method.md +0 -752
  491. package/templates/common/workflow/refactoringMaster/en/refactoring-master.md +0 -516
  492. package/templates/common/workflow/refactoringMaster/zh-CN/refactoring-master.md +0 -812
  493. package/templates/common/workflow/sixStep/en/workflow.md +0 -83
  494. package/templates/common/workflow/sixStep/zh-CN/workflow.md +0 -359
  495. package/templates/common/workflow/specFirstTDD/en/spec-first-tdd.md +0 -364
  496. package/templates/common/workflow/specFirstTDD/zh-CN/spec-first-tdd.md +0 -366
  497. package/templates/hooks/README.md +0 -212
  498. package/templates/hooks/git-workflow-hooks.md +0 -551
  499. package/templates/hooks/post-test/coverage.json +0 -21
  500. package/templates/hooks/post-test/summary.json +0 -21
  501. package/templates/hooks/post-test-coverage.md +0 -434
  502. package/templates/hooks/pre-commit/eslint.json +0 -22
  503. package/templates/hooks/pre-commit/prettier.json +0 -22
  504. package/templates/hooks/pre-commit-black.md +0 -274
  505. package/templates/hooks/pre-commit-eslint.md +0 -153
  506. package/templates/hooks/pre-commit-gofmt.md +0 -284
  507. package/templates/hooks/pre-commit-prettier.md +0 -212
  508. package/templates/hooks/pre-commit-type-check.md +0 -377
  509. package/templates/skills/basic.hbs +0 -72
  510. package/templates/skills/ccjk-init.md +0 -154
  511. package/templates/skills/ccjk-mcp-setup.md +0 -205
  512. package/templates/skills/ccjk-troubleshoot.md +0 -228
  513. package/templates/skills/code-refactor.hbs +0 -133
  514. package/templates/skills/code-review.hbs +0 -141
  515. package/templates/skills/django-patterns.md +0 -1016
  516. package/templates/skills/git-workflow.md +0 -748
  517. package/templates/skills/go-idioms.md +0 -963
  518. package/templates/skills/index.json +0 -132
  519. package/templates/skills/nextjs-optimization.md +0 -694
  520. package/templates/skills/python-pep8.md +0 -852
  521. package/templates/skills/react-patterns.md +0 -686
  522. package/templates/skills/rust-patterns.md +0 -1057
  523. package/templates/skills/security-best-practices.md +0 -1413
  524. package/templates/skills/testing-best-practices.md +0 -1315
  525. package/templates/skills/ts-best-practices.md +0 -354
  526. package/templates/skills/type-fix.hbs +0 -132
@@ -1,1315 +0,0 @@
1
- ---
2
- name: testing-best-practices
3
- description: TDD workflow, test organization, mocking strategies, and comprehensive testing approaches
4
- description_zh: TDD 工作流、测试组织、模拟策略和全面测试方法
5
- version: 1.0.0
6
- category: testing
7
- triggers: ['/testing-best-practices', '/tdd', '/testing', '/test-patterns']
8
- use_when:
9
- - Implementing test-driven development workflows
10
- - Organizing test suites and improving test coverage
11
- - Setting up mocking and testing strategies
12
- - Code review for testing practices
13
- use_when_zh:
14
- - 实现测试驱动开发工作流
15
- - 组织测试套件和提高测试覆盖率
16
- - 设置模拟和测试策略
17
- - 测试实践代码审查
18
- auto_activate: true
19
- priority: 8
20
- agents: [testing-expert, qa-engineer]
21
- tags: [testing, tdd, mocking, coverage, quality-assurance]
22
- ---
23
-
24
- # Testing Best Practices | 测试最佳实践
25
-
26
- ## Context | 上下文
27
-
28
- Use this skill when implementing comprehensive testing strategies, following TDD principles, and ensuring high-quality code through effective testing practices. Essential for maintainable and reliable software development.
29
-
30
- 在实现全面测试策略、遵循 TDD 原则并通过有效测试实践确保高质量代码时使用此技能。对于可维护和可靠的软件开发至关重要。
31
-
32
- ## Test-Driven Development (TDD) | 测试驱动开发
33
-
34
- ### 1. TDD Cycle: Red-Green-Refactor | TDD 循环:红-绿-重构
35
-
36
- ```javascript
37
- // ✅ Good: TDD Example - Building a Calculator
38
-
39
- // Step 1: RED - Write failing test first
40
- describe('Calculator', () => {
41
- describe('add', () => {
42
- it('should add two positive numbers', () => {
43
- const calculator = new Calculator();
44
- const result = calculator.add(2, 3);
45
- expect(result).toBe(5);
46
- });
47
-
48
- it('should handle negative numbers', () => {
49
- const calculator = new Calculator();
50
- const result = calculator.add(-2, 3);
51
- expect(result).toBe(1);
52
- });
53
-
54
- it('should handle zero', () => {
55
- const calculator = new Calculator();
56
- const result = calculator.add(0, 5);
57
- expect(result).toBe(5);
58
- });
59
-
60
- it('should handle decimal numbers', () => {
61
- const calculator = new Calculator();
62
- const result = calculator.add(0.1, 0.2);
63
- expect(result).toBeCloseTo(0.3);
64
- });
65
- });
66
-
67
- describe('divide', () => {
68
- it('should divide two numbers', () => {
69
- const calculator = new Calculator();
70
- const result = calculator.divide(10, 2);
71
- expect(result).toBe(5);
72
- });
73
-
74
- it('should throw error when dividing by zero', () => {
75
- const calculator = new Calculator();
76
- expect(() => calculator.divide(10, 0)).toThrow('Division by zero');
77
- });
78
-
79
- it('should handle decimal division', () => {
80
- const calculator = new Calculator();
81
- const result = calculator.divide(1, 3);
82
- expect(result).toBeCloseTo(0.333, 3);
83
- });
84
- });
85
- });
86
-
87
- // Step 2: GREEN - Write minimal code to make tests pass
88
- class Calculator {
89
- add(a, b) {
90
- return a + b;
91
- }
92
-
93
- divide(a, b) {
94
- if (b === 0) {
95
- throw new Error('Division by zero');
96
- }
97
- return a / b;
98
- }
99
- }
100
-
101
- // Step 3: REFACTOR - Improve code while keeping tests green
102
- class Calculator {
103
- add(a, b) {
104
- this._validateNumbers(a, b);
105
- return a + b;
106
- }
107
-
108
- subtract(a, b) {
109
- this._validateNumbers(a, b);
110
- return a - b;
111
- }
112
-
113
- multiply(a, b) {
114
- this._validateNumbers(a, b);
115
- return a * b;
116
- }
117
-
118
- divide(a, b) {
119
- this._validateNumbers(a, b);
120
- if (b === 0) {
121
- throw new Error('Division by zero');
122
- }
123
- return a / b;
124
- }
125
-
126
- _validateNumbers(...numbers) {
127
- for (const num of numbers) {
128
- if (typeof num !== 'number' || isNaN(num)) {
129
- throw new Error('Invalid number provided');
130
- }
131
- }
132
- }
133
- }
134
-
135
- // ✅ Good: TDD for User Service
136
- describe('UserService', () => {
137
- let userService;
138
- let mockRepository;
139
-
140
- beforeEach(() => {
141
- mockRepository = {
142
- findById: jest.fn(),
143
- save: jest.fn(),
144
- findByEmail: jest.fn(),
145
- };
146
- userService = new UserService(mockRepository);
147
- });
148
-
149
- describe('createUser', () => {
150
- it('should create a user with valid data', async () => {
151
- // Arrange
152
- const userData = {
153
- name: 'John Doe',
154
- email: 'john@example.com',
155
- age: 30
156
- };
157
- const expectedUser = { id: 1, ...userData };
158
-
159
- mockRepository.findByEmail.mockResolvedValue(null);
160
- mockRepository.save.mockResolvedValue(expectedUser);
161
-
162
- // Act
163
- const result = await userService.createUser(userData);
164
-
165
- // Assert
166
- expect(result).toEqual(expectedUser);
167
- expect(mockRepository.findByEmail).toHaveBeenCalledWith('john@example.com');
168
- expect(mockRepository.save).toHaveBeenCalledWith(userData);
169
- });
170
-
171
- it('should throw error if email already exists', async () => {
172
- // Arrange
173
- const userData = {
174
- name: 'John Doe',
175
- email: 'john@example.com',
176
- age: 30
177
- };
178
- const existingUser = { id: 2, ...userData };
179
-
180
- mockRepository.findByEmail.mockResolvedValue(existingUser);
181
-
182
- // Act & Assert
183
- await expect(userService.createUser(userData))
184
- .rejects
185
- .toThrow('Email already exists');
186
-
187
- expect(mockRepository.save).not.toHaveBeenCalled();
188
- });
189
-
190
- it('should validate required fields', async () => {
191
- // Arrange
192
- const invalidUserData = {
193
- name: '',
194
- email: 'john@example.com',
195
- age: 30
196
- };
197
-
198
- // Act & Assert
199
- await expect(userService.createUser(invalidUserData))
200
- .rejects
201
- .toThrow('Name is required');
202
-
203
- expect(mockRepository.findByEmail).not.toHaveBeenCalled();
204
- expect(mockRepository.save).not.toHaveBeenCalled();
205
- });
206
- });
207
- });
208
-
209
- // Implementation following TDD
210
- class UserService {
211
- constructor(repository) {
212
- this.repository = repository;
213
- }
214
-
215
- async createUser(userData) {
216
- // Validation
217
- if (!userData.name || userData.name.trim() === '') {
218
- throw new Error('Name is required');
219
- }
220
-
221
- if (!userData.email || !this._isValidEmail(userData.email)) {
222
- throw new Error('Valid email is required');
223
- }
224
-
225
- if (!userData.age || userData.age < 0) {
226
- throw new Error('Valid age is required');
227
- }
228
-
229
- // Check for existing user
230
- const existingUser = await this.repository.findByEmail(userData.email);
231
- if (existingUser) {
232
- throw new Error('Email already exists');
233
- }
234
-
235
- // Save user
236
- return await this.repository.save(userData);
237
- }
238
-
239
- _isValidEmail(email) {
240
- const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
241
- return emailRegex.test(email);
242
- }
243
- }
244
- ```
245
-
246
- ### 2. Test Organization and Structure | 测试组织和结构
247
-
248
- ```javascript
249
- // ✅ Good: Well-organized test structure
250
-
251
- // tests/unit/services/UserService.test.js
252
- describe('UserService', () => {
253
- // Setup and teardown
254
- let userService;
255
- let mockRepository;
256
- let mockEmailService;
257
- let mockLogger;
258
-
259
- beforeEach(() => {
260
- // Fresh mocks for each test
261
- mockRepository = createMockRepository();
262
- mockEmailService = createMockEmailService();
263
- mockLogger = createMockLogger();
264
-
265
- userService = new UserService(mockRepository, mockEmailService, mockLogger);
266
- });
267
-
268
- afterEach(() => {
269
- // Cleanup if needed
270
- jest.clearAllMocks();
271
- });
272
-
273
- // Group related tests
274
- describe('User Creation', () => {
275
- describe('when valid data is provided', () => {
276
- it('should create user successfully', async () => {
277
- // Test implementation
278
- });
279
-
280
- it('should send welcome email', async () => {
281
- // Test implementation
282
- });
283
-
284
- it('should log user creation', async () => {
285
- // Test implementation
286
- });
287
- });
288
-
289
- describe('when invalid data is provided', () => {
290
- it('should reject empty name', async () => {
291
- // Test implementation
292
- });
293
-
294
- it('should reject invalid email format', async () => {
295
- // Test implementation
296
- });
297
-
298
- it('should reject negative age', async () => {
299
- // Test implementation
300
- });
301
- });
302
-
303
- describe('when email already exists', () => {
304
- it('should throw appropriate error', async () => {
305
- // Test implementation
306
- });
307
-
308
- it('should not send welcome email', async () => {
309
- // Test implementation
310
- });
311
- });
312
- });
313
-
314
- describe('User Retrieval', () => {
315
- describe('when user exists', () => {
316
- it('should return user data', async () => {
317
- // Test implementation
318
- });
319
-
320
- it('should not include sensitive data', async () => {
321
- // Test implementation
322
- });
323
- });
324
-
325
- describe('when user does not exist', () => {
326
- it('should return null', async () => {
327
- // Test implementation
328
- });
329
-
330
- it('should log access attempt', async () => {
331
- // Test implementation
332
- });
333
- });
334
- });
335
- });
336
-
337
- // ✅ Good: Test helpers and utilities
338
- // tests/helpers/mockFactories.js
339
- export function createMockRepository() {
340
- return {
341
- findById: jest.fn(),
342
- findByEmail: jest.fn(),
343
- save: jest.fn(),
344
- update: jest.fn(),
345
- delete: jest.fn(),
346
- };
347
- }
348
-
349
- export function createMockEmailService() {
350
- return {
351
- sendWelcomeEmail: jest.fn(),
352
- sendPasswordResetEmail: jest.fn(),
353
- };
354
- }
355
-
356
- export function createMockLogger() {
357
- return {
358
- info: jest.fn(),
359
- warn: jest.fn(),
360
- error: jest.fn(),
361
- };
362
- }
363
-
364
- // tests/helpers/testData.js
365
- export const validUserData = {
366
- name: 'John Doe',
367
- email: 'john@example.com',
368
- age: 30,
369
- };
370
-
371
- export const invalidUserData = {
372
- emptyName: { ...validUserData, name: '' },
373
- invalidEmail: { ...validUserData, email: 'invalid-email' },
374
- negativeAge: { ...validUserData, age: -5 },
375
- };
376
-
377
- export function createUser(overrides = {}) {
378
- return {
379
- id: 1,
380
- ...validUserData,
381
- createdAt: new Date(),
382
- updatedAt: new Date(),
383
- ...overrides,
384
- };
385
- }
386
-
387
- // ✅ Good: Custom matchers for better assertions
388
- // tests/helpers/customMatchers.js
389
- expect.extend({
390
- toBeValidUser(received) {
391
- const pass = received &&
392
- typeof received.id === 'number' &&
393
- typeof received.name === 'string' &&
394
- typeof received.email === 'string' &&
395
- received.email.includes('@') &&
396
- typeof received.age === 'number' &&
397
- received.age >= 0;
398
-
399
- if (pass) {
400
- return {
401
- message: () => `expected ${received} not to be a valid user`,
402
- pass: true,
403
- };
404
- } else {
405
- return {
406
- message: () => `expected ${received} to be a valid user`,
407
- pass: false,
408
- };
409
- }
410
- },
411
-
412
- toHaveBeenCalledWithValidUser(received) {
413
- const calls = received.mock.calls;
414
- const pass = calls.some(call => {
415
- const user = call[0];
416
- return user && typeof user.name === 'string' && user.name.length > 0;
417
- });
418
-
419
- return {
420
- message: () => pass
421
- ? `expected function not to have been called with valid user`
422
- : `expected function to have been called with valid user`,
423
- pass,
424
- };
425
- },
426
- });
427
- ```
428
-
429
- ## Mocking and Test Doubles | 模拟和测试替身
430
-
431
- ### 1. Mocking Strategies | 模拟策略
432
-
433
- ```javascript
434
- // ✅ Good: Different types of test doubles
435
-
436
- // Dummy - objects passed around but never used
437
- class DummyLogger {
438
- info() {}
439
- warn() {}
440
- error() {}
441
- }
442
-
443
- // Fake - working implementation with shortcuts
444
- class FakeUserRepository {
445
- constructor() {
446
- this.users = new Map();
447
- this.nextId = 1;
448
- }
449
-
450
- async save(user) {
451
- const id = this.nextId++;
452
- const savedUser = { ...user, id };
453
- this.users.set(id, savedUser);
454
- return savedUser;
455
- }
456
-
457
- async findById(id) {
458
- return this.users.get(id) || null;
459
- }
460
-
461
- async findByEmail(email) {
462
- for (const user of this.users.values()) {
463
- if (user.email === email) {
464
- return user;
465
- }
466
- }
467
- return null;
468
- }
469
-
470
- clear() {
471
- this.users.clear();
472
- this.nextId = 1;
473
- }
474
- }
475
-
476
- // Stub - provides canned answers
477
- class StubEmailService {
478
- constructor(shouldSucceed = true) {
479
- this.shouldSucceed = shouldSucceed;
480
- this.sentEmails = [];
481
- }
482
-
483
- async sendWelcomeEmail(user) {
484
- this.sentEmails.push({
485
- to: user.email,
486
- type: 'welcome',
487
- timestamp: new Date(),
488
- });
489
-
490
- if (!this.shouldSucceed) {
491
- throw new Error('Email service unavailable');
492
- }
493
-
494
- return { messageId: 'fake-message-id' };
495
- }
496
-
497
- getSentEmails() {
498
- return [...this.sentEmails];
499
- }
500
- }
501
-
502
- // Mock - objects with expectations
503
- describe('UserService with different test doubles', () => {
504
- describe('using Fake repository', () => {
505
- let userService;
506
- let fakeRepository;
507
-
508
- beforeEach(() => {
509
- fakeRepository = new FakeUserRepository();
510
- userService = new UserService(fakeRepository, new DummyLogger());
511
- });
512
-
513
- afterEach(() => {
514
- fakeRepository.clear();
515
- });
516
-
517
- it('should persist user data', async () => {
518
- const userData = { name: 'John', email: 'john@example.com', age: 30 };
519
-
520
- const createdUser = await userService.createUser(userData);
521
- const retrievedUser = await userService.getUserById(createdUser.id);
522
-
523
- expect(retrievedUser).toEqual(createdUser);
524
- });
525
- });
526
-
527
- describe('using Stub email service', () => {
528
- let userService;
529
- let stubEmailService;
530
-
531
- beforeEach(() => {
532
- stubEmailService = new StubEmailService();
533
- userService = new UserService(
534
- new FakeUserRepository(),
535
- stubEmailService,
536
- new DummyLogger()
537
- );
538
- });
539
-
540
- it('should send welcome email on user creation', async () => {
541
- const userData = { name: 'John', email: 'john@example.com', age: 30 };
542
-
543
- await userService.createUser(userData);
544
-
545
- const sentEmails = stubEmailService.getSentEmails();
546
- expect(sentEmails).toHaveLength(1);
547
- expect(sentEmails[0].to).toBe('john@example.com');
548
- expect(sentEmails[0].type).toBe('welcome');
549
- });
550
- });
551
-
552
- describe('using Mock with Jest', () => {
553
- let userService;
554
- let mockRepository;
555
- let mockEmailService;
556
-
557
- beforeEach(() => {
558
- mockRepository = {
559
- save: jest.fn(),
560
- findById: jest.fn(),
561
- findByEmail: jest.fn(),
562
- };
563
-
564
- mockEmailService = {
565
- sendWelcomeEmail: jest.fn(),
566
- };
567
-
568
- userService = new UserService(mockRepository, mockEmailService);
569
- });
570
-
571
- it('should call repository and email service with correct parameters', async () => {
572
- const userData = { name: 'John', email: 'john@example.com', age: 30 };
573
- const savedUser = { id: 1, ...userData };
574
-
575
- mockRepository.findByEmail.mockResolvedValue(null);
576
- mockRepository.save.mockResolvedValue(savedUser);
577
- mockEmailService.sendWelcomeEmail.mockResolvedValue({ messageId: 'test' });
578
-
579
- await userService.createUser(userData);
580
-
581
- expect(mockRepository.findByEmail).toHaveBeenCalledWith('john@example.com');
582
- expect(mockRepository.save).toHaveBeenCalledWith(userData);
583
- expect(mockEmailService.sendWelcomeEmail).toHaveBeenCalledWith(savedUser);
584
- });
585
- });
586
- });
587
-
588
- // ✅ Good: Mocking external dependencies
589
- describe('WeatherService', () => {
590
- let weatherService;
591
- let mockHttpClient;
592
-
593
- beforeEach(() => {
594
- mockHttpClient = {
595
- get: jest.fn(),
596
- };
597
- weatherService = new WeatherService(mockHttpClient);
598
- });
599
-
600
- it('should fetch weather data from API', async () => {
601
- const mockWeatherData = {
602
- temperature: 25,
603
- humidity: 60,
604
- conditions: 'sunny',
605
- };
606
-
607
- mockHttpClient.get.mockResolvedValue({
608
- data: mockWeatherData,
609
- status: 200,
610
- });
611
-
612
- const result = await weatherService.getCurrentWeather('New York');
613
-
614
- expect(mockHttpClient.get).toHaveBeenCalledWith(
615
- 'https://api.weather.com/current',
616
- { params: { city: 'New York' } }
617
- );
618
- expect(result).toEqual(mockWeatherData);
619
- });
620
-
621
- it('should handle API errors gracefully', async () => {
622
- mockHttpClient.get.mockRejectedValue(new Error('Network error'));
623
-
624
- await expect(weatherService.getCurrentWeather('New York'))
625
- .rejects
626
- .toThrow('Failed to fetch weather data');
627
- });
628
-
629
- it('should retry on temporary failures', async () => {
630
- mockHttpClient.get
631
- .mockRejectedValueOnce(new Error('Temporary error'))
632
- .mockRejectedValueOnce(new Error('Temporary error'))
633
- .mockResolvedValue({ data: { temperature: 20 }, status: 200 });
634
-
635
- const result = await weatherService.getCurrentWeather('London');
636
-
637
- expect(mockHttpClient.get).toHaveBeenCalledTimes(3);
638
- expect(result.temperature).toBe(20);
639
- });
640
- });
641
- ```
642
-
643
- ### 2. Integration Testing | 集成测试
644
-
645
- ```javascript
646
- // ✅ Good: Integration tests with real dependencies
647
-
648
- // tests/integration/UserService.integration.test.js
649
- describe('UserService Integration Tests', () => {
650
- let userService;
651
- let database;
652
- let emailService;
653
-
654
- beforeAll(async () => {
655
- // Setup test database
656
- database = await setupTestDatabase();
657
- emailService = new EmailService({
658
- provider: 'test',
659
- apiKey: 'test-key',
660
- });
661
-
662
- userService = new UserService(
663
- new UserRepository(database),
664
- emailService,
665
- new Logger({ level: 'silent' })
666
- );
667
- });
668
-
669
- afterAll(async () => {
670
- await teardownTestDatabase(database);
671
- });
672
-
673
- beforeEach(async () => {
674
- await clearTestData(database);
675
- });
676
-
677
- describe('User lifecycle', () => {
678
- it('should handle complete user creation flow', async () => {
679
- const userData = {
680
- name: 'Integration Test User',
681
- email: 'integration@test.com',
682
- age: 25,
683
- };
684
-
685
- // Create user
686
- const createdUser = await userService.createUser(userData);
687
- expect(createdUser.id).toBeDefined();
688
- expect(createdUser.name).toBe(userData.name);
689
-
690
- // Verify user exists in database
691
- const retrievedUser = await userService.getUserById(createdUser.id);
692
- expect(retrievedUser).toEqual(createdUser);
693
-
694
- // Verify email was sent
695
- const sentEmails = await emailService.getSentEmails();
696
- expect(sentEmails).toHaveLength(1);
697
- expect(sentEmails[0].to).toBe(userData.email);
698
- });
699
-
700
- it('should handle user update flow', async () => {
701
- // Create user first
702
- const user = await userService.createUser({
703
- name: 'Original Name',
704
- email: 'original@test.com',
705
- age: 30,
706
- });
707
-
708
- // Update user
709
- const updatedData = {
710
- name: 'Updated Name',
711
- age: 31,
712
- };
713
-
714
- const updatedUser = await userService.updateUser(user.id, updatedData);
715
-
716
- expect(updatedUser.name).toBe('Updated Name');
717
- expect(updatedUser.age).toBe(31);
718
- expect(updatedUser.email).toBe('original@test.com'); // Unchanged
719
-
720
- // Verify in database
721
- const retrievedUser = await userService.getUserById(user.id);
722
- expect(retrievedUser.name).toBe('Updated Name');
723
- });
724
- });
725
-
726
- describe('Error scenarios', () => {
727
- it('should handle database connection failures', async () => {
728
- // Simulate database failure
729
- await database.close();
730
-
731
- await expect(userService.createUser({
732
- name: 'Test User',
733
- email: 'test@example.com',
734
- age: 25,
735
- })).rejects.toThrow('Database connection failed');
736
-
737
- // Restore connection for cleanup
738
- database = await setupTestDatabase();
739
- });
740
- });
741
- });
742
-
743
- // ✅ Good: API integration tests
744
- describe('User API Integration', () => {
745
- let app;
746
- let server;
747
- let database;
748
-
749
- beforeAll(async () => {
750
- database = await setupTestDatabase();
751
- app = createApp({ database });
752
- server = app.listen(0); // Random port
753
- });
754
-
755
- afterAll(async () => {
756
- await server.close();
757
- await teardownTestDatabase(database);
758
- });
759
-
760
- beforeEach(async () => {
761
- await clearTestData(database);
762
- });
763
-
764
- describe('POST /users', () => {
765
- it('should create user via API', async () => {
766
- const userData = {
767
- name: 'API Test User',
768
- email: 'api@test.com',
769
- age: 28,
770
- };
771
-
772
- const response = await request(app)
773
- .post('/users')
774
- .send(userData)
775
- .expect(201);
776
-
777
- expect(response.body.user.name).toBe(userData.name);
778
- expect(response.body.user.id).toBeDefined();
779
-
780
- // Verify in database
781
- const user = await database.users.findById(response.body.user.id);
782
- expect(user).toBeTruthy();
783
- });
784
-
785
- it('should return validation errors', async () => {
786
- const invalidData = {
787
- name: '',
788
- email: 'invalid-email',
789
- age: -5,
790
- };
791
-
792
- const response = await request(app)
793
- .post('/users')
794
- .send(invalidData)
795
- .expect(400);
796
-
797
- expect(response.body.errors).toHaveLength(3);
798
- expect(response.body.errors).toContainEqual({
799
- field: 'name',
800
- message: 'Name is required',
801
- });
802
- });
803
- });
804
-
805
- describe('GET /users/:id', () => {
806
- it('should retrieve user by ID', async () => {
807
- // Create user first
808
- const user = await database.users.create({
809
- name: 'Retrieve Test User',
810
- email: 'retrieve@test.com',
811
- age: 35,
812
- });
813
-
814
- const response = await request(app)
815
- .get(`/users/${user.id}`)
816
- .expect(200);
817
-
818
- expect(response.body.user.name).toBe(user.name);
819
- expect(response.body.user.email).toBe(user.email);
820
- });
821
-
822
- it('should return 404 for non-existent user', async () => {
823
- const response = await request(app)
824
- .get('/users/999999')
825
- .expect(404);
826
-
827
- expect(response.body.error).toBe('User not found');
828
- });
829
- });
830
- });
831
- ```
832
-
833
- ## Test Coverage and Quality | 测试覆盖率和质量
834
-
835
- ### 1. Coverage Strategies | 覆盖率策略
836
-
837
- ```javascript
838
- // ✅ Good: Comprehensive test coverage
839
-
840
- // jest.config.js
841
- module.exports = {
842
- collectCoverage: true,
843
- coverageDirectory: 'coverage',
844
- coverageReporters: ['text', 'lcov', 'html'],
845
- coverageThreshold: {
846
- global: {
847
- branches: 80,
848
- functions: 80,
849
- lines: 80,
850
- statements: 80,
851
- },
852
- './src/services/': {
853
- branches: 90,
854
- functions: 90,
855
- lines: 90,
856
- statements: 90,
857
- },
858
- },
859
- collectCoverageFrom: [
860
- 'src/**/*.{js,jsx}',
861
- '!src/**/*.test.{js,jsx}',
862
- '!src/index.js',
863
- '!src/config/*.js',
864
- ],
865
- };
866
-
867
- // ✅ Good: Testing edge cases and error paths
868
- describe('PaymentProcessor', () => {
869
- let paymentProcessor;
870
- let mockPaymentGateway;
871
-
872
- beforeEach(() => {
873
- mockPaymentGateway = {
874
- processPayment: jest.fn(),
875
- refundPayment: jest.fn(),
876
- };
877
- paymentProcessor = new PaymentProcessor(mockPaymentGateway);
878
- });
879
-
880
- describe('processPayment', () => {
881
- // Happy path
882
- it('should process valid payment successfully', async () => {
883
- const paymentData = {
884
- amount: 100.00,
885
- currency: 'USD',
886
- cardNumber: '4111111111111111',
887
- expiryMonth: 12,
888
- expiryYear: 2025,
889
- cvv: '123',
890
- };
891
-
892
- mockPaymentGateway.processPayment.mockResolvedValue({
893
- transactionId: 'txn_123',
894
- status: 'success',
895
- });
896
-
897
- const result = await paymentProcessor.processPayment(paymentData);
898
-
899
- expect(result.success).toBe(true);
900
- expect(result.transactionId).toBe('txn_123');
901
- });
902
-
903
- // Edge cases
904
- it('should handle minimum payment amount', async () => {
905
- const paymentData = {
906
- amount: 0.01, // Minimum amount
907
- currency: 'USD',
908
- cardNumber: '4111111111111111',
909
- expiryMonth: 12,
910
- expiryYear: 2025,
911
- cvv: '123',
912
- };
913
-
914
- mockPaymentGateway.processPayment.mockResolvedValue({
915
- transactionId: 'txn_124',
916
- status: 'success',
917
- });
918
-
919
- const result = await paymentProcessor.processPayment(paymentData);
920
- expect(result.success).toBe(true);
921
- });
922
-
923
- it('should reject zero amount', async () => {
924
- const paymentData = {
925
- amount: 0,
926
- currency: 'USD',
927
- cardNumber: '4111111111111111',
928
- expiryMonth: 12,
929
- expiryYear: 2025,
930
- cvv: '123',
931
- };
932
-
933
- await expect(paymentProcessor.processPayment(paymentData))
934
- .rejects
935
- .toThrow('Amount must be greater than zero');
936
- });
937
-
938
- it('should handle expired card', async () => {
939
- const paymentData = {
940
- amount: 100.00,
941
- currency: 'USD',
942
- cardNumber: '4111111111111111',
943
- expiryMonth: 1,
944
- expiryYear: 2020, // Expired
945
- cvv: '123',
946
- };
947
-
948
- await expect(paymentProcessor.processPayment(paymentData))
949
- .rejects
950
- .toThrow('Card has expired');
951
- });
952
-
953
- // Error paths
954
- it('should handle gateway timeout', async () => {
955
- const paymentData = {
956
- amount: 100.00,
957
- currency: 'USD',
958
- cardNumber: '4111111111111111',
959
- expiryMonth: 12,
960
- expiryYear: 2025,
961
- cvv: '123',
962
- };
963
-
964
- mockPaymentGateway.processPayment.mockRejectedValue(
965
- new Error('Gateway timeout')
966
- );
967
-
968
- const result = await paymentProcessor.processPayment(paymentData);
969
-
970
- expect(result.success).toBe(false);
971
- expect(result.error).toBe('Payment processing failed');
972
- });
973
-
974
- it('should handle insufficient funds', async () => {
975
- const paymentData = {
976
- amount: 100.00,
977
- currency: 'USD',
978
- cardNumber: '4000000000000002', // Declined card
979
- expiryMonth: 12,
980
- expiryYear: 2025,
981
- cvv: '123',
982
- };
983
-
984
- mockPaymentGateway.processPayment.mockResolvedValue({
985
- status: 'declined',
986
- reason: 'insufficient_funds',
987
- });
988
-
989
- const result = await paymentProcessor.processPayment(paymentData);
990
-
991
- expect(result.success).toBe(false);
992
- expect(result.reason).toBe('insufficient_funds');
993
- });
994
-
995
- // Boundary conditions
996
- it('should handle maximum payment amount', async () => {
997
- const paymentData = {
998
- amount: 999999.99, // Maximum amount
999
- currency: 'USD',
1000
- cardNumber: '4111111111111111',
1001
- expiryMonth: 12,
1002
- expiryYear: 2025,
1003
- cvv: '123',
1004
- };
1005
-
1006
- mockPaymentGateway.processPayment.mockResolvedValue({
1007
- transactionId: 'txn_125',
1008
- status: 'success',
1009
- });
1010
-
1011
- const result = await paymentProcessor.processPayment(paymentData);
1012
- expect(result.success).toBe(true);
1013
- });
1014
-
1015
- it('should reject amount exceeding maximum', async () => {
1016
- const paymentData = {
1017
- amount: 1000000.00, // Exceeds maximum
1018
- currency: 'USD',
1019
- cardNumber: '4111111111111111',
1020
- expiryMonth: 12,
1021
- expiryYear: 2025,
1022
- cvv: '123',
1023
- };
1024
-
1025
- await expect(paymentProcessor.processPayment(paymentData))
1026
- .rejects
1027
- .toThrow('Amount exceeds maximum limit');
1028
- });
1029
- });
1030
- });
1031
-
1032
- // ✅ Good: Property-based testing for comprehensive coverage
1033
- const fc = require('fast-check');
1034
-
1035
- describe('StringUtils', () => {
1036
- describe('reverse', () => {
1037
- it('should reverse any string correctly', () => {
1038
- fc.assert(fc.property(fc.string(), (str) => {
1039
- const reversed = StringUtils.reverse(str);
1040
- const doubleReversed = StringUtils.reverse(reversed);
1041
- return doubleReversed === str;
1042
- }));
1043
- });
1044
-
1045
- it('should maintain string length', () => {
1046
- fc.assert(fc.property(fc.string(), (str) => {
1047
- const reversed = StringUtils.reverse(str);
1048
- return reversed.length === str.length;
1049
- }));
1050
- });
1051
- });
1052
-
1053
- describe('isPalindrome', () => {
1054
- it('should correctly identify palindromes', () => {
1055
- fc.assert(fc.property(fc.string(), (str) => {
1056
- const palindrome = str + StringUtils.reverse(str);
1057
- return StringUtils.isPalindrome(palindrome);
1058
- }));
1059
- });
1060
- });
1061
- });
1062
- ```
1063
-
1064
- ### 2. Performance and Load Testing | 性能和负载测试
1065
-
1066
- ```javascript
1067
- // ✅ Good: Performance testing
1068
- describe('Performance Tests', () => {
1069
- describe('UserService', () => {
1070
- let userService;
1071
-
1072
- beforeEach(() => {
1073
- userService = new UserService(new FakeUserRepository());
1074
- });
1075
-
1076
- it('should handle bulk user creation efficiently', async () => {
1077
- const startTime = Date.now();
1078
- const userPromises = [];
1079
-
1080
- // Create 1000 users concurrently
1081
- for (let i = 0; i < 1000; i++) {
1082
- userPromises.push(userService.createUser({
1083
- name: `User ${i}`,
1084
- email: `user${i}@example.com`,
1085
- age: 20 + (i % 50),
1086
- }));
1087
- }
1088
-
1089
- await Promise.all(userPromises);
1090
- const endTime = Date.now();
1091
- const duration = endTime - startTime;
1092
-
1093
- // Should complete within 5 seconds
1094
- expect(duration).toBeLessThan(5000);
1095
- });
1096
-
1097
- it('should maintain performance with large datasets', async () => {
1098
- // Pre-populate with 10,000 users
1099
- const users = [];
1100
- for (let i = 0; i < 10000; i++) {
1101
- users.push({
1102
- name: `User ${i}`,
1103
- email: `user${i}@example.com`,
1104
- age: 20 + (i % 50),
1105
- });
1106
- }
1107
-
1108
- await Promise.all(users.map(user => userService.createUser(user)));
1109
-
1110
- // Test search performance
1111
- const startTime = Date.now();
1112
- const results = await userService.searchUsers('User 5000');
1113
- const endTime = Date.now();
1114
-
1115
- expect(results.length).toBeGreaterThan(0);
1116
- expect(endTime - startTime).toBeLessThan(100); // Should be fast
1117
- });
1118
- });
1119
- });
1120
-
1121
- // ✅ Good: Memory leak testing
1122
- describe('Memory Tests', () => {
1123
- it('should not leak memory during repeated operations', async () => {
1124
- const initialMemory = process.memoryUsage().heapUsed;
1125
- const userService = new UserService(new FakeUserRepository());
1126
-
1127
- // Perform many operations
1128
- for (let i = 0; i < 1000; i++) {
1129
- const user = await userService.createUser({
1130
- name: `User ${i}`,
1131
- email: `user${i}@example.com`,
1132
- age: 25,
1133
- });
1134
-
1135
- await userService.getUserById(user.id);
1136
- await userService.updateUser(user.id, { age: 26 });
1137
- await userService.deleteUser(user.id);
1138
-
1139
- // Force garbage collection periodically
1140
- if (i % 100 === 0 && global.gc) {
1141
- global.gc();
1142
- }
1143
- }
1144
-
1145
- // Force final garbage collection
1146
- if (global.gc) {
1147
- global.gc();
1148
- }
1149
-
1150
- const finalMemory = process.memoryUsage().heapUsed;
1151
- const memoryIncrease = finalMemory - initialMemory;
1152
-
1153
- // Memory increase should be reasonable (less than 10MB)
1154
- expect(memoryIncrease).toBeLessThan(10 * 1024 * 1024);
1155
- });
1156
- });
1157
- ```
1158
-
1159
- ## Testing Anti-Patterns | 测试反模式
1160
-
1161
- ### 1. Common Testing Mistakes | 常见测试错误
1162
-
1163
- ```javascript
1164
- // ❌ Bad: Testing implementation details
1165
- describe('UserService - Bad Examples', () => {
1166
- it('should call _validateEmail method', async () => {
1167
- const userService = new UserService();
1168
- const spy = jest.spyOn(userService, '_validateEmail');
1169
-
1170
- await userService.createUser({
1171
- name: 'John',
1172
- email: 'john@example.com',
1173
- age: 30,
1174
- });
1175
-
1176
- expect(spy).toHaveBeenCalled(); // Testing private method
1177
- });
1178
-
1179
- // ✅ Good: Test behavior, not implementation
1180
- it('should reject invalid email addresses', async () => {
1181
- const userService = new UserService();
1182
-
1183
- await expect(userService.createUser({
1184
- name: 'John',
1185
- email: 'invalid-email',
1186
- age: 30,
1187
- })).rejects.toThrow('Invalid email address');
1188
- });
1189
- });
1190
-
1191
- // ❌ Bad: Fragile tests that break with minor changes
1192
- describe('UserComponent - Bad Examples', () => {
1193
- it('should have specific DOM structure', () => {
1194
- const wrapper = mount(<UserComponent user={mockUser} />);
1195
-
1196
- expect(wrapper.find('div').at(0).hasClass('user-container')).toBe(true);
1197
- expect(wrapper.find('span').at(2).text()).toBe(mockUser.name);
1198
- expect(wrapper.find('button').at(1).prop('onClick')).toBeDefined();
1199
- });
1200
-
1201
- // ✅ Good: Test user-visible behavior
1202
- it('should display user information and allow editing', () => {
1203
- const mockUser = { name: 'John Doe', email: 'john@example.com' };
1204
- const onEdit = jest.fn();
1205
-
1206
- const wrapper = mount(<UserComponent user={mockUser} onEdit={onEdit} />);
1207
-
1208
- expect(wrapper.text()).toContain('John Doe');
1209
- expect(wrapper.text()).toContain('john@example.com');
1210
-
1211
- wrapper.find('[data-testid="edit-button"]').simulate('click');
1212
- expect(onEdit).toHaveBeenCalledWith(mockUser);
1213
- });
1214
- });
1215
-
1216
- // ❌ Bad: Tests that depend on each other
1217
- describe('UserService - Bad Test Dependencies', () => {
1218
- let createdUserId;
1219
-
1220
- it('should create a user', async () => {
1221
- const user = await userService.createUser({
1222
- name: 'John',
1223
- email: 'john@example.com',
1224
- age: 30,
1225
- });
1226
- createdUserId = user.id; // Storing state between tests
1227
- });
1228
-
1229
- it('should retrieve the created user', async () => {
1230
- const user = await userService.getUserById(createdUserId); // Depends on previous test
1231
- expect(user.name).toBe('John');
1232
- });
1233
-
1234
- // ✅ Good: Independent tests
1235
- describe('UserService - Good Independent Tests', () => {
1236
- it('should create a user', async () => {
1237
- const user = await userService.createUser({
1238
- name: 'John',
1239
- email: 'john@example.com',
1240
- age: 30,
1241
- });
1242
- expect(user.id).toBeDefined();
1243
- expect(user.name).toBe('John');
1244
- });
1245
-
1246
- it('should retrieve a user by ID', async () => {
1247
- // Setup for this specific test
1248
- const createdUser = await userService.createUser({
1249
- name: 'Jane',
1250
- email: 'jane@example.com',
1251
- age: 25,
1252
- });
1253
-
1254
- const retrievedUser = await userService.getUserById(createdUser.id);
1255
- expect(retrievedUser.name).toBe('Jane');
1256
- });
1257
- });
1258
- });
1259
-
1260
- // ❌ Bad: Over-mocking
1261
- describe('OrderService - Over-mocked', () => {
1262
- it('should calculate total price', () => {
1263
- const mockItem1 = { getPrice: jest.fn().mockReturnValue(10) };
1264
- const mockItem2 = { getPrice: jest.fn().mockReturnValue(20) };
1265
- const mockItems = [mockItem1, mockItem2];
1266
-
1267
- const total = OrderService.calculateTotal(mockItems);
1268
-
1269
- expect(total).toBe(30);
1270
- expect(mockItem1.getPrice).toHaveBeenCalled();
1271
- expect(mockItem2.getPrice).toHaveBeenCalled();
1272
- });
1273
-
1274
- // ✅ Good: Use real objects when possible
1275
- it('should calculate total price with real items', () => {
1276
- const items = [
1277
- new Item('Product 1', 10),
1278
- new Item('Product 2', 20),
1279
- ];
1280
-
1281
- const total = OrderService.calculateTotal(items);
1282
- expect(total).toBe(30);
1283
- });
1284
- });
1285
- ```
1286
-
1287
- ## Testing Checklist | 测试检查清单
1288
-
1289
- - [ ] Tests follow the AAA pattern (Arrange, Act, Assert)
1290
- - [ ] Each test has a clear, descriptive name
1291
- - [ ] Tests are independent and can run in any order
1292
- - [ ] Happy path, edge cases, and error scenarios are covered
1293
- - [ ] Mocks are used appropriately (not over-mocked)
1294
- - [ ] Test data is realistic and representative
1295
- - [ ] Tests focus on behavior, not implementation details
1296
- - [ ] Code coverage meets established thresholds
1297
- - [ ] Integration tests cover critical user journeys
1298
- - [ ] Performance tests validate non-functional requirements
1299
- - [ ] Tests are maintainable and easy to understand
1300
- - [ ] Flaky tests are identified and fixed
1301
-
1302
- ## 测试检查清单
1303
-
1304
- - [ ] 测试遵循 AAA 模式(准备、执行、断言)
1305
- - [ ] 每个测试都有清晰、描述性的名称
1306
- - [ ] 测试独立且可以任意顺序运行
1307
- - [ ] 覆盖正常路径、边界情况和错误场景
1308
- - [ ] 适当使用模拟(不过度模拟)
1309
- - [ ] 测试数据真实且具有代表性
1310
- - [ ] 测试关注行为,而非实现细节
1311
- - [ ] 代码覆盖率达到既定阈值
1312
- - [ ] 集成测试覆盖关键用户旅程
1313
- - [ ] 性能测试验证非功能性需求
1314
- - [ ] 测试可维护且易于理解
1315
- - [ ] 识别并修复不稳定的测试