@ohos-cpf/3rdloop 0.0.2 → 0.0.3

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 (393) hide show
  1. package/README.md +244 -244
  2. package/bin/3rdloop.mjs +46 -46
  3. package/lib/cli.js +781 -781
  4. package/lib/config-cmd.js +451 -451
  5. package/lib/config.js +318 -318
  6. package/lib/doctor.js +113 -113
  7. package/lib/exit-codes.js +30 -30
  8. package/lib/opencode.js +155 -155
  9. package/lib/orch.js +426 -426
  10. package/lib/queries.js +263 -263
  11. package/lib/step.js +325 -325
  12. package/lib/ui.js +222 -222
  13. package/lib/update.js +279 -279
  14. package/lib/workflow.js +308 -308
  15. package/lib/workflows.js +131 -131
  16. package/package.json +50 -50
  17. package/vendor/Server/Agent/SkillSelector/README.md +343 -343
  18. package/vendor/Server/Agent/SkillSelector/core/Agent.js +207 -207
  19. package/vendor/Server/Agent/SkillSelector/index.js +14 -14
  20. package/vendor/Server/Agent/SkillSelector/llm/llmClient.js +313 -313
  21. package/vendor/Server/Agent/SkillSelector/llm/prompts.js +161 -161
  22. package/vendor/Server/Agent/SkillSelector/llm/reactSteps.js +144 -144
  23. package/vendor/Server/Agent/SkillSelector/matcher/fuzzyMatcher.js +433 -433
  24. package/vendor/Server/Agent/SkillSelector/scanner/skillScanner.js +382 -382
  25. package/vendor/Server/Agent/SkillSelector/utils/actionWords.js +59 -59
  26. package/vendor/Server/Brain/AnalysisStrategies.js +422 -422
  27. package/vendor/Server/Brain/Brain.js +686 -686
  28. package/vendor/Server/Brain/DecompositionStrategies.js +621 -621
  29. package/vendor/Server/Brain/PlanPersistence.js +196 -196
  30. package/vendor/Server/Brain/SkillExecutor.js +251 -251
  31. package/vendor/Server/Brain/index.js +11 -11
  32. package/vendor/Server/CLI/cli.js +275 -275
  33. package/vendor/Server/CLI/deveco-code/index.js +71 -71
  34. package/vendor/Server/CLI/deveco-code.js +5 -5
  35. package/vendor/Server/CLI/opencode/index.js +817 -818
  36. package/vendor/Server/CLI/opencode.js +5 -5
  37. package/vendor/Server/DbUse/MessageArchive.js +61 -61
  38. package/vendor/Server/DbUse/StorageManager.js +107 -107
  39. package/vendor/Server/DbUse/adapters/BaseAdapter.js +94 -94
  40. package/vendor/Server/DbUse/adapters/FileAdapter.js +138 -138
  41. package/vendor/Server/DbUse/adapters/JsonAdapter.js +138 -138
  42. package/vendor/Server/DbUse/adapters/JsonlAdapter.js +114 -114
  43. package/vendor/Server/DbUse/adapters/SqliteAdapter.js +157 -157
  44. package/vendor/Server/DbUse/index.js +160 -160
  45. package/vendor/Server/DbUse/stores/SessionStore.js +279 -279
  46. package/vendor/Server/DbUse/stores/TaskExecutionStore.js +133 -133
  47. package/vendor/Server/DbUse/stores/TaskRegistryStore.js +262 -262
  48. package/vendor/Server/DbUse/stores/TaskStepStore.js +279 -279
  49. package/vendor/Server/FlexRunner/FlexRunner.js +1759 -1759
  50. package/vendor/Server/FlexRunner/index.js +12 -12
  51. package/vendor/Server/Knowledge/KnowledgeImporter.js +523 -523
  52. package/vendor/Server/Knowledge/KnowledgeManager.js +341 -341
  53. package/vendor/Server/Knowledge/index.js +33 -33
  54. package/vendor/Server/LoopEngine/LoopEngine.js +1133 -1133
  55. package/vendor/Server/LoopEngine/index.js +11 -11
  56. package/vendor/Server/Orchestrator/Orchestrator.js +0 -3
  57. package/vendor/Server/Orchestrator/StepNode.js +312 -312
  58. package/vendor/Server/Orchestrator/index.js +13 -13
  59. package/vendor/Server/Routes/controllers/BrainController.js +241 -241
  60. package/vendor/Server/Routes/controllers/FlexRunnerController.js +1125 -1125
  61. package/vendor/Server/Routes/controllers/HealthController.js +44 -44
  62. package/vendor/Server/Routes/controllers/KnowledgeImportController.js +355 -355
  63. package/vendor/Server/Routes/controllers/LoopEngineController.js +788 -788
  64. package/vendor/Server/Routes/controllers/StatsController.js +57 -57
  65. package/vendor/Server/Routes/controllers/StreamController.js +67 -67
  66. package/vendor/Server/Routes/library/logger.js +179 -179
  67. package/vendor/Server/Routes/library/zipArchive.js +172 -172
  68. package/vendor/Server/Routes/router/Router.js +204 -204
  69. package/vendor/Server/Routes/routes/brain.js +47 -47
  70. package/vendor/Server/Routes/routes/flexrunner.js +72 -72
  71. package/vendor/Server/Routes/routes/health.js +28 -28
  72. package/vendor/Server/Routes/routes/index.js +57 -57
  73. package/vendor/Server/Routes/routes/knowledge.js +55 -55
  74. package/vendor/Server/Routes/routes/loopengine.js +58 -58
  75. package/vendor/Server/Routes/routes/orchestrator.js +61 -61
  76. package/vendor/Server/Routes/routes/registry.js +97 -97
  77. package/vendor/Server/Routes/routes/stats.js +23 -23
  78. package/vendor/Server/Routes/routes/stream.js +30 -30
  79. package/vendor/Server/Routes/server.js +203 -203
  80. package/vendor/Server/Routes/sse/SseHub.js +308 -308
  81. package/vendor/Server/Skills/acceptance-check/SKILL.md +191 -191
  82. package/vendor/Server/Skills/acceptance-check/references/PHASE1_ARTIFACT_COLLECTION.md +52 -52
  83. package/vendor/Server/Skills/acceptance-check/references/PHASE2_CRITERIA_EVALUATION.md +77 -77
  84. package/vendor/Server/Skills/acceptance-check/references/PHASE2_EVIDENCE_VERIFICATION.md +70 -70
  85. package/vendor/Server/Skills/arkts-code-check/SKILL.md +320 -320
  86. package/vendor/Server/Skills/arkts-code-check/references/CODE_CHECK_GUIDE.md +210 -210
  87. package/vendor/Server/Skills/arkts-code-check/references/FILE_TYPE_GUIDE.md +28 -28
  88. package/vendor/Server/Skills/arkts-code-check/references/PHASE1_INFO_COLLECTION.md +233 -233
  89. package/vendor/Server/Skills/arkts-code-check/references/REPORT_TEMPLATE.md +219 -219
  90. package/vendor/Server/Skills/arkts-library-compile-validate/SKILL.md +328 -328
  91. package/vendor/Server/Skills/arkts-library-compile-validate/scripts/build.ps1 +93 -93
  92. package/vendor/Server/Skills/arkts-library-compile-validate/scripts/code-linter.cjs +432 -432
  93. package/vendor/Server/Skills/arkts-library-compile-validate/scripts/migrate.cjs +851 -851
  94. package/vendor/Server/Skills/arkts-library-compile-validate/scripts/ohpm-switch.cjs +788 -788
  95. package/vendor/Server/Skills/arkts-library-demo-code/SKILL.md +291 -291
  96. package/vendor/Server/Skills/arkts-library-demo-code/references/API_SIGNATURE_CHECKS.md +68 -68
  97. package/vendor/Server/Skills/arkts-library-demo-code/references/BUILD_VALIDATION.md +184 -184
  98. package/vendor/Server/Skills/arkts-library-demo-code/references/CODE_STANDARDS.md +337 -337
  99. package/vendor/Server/Skills/arkts-library-demo-code/references/EXAMPLES.md +400 -400
  100. package/vendor/Server/Skills/arkts-library-demo-code/references/SYSTEM_API_LOOKUP.md +98 -98
  101. package/vendor/Server/Skills/arkts-library-demo-code/references/TEMPLATE.md +544 -544
  102. package/vendor/Server/Skills/arkts-library-demo-code/scripts/build.ps1 +93 -93
  103. package/vendor/Server/Skills/arkts-library-demo-code/scripts/code-linter.cjs +432 -432
  104. package/vendor/Server/Skills/arkts-library-demo-code/scripts/migrate.cjs +851 -851
  105. package/vendor/Server/Skills/arkts-library-demo-code/scripts/ohpm-switch.cjs +788 -788
  106. package/vendor/Server/Skills/arkts-library-demo-coverage/SKILL.md +174 -174
  107. package/vendor/Server/Skills/arkts-library-demo-scenario/SKILL.md +321 -321
  108. package/vendor/Server/Skills/arkts-library-demo-scenario/references/EXAMPLES.md +100 -100
  109. package/vendor/Server/Skills/arkts-library-demo-scenario/references/TEMPLATE.md +185 -185
  110. package/vendor/Server/Skills/arkts-library-documentation-quality-check/SKILL.md +233 -233
  111. package/vendor/Server/Skills/arkts-library-documentation-quality-check/assets/REPORT_TEMPLATE.md +102 -102
  112. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/CHECK_DIMENSIONS.md +89 -89
  113. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/COMPLIANCE_CHECKLIST.md +62 -62
  114. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/KB_QUERY_GUIDE.md +107 -107
  115. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/MCP_TOOL_DISCOVERY.md +124 -124
  116. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/REPORT_TEMPLATE.md +90 -90
  117. package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/SCORING_FORMULA.md +57 -57
  118. package/vendor/Server/Skills/arkts-library-documentation-quality-check/scripts/validate-skill.cjs +259 -259
  119. package/vendor/Server/Skills/arkts-library-interface-spec/SKILL.md +97 -97
  120. package/vendor/Server/Skills/arkts-library-memory-leak-check/SKILL.md +391 -391
  121. package/vendor/Server/Skills/arkts-library-source-clone/SKILL.md +113 -113
  122. package/vendor/Server/Skills/arkts-library-stability-check/SKILL.md +312 -312
  123. package/vendor/Server/Skills/arkts-library-stability-check/assets/REPORT_TEMPLATE.md +154 -154
  124. package/vendor/Server/Skills/arkts-library-stability-check/references/CHECKLIST.md +165 -165
  125. package/vendor/Server/Skills/arkts-library-stability-check/references/CODE_EXAMPLES.md +308 -308
  126. package/vendor/Server/Skills/arkts-library-stability-check/references/SCORING_RULES.md +90 -90
  127. package/vendor/Server/Skills/arkts-library-stability-check/scripts/validate-skill.cjs +282 -282
  128. package/vendor/Server/Skills/arkts-library-test-coverage-check/SKILL.md +360 -360
  129. package/vendor/Server/Skills/arkts-library-test-coverage-check/assets/REPORT_TEMPLATE.md +145 -145
  130. package/vendor/Server/Skills/arkts-library-test-coverage-check/references/CHECKLIST.md +252 -252
  131. package/vendor/Server/Skills/arkts-library-test-coverage-check/references/MCP_TOOL_USAGE.md +114 -114
  132. package/vendor/Server/Skills/arkts-library-test-coverage-check/scripts/validate-skill.cjs +262 -262
  133. package/vendor/Server/Skills/arkts-library-xts-code/SKILL.md +455 -455
  134. package/vendor/Server/Skills/arkts-library-xts-code/assets/report-template.md +60 -60
  135. package/vendor/Server/Skills/arkts-library-xts-code/references/ACCESS_MODIFIER_PRECHECK.md +76 -76
  136. package/vendor/Server/Skills/arkts-library-xts-code/references/BUILD_VERIFICATION.md +200 -200
  137. package/vendor/Server/Skills/arkts-library-xts-code/references/CODE_STANDARDS.md +518 -518
  138. package/vendor/Server/Skills/arkts-library-xts-code/references/SUBAGENT_PROMPT_TEMPLATE.md +276 -276
  139. package/vendor/Server/Skills/arkts-library-xts-code/references/SYSTEM_API_LOOKUP.md +92 -92
  140. package/vendor/Server/Skills/arkts-library-xts-code/references/XTS_TEMPLATE.md +767 -767
  141. package/vendor/Server/Skills/arkts-library-xts-code/scripts/build.ps1 +93 -93
  142. package/vendor/Server/Skills/arkts-library-xts-code/scripts/code-linter.cjs +432 -432
  143. package/vendor/Server/Skills/arkts-library-xts-code/scripts/migrate.cjs +851 -851
  144. package/vendor/Server/Skills/arkts-library-xts-code/scripts/ohpm-switch.cjs +788 -788
  145. package/vendor/Server/Skills/arkts-library-xts-code/scripts/precheck-access-modifiers.cjs +221 -221
  146. package/vendor/Server/Skills/arkts-library-xts-code-fix/SKILL.md +228 -228
  147. package/vendor/Server/Skills/arkts-library-xts-coverage/SKILL.md +97 -97
  148. package/vendor/Server/Skills/arkts-library-xts-doc/SKILL.md +194 -194
  149. package/vendor/Server/Skills/arkts-library-xts-doc/references/EXAMPLES.md +575 -575
  150. package/vendor/Server/Skills/arkts-library-xts-doc/references/TEMPLATE.md +574 -574
  151. package/vendor/Server/Skills/arkts-library-xts-doc/references/TESTABILITY_GUIDE.md +182 -182
  152. package/vendor/Server/Skills/arkts-library-xts-execution/SKILL.md +490 -490
  153. package/vendor/Server/Skills/arkts-library-xts-execution/references/error-fixing-examples.md +217 -217
  154. package/vendor/Server/Skills/arkts-library-xts-execution/scripts/build.ps1 +93 -93
  155. package/vendor/Server/Skills/arkts-library-xts-execution/scripts/code-linter.cjs +432 -432
  156. package/vendor/Server/Skills/arkts-library-xts-execution/scripts/migrate.cjs +851 -851
  157. package/vendor/Server/Skills/arkts-library-xts-execution/scripts/ohpm-switch.cjs +788 -788
  158. package/vendor/Server/Skills/flutter-code-check/SKILL.md +299 -299
  159. package/vendor/Server/Skills/flutter-code-check/assets/OUTPUT_TEMPLATE.md +311 -311
  160. package/vendor/Server/Skills/flutter-code-check/references/CHECKLIST.md +190 -190
  161. package/vendor/Server/Skills/flutter-code-check/references/PLATFORMS.md +133 -133
  162. package/vendor/Server/Skills/flutter-code-check/scripts/validate-skill.cjs +259 -259
  163. package/vendor/Server/Skills/flutter-interface/README.md +75 -75
  164. package/vendor/Server/Skills/flutter-interface/SKILL.md +291 -291
  165. package/vendor/Server/Skills/flutter-interface/references/EXAMPLES.md +336 -336
  166. package/vendor/Server/Skills/flutter-interface/references/GIT_CLONE_GUIDE.md +190 -190
  167. package/vendor/Server/Skills/flutter-interface/references/SCRIPT_REFERENCE.md +258 -258
  168. package/vendor/Server/Skills/flutter-interface/references/TEMPLATE.md +254 -254
  169. package/vendor/Server/Skills/flutter-library-consistency-check/SKILL.md +517 -517
  170. package/vendor/Server/Skills/flutter-library-consistency-check/references/CHECKLIST.md +381 -381
  171. package/vendor/Server/Skills/flutter-library-consistency-check/references/FUNCTION_COMPARISON_GUIDE.md +341 -341
  172. package/vendor/Server/Skills/flutter-library-consistency-check/references/PLATFORM_LIMITATION_GUIDE.md +71 -71
  173. package/vendor/Server/Skills/flutter-library-documentation-quality-check/SKILL.md +518 -518
  174. package/vendor/Server/Skills/flutter-library-documentation-quality-check/references/CHECKLIST.md +406 -406
  175. package/vendor/Server/Skills/flutter-library-memory-leak-check/SKILL.md +652 -652
  176. package/vendor/Server/Skills/flutter-library-memory-leak-check/references/CHECKLIST.md +396 -396
  177. package/vendor/Server/Skills/flutter-library-stability-check/SKILL.md +744 -744
  178. package/vendor/Server/Skills/flutter-library-stability-check/references/CHECKLIST.md +720 -720
  179. package/vendor/Server/Skills/flutter-library-test-coverage-check/SKILL.md +414 -414
  180. package/vendor/Server/Skills/flutter-library-test-coverage-check/assets/REPORT_TEMPLATE.md +150 -150
  181. package/vendor/Server/Skills/flutter-library-test-coverage-check/references/CHECKLIST.md +304 -304
  182. package/vendor/Server/Skills/flutter-library-test-coverage-check/references/SCORING_RULES.md +265 -265
  183. package/vendor/Server/Skills/flutter-library-test-coverage-check/references/SCRIPT_USAGE.md +286 -286
  184. package/vendor/Server/Skills/knowledge-import/SKILL.md +383 -383
  185. package/vendor/Server/Skills/knowledge-import/references/MCP_TOOL_USAGE.md +165 -165
  186. package/vendor/Server/Skills/knowledge-import/references/SKILL_LOCATOR_GUIDE.md +91 -91
  187. package/vendor/Server/Skills/knowledge-import/references/SKILL_OPTIMIZATION_GUIDE.md +127 -127
  188. package/vendor/Server/Skills/ohos-lib-pr-push/SKILL.md +453 -301
  189. package/vendor/Server/Skills/ohos-lib-pr-push/assets/PR_CHECKLIST.md +151 -0
  190. package/vendor/Server/Skills/ohos-lib-pr-push/assets/PR_ISSUE_TEMPLATE.md +257 -105
  191. package/vendor/Server/Skills/ohos-lib-pr-push/references/GITCODE_API.md +191 -127
  192. package/vendor/Server/Skills/ohos-lib-pr-push/scripts/gitcode-api.cjs +317 -208
  193. package/vendor/Server/Skills/rn-code-check/SKILL.md +320 -320
  194. package/vendor/Server/Skills/rn-code-check/references/API-GUIDE.md +234 -234
  195. package/vendor/Server/Skills/rn-code-check/references/CHECKLIST.md +188 -188
  196. package/vendor/Server/Skills/rn-code-check/references/REPORT-TEMPLATE.md +246 -246
  197. package/vendor/Server/Skills/rn-lib-add-example/SKILL.md +198 -198
  198. package/vendor/Server/Skills/rn-lib-add-example/references/APP_RENAME_GUIDE.md +40 -40
  199. package/vendor/Server/Skills/rn-lib-add-example/references/SHELL_ADAPTATION_CHECKLIST.md +78 -78
  200. package/vendor/Server/Skills/rn-lib-add-example/references/TEMPLATE_REPO_GUIDE.md +70 -70
  201. package/vendor/Server/Skills/rn-lib-add-example/references/VERIFICATION_GUIDE.md +47 -47
  202. package/vendor/Server/Skills/rn-lib-add-example/scripts/create-example.cjs +252 -252
  203. package/vendor/Server/Skills/rn-lib-update-doc/SKILL.md +176 -176
  204. package/vendor/Server/Skills/rn-lib-update-doc/config.json +5 -5
  205. package/vendor/Server/Skills/rn-lib-update-doc/references/changelog-template.md +35 -35
  206. package/vendor/Server/Skills/rn-lib-update-doc/references/format-diff.md +137 -137
  207. package/vendor/Server/Skills/rn-lib-update-doc/references/link-registry.json +33 -33
  208. package/vendor/Server/Skills/rn-lib-update-doc/references/model-0.4.2-overview.md +40 -40
  209. package/vendor/Server/Skills/rn-lib-update-doc/references/model-0.4.2.md +429 -429
  210. package/vendor/Server/Skills/rn-lib-update-doc/scripts/detect-readme-format.cjs +105 -105
  211. package/vendor/Server/Skills/rn-lib-update-doc/scripts/find-usage-doc.cjs +90 -90
  212. package/vendor/Server/Skills/rn-lib-update-doc/scripts/link-verify.cjs +213 -213
  213. package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-changelog.cjs +73 -73
  214. package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-package-meta.cjs +258 -258
  215. package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-readme-links.cjs +341 -341
  216. package/vendor/Server/Skills/rn-lib-update-doc/scripts/resolve-usage-docs.cjs +67 -67
  217. package/vendor/Server/Skills/rn-library-consistency-check/SKILL.md +299 -299
  218. package/vendor/Server/Skills/rn-library-consistency-check/assets/REPORT_TEMPLATE.md +293 -293
  219. package/vendor/Server/Skills/rn-library-consistency-check/references/ARKTS_COMPONENT_CHECK_GUIDE.md +857 -857
  220. package/vendor/Server/Skills/rn-library-consistency-check/references/ARKTS_TURBOMODULE_CHECK_GUIDE.md +856 -856
  221. package/vendor/Server/Skills/rn-library-consistency-check/references/CHECKLIST.md +157 -157
  222. package/vendor/Server/Skills/rn-library-consistency-check/references/CPP_COMPONENT_CHECK_GUIDE.md +801 -801
  223. package/vendor/Server/Skills/rn-library-consistency-check/references/CPP_TURBOMODULE_CHECK_GUIDE.md +683 -683
  224. package/vendor/Server/Skills/rn-library-consistency-check/references/FUNCTION_COMPARISON_GUIDE.md +233 -233
  225. package/vendor/Server/Skills/rn-library-consistency-check/references/NATIVE_COMPONENT_IDENTIFICATION.md +1373 -1373
  226. package/vendor/Server/Skills/rn-library-consistency-check/references/SCORING_STANDARD.md +220 -220
  227. package/vendor/Server/Skills/rn-library-consistency-check/scripts/validate-skill.py +245 -245
  228. package/vendor/Server/Skills/rn-library-documentation-quality-check/SKILL.md +263 -263
  229. package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/MODEL.md +414 -414
  230. package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/MODEL_en.md +413 -413
  231. package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/REPORT_TEMPLATE.md +311 -311
  232. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/CHECK_CHECKLIST.md +355 -355
  233. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/CROSS_VALIDATION_GUIDE.md +115 -115
  234. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/DOC_COLLECTION_GUIDE.md +139 -139
  235. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/EXAMPLES.md +586 -586
  236. package/vendor/Server/Skills/rn-library-documentation-quality-check/references/GOTCHAS.md +57 -57
  237. package/vendor/Server/Skills/rn-library-documentation-quality-check/scripts/validate-skill.py +259 -259
  238. package/vendor/Server/Skills/rn-library-interface-analyzer/SKILL.md +301 -301
  239. package/vendor/Server/Skills/rn-library-interface-analyzer/assets/REPORT_TEMPLATE.md +148 -148
  240. package/vendor/Server/Skills/rn-library-interface-analyzer/references/DOC_ANNOTATION_GUIDE.md +118 -118
  241. package/vendor/Server/Skills/rn-library-interface-analyzer/references/SCRIPT_USAGE_GUIDE.md +168 -168
  242. package/vendor/Server/Skills/rn-library-interface-analyzer/references/URL_PARSING_RULES.md +176 -176
  243. package/vendor/Server/Skills/rn-library-issue-generalizer/SKILL.md +274 -274
  244. package/vendor/Server/Skills/rn-library-issue-generalizer/assets/case-template.md +45 -45
  245. package/vendor/Server/Skills/rn-library-issue-generalizer/assets/rule-template.md +25 -25
  246. package/vendor/Server/Skills/rn-library-issue-generalizer/references/PR_FETCH_GUIDE.md +61 -61
  247. package/vendor/Server/Skills/rn-library-issue-generalizer/references/RULE_TEMPLATE_GUIDE.md +165 -165
  248. package/vendor/Server/Skills/rn-library-issue-generalizer/scripts/fetch-pr-info.py +239 -239
  249. package/vendor/Server/Skills/rn-library-known-issue-check/SKILL.md +263 -263
  250. package/vendor/Server/Skills/rn-library-known-issue-check/assets/REPORT_TEMPLATE.md +96 -96
  251. package/vendor/Server/Skills/rn-library-known-issue-check/references/COMPLIANCE_CHECKLIST.md +57 -57
  252. package/vendor/Server/Skills/rn-library-known-issue-check/references/INSPECTION_GUIDE.md +99 -99
  253. package/vendor/Server/Skills/rn-library-known-issue-check/references/PRESCREEN_GUIDE.md +64 -64
  254. package/vendor/Server/Skills/rn-library-known-issue-check/references/SOURCE_PREP_GUIDE.md +74 -74
  255. package/vendor/Server/Skills/rn-library-known-issue-check/scripts/validate-known-issue-report.py +164 -164
  256. package/vendor/Server/Skills/rn-library-memory-leak-check/SKILL.md +356 -339
  257. package/vendor/Server/Skills/rn-library-memory-leak-check/assets/REPORT_TEMPLATE.md +85 -83
  258. package/vendor/Server/Skills/rn-library-memory-leak-check/references/CHECKLIST.md +905 -859
  259. package/vendor/Server/Skills/rn-library-memory-leak-check/references/HARMONY_CODE_PATTERNS.md +124 -122
  260. package/vendor/Server/Skills/rn-library-memory-leak-check/scripts/scan_harmony_code.py +287 -279
  261. package/vendor/Server/Skills/rn-library-stability-check/SKILL.md +273 -273
  262. package/vendor/Server/Skills/rn-library-stability-check/assets/REPORT_TEMPLATE.md +129 -129
  263. package/vendor/Server/Skills/rn-library-stability-check/references/CHECKLIST.md +581 -581
  264. package/vendor/Server/Skills/rn-library-stability-check/references/SCORING_RULES.md +138 -138
  265. package/vendor/Server/Skills/rn-library-stability-check/scripts/scan-harmony-code.py +168 -168
  266. package/vendor/Server/Skills/rn-library-test-coverage-check/SKILL.md +526 -506
  267. package/vendor/Server/Skills/rn-library-test-coverage-check/references/CHECKLIST.md +321 -280
  268. package/vendor/Server/Skills/rn-library-test-coverage-check/references/DEMO_LOCATION.md +221 -221
  269. package/vendor/Server/Skills/rn-library-test-coverage-check/references/REPORT_TEMPLATE.md +220 -209
  270. package/vendor/Server/Skills/rn-library-test-coverage-check/references/SCRIPT_USAGE.md +325 -325
  271. package/vendor/Server/Skills/rn-ohos-xts-generator/SKILL.md +279 -279
  272. package/vendor/Server/Skills/rn-ohos-xts-generator/assets/TEST_FILE_TEMPLATES.md +404 -404
  273. package/vendor/Server/Skills/rn-ohos-xts-generator/references/BUILD_TROUBLESHOOTING.md +185 -185
  274. package/vendor/Server/Skills/rn-ohos-xts-generator/references/BUILD_WORKFLOW.md +265 -265
  275. package/vendor/Server/Skills/rn-ohos-xts-generator/references/COMMON_CONFIG.md +189 -189
  276. package/vendor/Server/Skills/rn-ohos-xts-generator/references/CONFIG_GUIDE.md +203 -203
  277. package/vendor/Server/Skills/rn-ohos-xts-generator/references/COVERAGE_ANALYZER.md +147 -147
  278. package/vendor/Server/Skills/rn-ohos-xts-generator/references/DESIGN_DOC_GUIDE.md +148 -148
  279. package/vendor/Server/Skills/rn-ohos-xts-generator/references/GENERATION_FLOW.md +165 -165
  280. package/vendor/Server/Skills/rn-ohos-xts-generator/references/GENERATION_STRATEGY.md +195 -195
  281. package/vendor/Server/Skills/rn-ohos-xts-generator/references/HARMONY_SCANNER.md +249 -249
  282. package/vendor/Server/Skills/rn-ohos-xts-generator/references/JEST_FRAMEWORK.md +235 -235
  283. package/vendor/Server/Skills/rn-ohos-xts-generator/references/PLATFORM_COMPAT.md +161 -161
  284. package/vendor/Server/Skills/rn-ohos-xts-generator/references/RN_TEST_PATTERNS.md +413 -413
  285. package/vendor/Server/Skills/rn-ohos-xts-generator/references/SOURCE_PARSER.md +235 -235
  286. package/vendor/Server/Skills/rn-ohos-xts-generator/references/TEST_CONVENTIONS.md +245 -245
  287. package/vendor/Server/Skills/rn-ohos-xts-generator/references/TROUBLESHOOTING.md +282 -282
  288. package/vendor/Server/Skills/rn-ohos-xts-generator/references/USAGE_GUIDE.md +251 -251
  289. package/vendor/Server/Skills/rnoh-cptf-api-test/SKILL.md +469 -469
  290. package/vendor/Server/Skills/rnoh-cptf-api-test/assets/CPTF_TEST_TEMPLATE.md +310 -310
  291. package/vendor/Server/Skills/rnoh-cptf-api-test/assets/DEMO_PAGE_TEMPLATE.md +303 -303
  292. package/vendor/Server/Skills/rnoh-cptf-api-test/references/CPTF_TEST_GENERATION_GUIDE.md +421 -421
  293. package/vendor/Server/Skills/rnoh-cptf-api-test/references/DEMO_GENERATION_GUIDE.md +358 -358
  294. package/vendor/Server/Skills/rnoh-cptf-api-test/references/QUALITY_CHECKLIST.md +114 -114
  295. package/vendor/Server/Skills/rnoh-cptf-api-test/references/SPEC_PARSING_GUIDE.md +274 -274
  296. package/vendor/Server/Skills/rnoh-cptf-api-test/scripts/validate-rnoh-cptf-api-test.sh +185 -185
  297. package/vendor/Server/Skills/rnoh-cptf-demo-test/SKILL.md +191 -191
  298. package/vendor/Server/Skills/rnoh-cptf-demo-test/assets/TEST_TEMPLATE.md +216 -216
  299. package/vendor/Server/Skills/rnoh-cptf-demo-test/references/CPTF_SETUP.md +107 -107
  300. package/vendor/Server/Skills/rnoh-cptf-demo-test/references/DEMO_ANALYSIS.md +120 -120
  301. package/vendor/Server/Skills/rnoh-cptf-demo-test/scripts/validate-rnoh-cptf-test.sh +108 -108
  302. package/vendor/Server/Skills/rnoh-cptf-test-run/SKILL.md +237 -237
  303. package/vendor/Server/Skills/rnoh-cptf-test-run/references/DEBUG_PLAYBOOK.md +261 -261
  304. package/vendor/Server/Skills/rnoh-cptf-test-run/scripts/validate-run-env.sh +112 -112
  305. package/vendor/Server/Skills/rnoh-lib-code-adapt/SKILL.md +497 -497
  306. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/adapt-checklist.md +270 -270
  307. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/api-migration-checklist.md +164 -164
  308. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/common-compile-errors.md +556 -556
  309. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/deveco-cli-tools.md +459 -459
  310. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/edge-cases.md +65 -65
  311. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/har-tgz-build.md +512 -512
  312. package/vendor/Server/Skills/rnoh-lib-code-adapt/references/version-compat-matrix.md +132 -132
  313. package/vendor/Server/Skills/rnoh-lib-code-adapt/scripts/auto-integrate.sh +424 -424
  314. package/vendor/Server/Skills/rnoh-lib-demo-coverage/SKILL.md +137 -137
  315. package/vendor/Server/Skills/rnoh-lib-demo-create/SKILL.md +306 -306
  316. package/vendor/Server/Skills/rnoh-lib-demo-create/assets/DEMO_PAGE_TEMPLATE.md +485 -485
  317. package/vendor/Server/Skills/rnoh-lib-demo-create/assets/INDEX_TEMPLATE.md +172 -172
  318. package/vendor/Server/Skills/rnoh-lib-demo-create/references/DEMO_CODE_RULES.md +422 -422
  319. package/vendor/Server/Skills/rnoh-lib-demo-create/references/QUALITY_CHECKLIST.md +95 -95
  320. package/vendor/Server/Skills/rnoh-lib-demo-create/references/SOURCE_EXPLORATION.md +169 -169
  321. package/vendor/Server/Skills/rnoh-lib-demo-doc/SKILL.md +554 -554
  322. package/vendor/Server/Skills/rnoh-lib-demo-doc/assets/DEMO_DOC_TEMPLATE.md +106 -106
  323. package/vendor/Server/Skills/rnoh-lib-demo-doc/references/COVERAGE_INCREMENTAL.md +216 -216
  324. package/vendor/Server/Skills/rnoh-lib-demo-doc/references/DEMO_DESIGN_RULES.md +413 -413
  325. package/vendor/Server/Skills/rnoh-lib-demo-doc/references/OUTPUT_FORMAT.md +269 -269
  326. package/vendor/Server/Skills/rnoh-lib-demo-doc/references/QUALITY_CHECKLIST.md +98 -98
  327. package/vendor/Server/Skills/rnoh-lib-func-test/SKILL.md +337 -337
  328. package/vendor/Server/Skills/rnoh-lib-rnt-search/SKILL.md +722 -722
  329. package/vendor/Server/Skills/rnoh-lib-rnt-search/assets/PORT_REPORT_TEMPLATE.md +219 -219
  330. package/vendor/Server/Skills/rnoh-lib-rnt-search/references/DEMO_PORTING_GUIDE.md +345 -345
  331. package/vendor/Server/Skills/rnoh-lib-rnt-search/references/PORT_VERIFICATION.md +269 -269
  332. package/vendor/Server/Skills/rnoh-lib-rnt-search/references/RNT_PROJECT_STRUCTURE.md +173 -173
  333. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/analyze-demo-deps.cjs +267 -267
  334. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/detect-rnoh-version.cjs +174 -174
  335. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/find-rnt-demo.sh +111 -111
  336. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/port-demo.sh +186 -186
  337. package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/read-lib-meta.cjs +150 -150
  338. package/vendor/Server/Skills/rnoh-lib-test-align/SKILL.md +296 -296
  339. package/vendor/Server/Skills/rnoh-lib-test-align/references/jest-troubleshooting.md +371 -371
  340. package/vendor/Server/Skills/rnoh-lib-test-align/references/port-test-demo-guide.md +212 -212
  341. package/vendor/Server/Skills/rnoh-lib-test-align/references/runtime-troubleshooting.md +345 -345
  342. package/vendor/Server/Skills/rnoh-lib-test-align/references/unit-test-template.md +223 -223
  343. package/vendor/Server/Skills/rnoh-lib-test-align/scripts/port-test-demo.sh +1053 -1053
  344. package/vendor/Server/Skills/rnoh-lib-version-diff/SKILL.md +295 -255
  345. package/vendor/Server/Skills/rnoh-lib-version-diff/references/OHOS_ADAPTATION.md +82 -77
  346. package/vendor/Server/Skills/rnoh-lib-version-diff/references/OHOS_API_LOOKUP.md +224 -224
  347. package/vendor/Server/Skills/rnoh-lib-version-diff/references/script-reference.md +175 -174
  348. package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/detect-upstream-version.js +967 -967
  349. package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/generate-diff.js +1798 -1798
  350. package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/package.json +5 -5
  351. package/vendor/Server/Skills/rnoh-lib-version-diff/templates/report-template.md +180 -137
  352. package/vendor/Server/Skills/rnoh-lib-xts-coverage/SKILL.md +145 -145
  353. package/vendor/Server/Skills/skill-generator/SKILL.md +365 -365
  354. package/vendor/Server/Skills/skill-generator/assets/SKILL_TEMPLATE.md +183 -183
  355. package/vendor/Server/Skills/skill-generator/references/COMPLIANCE_CHECKLIST.md +82 -82
  356. package/vendor/Server/Skills/skill-generator/references/KB_QUERY_GUIDE.md +110 -110
  357. package/vendor/Server/Skills/skill-generator/references/MCP_TOOL_DISCOVERY.md +122 -122
  358. package/vendor/Server/Skills/skill-generator/references/SKILL_SPEC.md +121 -121
  359. package/vendor/Server/Skills/skill-generator/scripts/validate-skill.cjs +259 -259
  360. package/vendor/Server/Skills/task-analysis/SKILL.md +234 -234
  361. package/vendor/Server/Skills/task-analysis/assets/OUTPUT_EXAMPLES.md +160 -160
  362. package/vendor/Server/Skills/task-analysis/references/ACCEPTANCE_CRITERIA_GUIDE.md +190 -190
  363. package/vendor/Server/Skills/task-analysis/references/ANALYSIS_SCHEMA.md +224 -224
  364. package/vendor/Server/Skills/task-analysis/references/INTEGRATION_CONTEXT.md +162 -162
  365. package/vendor/Server/Skills/task-analysis/references/LESSONS_LEARNED.md +55 -55
  366. package/vendor/Server/Skills/task-analysis/references/REPLAN_CONTEXT_GUIDE.md +126 -126
  367. package/vendor/Server/Skills/task-analysis/scripts/validate-analysis-output.sh +256 -256
  368. package/vendor/Server/Skills/task-decomposition/SKILL.md +528 -528
  369. package/vendor/Server/Skills/task-decomposition/assets/OUTPUT_EXAMPLES.md +451 -451
  370. package/vendor/Server/Skills/task-decomposition/references/ACCEPTANCE_CRITERIA_GUIDE.md +179 -179
  371. package/vendor/Server/Skills/task-decomposition/references/DEPENDENCY_GRAPH_GUIDE.md +152 -152
  372. package/vendor/Server/Skills/task-decomposition/references/INTEGRATION_CONTEXT.md +175 -175
  373. package/vendor/Server/Skills/task-decomposition/references/REPLAN_CONTEXT_GUIDE.md +195 -195
  374. package/vendor/Server/Skills/task-decomposition/references/TASK_DECOMPOSITION_TEMPLATES.md +226 -226
  375. package/vendor/Server/Skills/task-decomposition/scripts/list-available-skills.cjs +263 -263
  376. package/vendor/Server/Skills/task-decomposition/scripts/skill-blacklist.json +29 -29
  377. package/vendor/Server/Skills/task-decomposition/scripts/validate-decomposition-output.cjs +376 -376
  378. package/vendor/Server/Skills/task-decomposition/scripts/validate-param-consistency.cjs +259 -259
  379. package/vendor/Server/Skills/task-decomposition/scripts/validate-specified-skills.cjs +216 -216
  380. package/vendor/Server/Skills/task-decomposition/scripts/validate-step-graph.cjs +424 -424
  381. package/vendor/Server/Skills/tpc-cpp-check/SKILL.md +427 -427
  382. package/vendor/Server/Skills/tpc-cpp-check/references/CHECKLIST.md +214 -214
  383. package/vendor/Server/Skills/tpc-cpp-check/references/HPKBUILD_GUIDE.md +235 -235
  384. package/vendor/Server/Skills/tpc-cpp-check/references/REPORT_TEMPLATE.md +250 -250
  385. package/vendor/Server/TestCheck/TestCheck.js +775 -775
  386. package/vendor/Server/TestCheck/index.js +11 -11
  387. package/vendor/Server/library/McpToolGuide.js +280 -280
  388. package/vendor/Server/library/StatsService.js +126 -126
  389. package/vendor/Server/library/cstTime.js +16 -16
  390. package/vendor/VERSION +3 -3
  391. package/workflows/pr-check.mjs +105 -105
  392. package/workflows/pr-push.mjs +192 -192
  393. package/vendor/Server/Agent/SkillSelector/types.js +0 -63
@@ -1,263 +1,263 @@
1
- #!/usr/bin/env node
2
- /**
3
- * @tool list-available-skills
4
- * @description 扫描 SKILL 根目录,读取各 SKILL.md frontmatter 的 name/description,按黑名单过滤后输出可用执行 SKILL 列表。供 task-decomposition 拆解时进行步骤与 SKILL 的匹配(specifiedSkill 标注),是可用 SKILL 清单的唯一事实源。
5
- * @param root: string - SKILL 根目录路径(可选,默认为脚本所在 SKILL 的上级目录)
6
- * @param format: string - 输出格式:compact | list | names | json(可选,默认 list)
7
- * @param exclude: string - 额外黑名单,逗号分隔的 SKILL name/目录名(可选,与 skill-blacklist.json 合并)
8
- *
9
- * list-available-skills.cjs
10
- *
11
- * 用法(两种调用方式兼容):
12
- * node list-available-skills.cjs # 默认根目录,list 格式
13
- * node list-available-skills.cjs --format compact # 紧凑格式(description 截断 60 字符单行)
14
- * node list-available-skills.cjs --root /path/to/Skills # 指定 SKILL 根目录
15
- * node list-available-skills.cjs --format json # JSON 格式输出
16
- * node list-available-skills.cjs --exclude a,b,c # 追加黑名单
17
- * node list-available-skills.cjs '{"root":"/path/to/Skills","format":"json"}'
18
- *
19
- * 黑名单来源(三者合并生效,匹配 name 或目录名,大小写不敏感):
20
- * 1. 脚本同目录 skill-blacklist.json(纯数组 或 {"exclude": [...]} 两种格式)
21
- * 2. --exclude 参数(逗号分隔)
22
- * 3. 环境变量 SKILL_BLACKLIST(逗号分隔)
23
- *
24
- * 输出格式:
25
- * compact 每行: - {name}({目录名}): {description 截断 60 字符} —— 体积最小,适合 LLM 拆解时内联读取
26
- * list (默认)每行: - {name}({目录名}): {description} —— 完整描述
27
- * names 每行一个 name —— 适合快速检索
28
- * json [{name, dir, description}](pretty JSON) —— 适合程序消费
29
- *
30
- * 依赖:仅 Node 内置 fs/path,无第三方依赖。
31
- */
32
-
33
- 'use strict';
34
-
35
- const fs = require('node:fs');
36
- const path = require('node:path');
37
-
38
- /** 默认 SKILL 根目录:本脚本位于 {root}/task-decomposition/scripts/ 下 */
39
- const DEFAULT_ROOT = path.resolve(__dirname, '..', '..');
40
-
41
- /** 黑名单配置文件(与本脚本同目录) */
42
- const BLACKLIST_FILE = path.join(__dirname, 'skill-blacklist.json');
43
-
44
- // ── frontmatter 解析 ──────────────────────────────────────────
45
-
46
- /**
47
- * 从 SKILL.md 内容中解析 frontmatter 的指定字段(单行值)。
48
- *
49
- * @param {string} md - SKILL.md 文件内容
50
- * @param {string} field - 字段名(如 name / description)
51
- * @returns {string|null} 字段值(去引号/去首尾空白);无 frontmatter 或无该字段时 null
52
- */
53
- function parseFrontmatterField(md, field) {
54
- const fmMatch = md.match(/^---\r?\n([\s\S]*?)\r?\n---/);
55
- if (!fmMatch) return null;
56
- const fieldMatch = fmMatch[1].match(new RegExp(`^${field}:\\s*(.+)$`, 'm'));
57
- if (!fieldMatch) return null;
58
- return fieldMatch[1].trim().replace(/^['"]|['"]$/g, '');
59
- }
60
-
61
- /**
62
- * 解析单个 SKILL 目录的元信息。
63
- *
64
- * @param {string} skillDir - SKILL 目录路径
65
- * @returns {{name: string, dir: string, description: string}|null} 元信息;无 SKILL.md 或 name/description 均缺失时 null
66
- */
67
- function parseSkillMeta(skillDir) {
68
- const mdPath = path.join(skillDir, 'SKILL.md');
69
- let md;
70
- try {
71
- md = fs.readFileSync(mdPath, 'utf-8');
72
- } catch {
73
- return null; // 无 SKILL.md,不是合法 SKILL 目录
74
- }
75
- const dir = path.basename(skillDir);
76
- const name = parseFrontmatterField(md, 'name') || dir;
77
- const description = parseFrontmatterField(md, 'description') || '';
78
- return { name, dir, description };
79
- }
80
-
81
- // ── 黑名单 ────────────────────────────────────────────────────
82
-
83
- /**
84
- * 读取黑名单配置文件(skill-blacklist.json)。
85
- * 支持两种格式:纯数组 ["a","b"] 或 {"exclude": ["a","b"]}。
86
- * 文件不存在或格式非法时返回空数组(静默降级,不影响扫描)。
87
- *
88
- * @returns {string[]}
89
- */
90
- function loadBlacklistFile() {
91
- try {
92
- const raw = fs.readFileSync(BLACKLIST_FILE, 'utf-8');
93
- const parsed = JSON.parse(raw);
94
- const list = Array.isArray(parsed) ? parsed : (Array.isArray(parsed.exclude) ? parsed.exclude : []);
95
- return list.filter(x => typeof x === 'string' && x.trim());
96
- } catch {
97
- return [];
98
- }
99
- }
100
-
101
- /**
102
- * 规整黑名单条目:去空白、转小写、去重、剔除空项。
103
- *
104
- * @param {string[]} list
105
- * @returns {string[]}
106
- */
107
- function normalizeExcludeList(list) {
108
- const set = new Set();
109
- for (const item of list) {
110
- if (typeof item !== 'string') continue;
111
- const v = item.trim().toLowerCase();
112
- if (v) set.add(v);
113
- }
114
- return [...set];
115
- }
116
-
117
- /**
118
- * 汇总全部黑名单来源:配置文件 + --exclude 参数 + 环境变量 SKILL_BLACKLIST。
119
- *
120
- * @param {string[]} extraExclude - 额外黑名单条目
121
- * @returns {Set<string>} 小写黑名单集合
122
- */
123
- function buildBlacklist(extraExclude = []) {
124
- const envList = (process.env.SKILL_BLACKLIST || '')
125
- .split(',')
126
- .map(s => s.trim())
127
- .filter(Boolean);
128
- return new Set(normalizeExcludeList([...loadBlacklistFile(), ...extraExclude, ...envList]));
129
- }
130
-
131
- // ── 扫描 ──────────────────────────────────────────────────────
132
-
133
- /**
134
- * 扫描 SKILL 根目录,返回过滤黑名单后的可用 SKILL 列表(按 name 排序)。
135
- *
136
- * 规则:
137
- * - 只扫描根目录下一级子目录(跳过隐藏目录)
138
- * - 子目录必须包含 SKILL.md 且 frontmatter/目录名可提供 name
139
- * - 黑名单按 name 或目录名匹配(大小写不敏感)
140
- *
141
- * @param {string} root - SKILL 根目录路径
142
- * @param {string[]} extraExclude - 额外黑名单条目(name 或目录名)
143
- * @returns {{name: string, dir: string, description: string}[]} 可用 SKILL 列表
144
- */
145
- function scanSkills(root, extraExclude = []) {
146
- const blacklist = buildBlacklist(extraExclude);
147
-
148
- let entries;
149
- try {
150
- entries = fs.readdirSync(root || DEFAULT_ROOT, { withFileTypes: true });
151
- } catch (err) {
152
- console.error(`Error: 无法读取 SKILL 根目录 ${root || DEFAULT_ROOT}: ${err.message}`);
153
- process.exit(1);
154
- }
155
-
156
- const skills = [];
157
- for (const entry of entries) {
158
- if (!entry.isDirectory() || entry.name.startsWith('.')) continue;
159
- const meta = parseSkillMeta(path.join(root || DEFAULT_ROOT, entry.name));
160
- if (!meta) continue;
161
- if (blacklist.has(meta.name.toLowerCase()) || blacklist.has(meta.dir.toLowerCase())) continue;
162
- skills.push(meta);
163
- }
164
-
165
- skills.sort((a, b) => a.name.localeCompare(b.name));
166
- return skills;
167
- }
168
-
169
- // ── 输出格式化 ────────────────────────────────────────────────
170
-
171
- /**
172
- * 压缩为单行并截断到指定长度(超长以 … 结尾),用于 compact 输出。
173
- *
174
- * @param {string} text - 原始文本(可能含换行/连续空白)
175
- * @param {number} maxLen - 最大字符数
176
- * @returns {string}
177
- */
178
- function truncateText(text, maxLen) {
179
- const oneLine = String(text || '').replace(/\s+/g, ' ').trim();
180
- return oneLine.length > maxLen ? oneLine.slice(0, maxLen) + '…' : oneLine;
181
- }
182
-
183
- /**
184
- * 按指定格式输出 SKILL 列表文本。
185
- *
186
- * @param {{name: string, dir: string, description: string}[]} skills
187
- * @param {string} format - compact | list | names | json
188
- * @returns {string}
189
- */
190
- function formatSkills(skills, format) {
191
- switch (format) {
192
- case 'json':
193
- return JSON.stringify(skills, null, 2);
194
- case 'names':
195
- return skills.map(s => s.name).join('\n');
196
- case 'compact':
197
- return skills.map(s => `- ${s.name}(${s.dir}): ${truncateText(s.description, 60)}`).join('\n');
198
- case 'list':
199
- default:
200
- return skills.map(s => `- ${s.name}(${s.dir}): ${s.description}`).join('\n');
201
- }
202
- }
203
-
204
- // ── CLI 入口 ──────────────────────────────────────────────────
205
-
206
- /**
207
- * 解析 CLI 参数(兼容 flag 形式与 JSON 字符串形式)。
208
- *
209
- * @param {string[]} argv
210
- * @returns {{root: string, format: string, exclude: string[]}}
211
- */
212
- function parseArgs(argv) {
213
- const args = { root: '', format: 'list', exclude: [] };
214
-
215
- // JSON 字符串形式:{"root": "...", "format": "json", "exclude": ["a","b"]}
216
- if (argv.length > 0 && typeof argv[0] === 'string' && argv[0].startsWith('{')) {
217
- try {
218
- const parsed = JSON.parse(argv[0]);
219
- if (parsed.root) args.root = String(parsed.root);
220
- if (parsed.format) args.format = String(parsed.format);
221
- if (Array.isArray(parsed.exclude)) args.exclude = parsed.exclude.map(String);
222
- return args;
223
- } catch {
224
- // 解析失败则按 flag 形式继续
225
- }
226
- }
227
-
228
- // flag 形式:--root <path> | --format <compact|list|names|json> | --exclude a,b,c
229
- for (let i = 0; i < argv.length; i++) {
230
- const arg = argv[i];
231
- if (arg === '--root' && argv[i + 1]) {
232
- args.root = argv[i + 1];
233
- i++;
234
- } else if (arg === '--format' && argv[i + 1]) {
235
- args.format = argv[i + 1];
236
- i++;
237
- } else if (arg === '--exclude' && argv[i + 1]) {
238
- args.exclude.push(...argv[i + 1].split(',').map(s => s.trim()).filter(Boolean));
239
- i++;
240
- }
241
- }
242
- return args;
243
- }
244
-
245
- function main() {
246
- const { root, format, exclude } = parseArgs(process.argv.slice(2));
247
-
248
- if (!['compact', 'list', 'names', 'json'].includes(format)) {
249
- console.error(`Error: 未知 format "${format}"(支持: compact | list | names | json)`);
250
- process.exit(1);
251
- }
252
-
253
- const skills = scanSkills(root || DEFAULT_ROOT, exclude);
254
- const output = formatSkills(skills, format);
255
- if (output) console.log(output);
256
- }
257
-
258
- // 作为脚本直接执行时运行 CLI;被 require 时仅导出函数(供 validate-specified-skills.cjs 复用)
259
- if (require.main === module) {
260
- main();
261
- }
262
-
263
- module.exports = { scanSkills, parseSkillMeta, loadBlacklistFile, buildBlacklist, formatSkills, DEFAULT_ROOT };
1
+ #!/usr/bin/env node
2
+ /**
3
+ * @tool list-available-skills
4
+ * @description 扫描 SKILL 根目录,读取各 SKILL.md frontmatter 的 name/description,按黑名单过滤后输出可用执行 SKILL 列表。供 task-decomposition 拆解时进行步骤与 SKILL 的匹配(specifiedSkill 标注),是可用 SKILL 清单的唯一事实源。
5
+ * @param root: string - SKILL 根目录路径(可选,默认为脚本所在 SKILL 的上级目录)
6
+ * @param format: string - 输出格式:compact | list | names | json(可选,默认 list)
7
+ * @param exclude: string - 额外黑名单,逗号分隔的 SKILL name/目录名(可选,与 skill-blacklist.json 合并)
8
+ *
9
+ * list-available-skills.cjs
10
+ *
11
+ * 用法(两种调用方式兼容):
12
+ * node list-available-skills.cjs # 默认根目录,list 格式
13
+ * node list-available-skills.cjs --format compact # 紧凑格式(description 截断 60 字符单行)
14
+ * node list-available-skills.cjs --root /path/to/Skills # 指定 SKILL 根目录
15
+ * node list-available-skills.cjs --format json # JSON 格式输出
16
+ * node list-available-skills.cjs --exclude a,b,c # 追加黑名单
17
+ * node list-available-skills.cjs '{"root":"/path/to/Skills","format":"json"}'
18
+ *
19
+ * 黑名单来源(三者合并生效,匹配 name 或目录名,大小写不敏感):
20
+ * 1. 脚本同目录 skill-blacklist.json(纯数组 或 {"exclude": [...]} 两种格式)
21
+ * 2. --exclude 参数(逗号分隔)
22
+ * 3. 环境变量 SKILL_BLACKLIST(逗号分隔)
23
+ *
24
+ * 输出格式:
25
+ * compact 每行: - {name}({目录名}): {description 截断 60 字符} —— 体积最小,适合 LLM 拆解时内联读取
26
+ * list (默认)每行: - {name}({目录名}): {description} —— 完整描述
27
+ * names 每行一个 name —— 适合快速检索
28
+ * json [{name, dir, description}](pretty JSON) —— 适合程序消费
29
+ *
30
+ * 依赖:仅 Node 内置 fs/path,无第三方依赖。
31
+ */
32
+
33
+ 'use strict';
34
+
35
+ const fs = require('node:fs');
36
+ const path = require('node:path');
37
+
38
+ /** 默认 SKILL 根目录:本脚本位于 {root}/task-decomposition/scripts/ 下 */
39
+ const DEFAULT_ROOT = path.resolve(__dirname, '..', '..');
40
+
41
+ /** 黑名单配置文件(与本脚本同目录) */
42
+ const BLACKLIST_FILE = path.join(__dirname, 'skill-blacklist.json');
43
+
44
+ // ── frontmatter 解析 ──────────────────────────────────────────
45
+
46
+ /**
47
+ * 从 SKILL.md 内容中解析 frontmatter 的指定字段(单行值)。
48
+ *
49
+ * @param {string} md - SKILL.md 文件内容
50
+ * @param {string} field - 字段名(如 name / description)
51
+ * @returns {string|null} 字段值(去引号/去首尾空白);无 frontmatter 或无该字段时 null
52
+ */
53
+ function parseFrontmatterField(md, field) {
54
+ const fmMatch = md.match(/^---\r?\n([\s\S]*?)\r?\n---/);
55
+ if (!fmMatch) return null;
56
+ const fieldMatch = fmMatch[1].match(new RegExp(`^${field}:\\s*(.+)$`, 'm'));
57
+ if (!fieldMatch) return null;
58
+ return fieldMatch[1].trim().replace(/^['"]|['"]$/g, '');
59
+ }
60
+
61
+ /**
62
+ * 解析单个 SKILL 目录的元信息。
63
+ *
64
+ * @param {string} skillDir - SKILL 目录路径
65
+ * @returns {{name: string, dir: string, description: string}|null} 元信息;无 SKILL.md 或 name/description 均缺失时 null
66
+ */
67
+ function parseSkillMeta(skillDir) {
68
+ const mdPath = path.join(skillDir, 'SKILL.md');
69
+ let md;
70
+ try {
71
+ md = fs.readFileSync(mdPath, 'utf-8');
72
+ } catch {
73
+ return null; // 无 SKILL.md,不是合法 SKILL 目录
74
+ }
75
+ const dir = path.basename(skillDir);
76
+ const name = parseFrontmatterField(md, 'name') || dir;
77
+ const description = parseFrontmatterField(md, 'description') || '';
78
+ return { name, dir, description };
79
+ }
80
+
81
+ // ── 黑名单 ────────────────────────────────────────────────────
82
+
83
+ /**
84
+ * 读取黑名单配置文件(skill-blacklist.json)。
85
+ * 支持两种格式:纯数组 ["a","b"] 或 {"exclude": ["a","b"]}。
86
+ * 文件不存在或格式非法时返回空数组(静默降级,不影响扫描)。
87
+ *
88
+ * @returns {string[]}
89
+ */
90
+ function loadBlacklistFile() {
91
+ try {
92
+ const raw = fs.readFileSync(BLACKLIST_FILE, 'utf-8');
93
+ const parsed = JSON.parse(raw);
94
+ const list = Array.isArray(parsed) ? parsed : (Array.isArray(parsed.exclude) ? parsed.exclude : []);
95
+ return list.filter(x => typeof x === 'string' && x.trim());
96
+ } catch {
97
+ return [];
98
+ }
99
+ }
100
+
101
+ /**
102
+ * 规整黑名单条目:去空白、转小写、去重、剔除空项。
103
+ *
104
+ * @param {string[]} list
105
+ * @returns {string[]}
106
+ */
107
+ function normalizeExcludeList(list) {
108
+ const set = new Set();
109
+ for (const item of list) {
110
+ if (typeof item !== 'string') continue;
111
+ const v = item.trim().toLowerCase();
112
+ if (v) set.add(v);
113
+ }
114
+ return [...set];
115
+ }
116
+
117
+ /**
118
+ * 汇总全部黑名单来源:配置文件 + --exclude 参数 + 环境变量 SKILL_BLACKLIST。
119
+ *
120
+ * @param {string[]} extraExclude - 额外黑名单条目
121
+ * @returns {Set<string>} 小写黑名单集合
122
+ */
123
+ function buildBlacklist(extraExclude = []) {
124
+ const envList = (process.env.SKILL_BLACKLIST || '')
125
+ .split(',')
126
+ .map(s => s.trim())
127
+ .filter(Boolean);
128
+ return new Set(normalizeExcludeList([...loadBlacklistFile(), ...extraExclude, ...envList]));
129
+ }
130
+
131
+ // ── 扫描 ──────────────────────────────────────────────────────
132
+
133
+ /**
134
+ * 扫描 SKILL 根目录,返回过滤黑名单后的可用 SKILL 列表(按 name 排序)。
135
+ *
136
+ * 规则:
137
+ * - 只扫描根目录下一级子目录(跳过隐藏目录)
138
+ * - 子目录必须包含 SKILL.md 且 frontmatter/目录名可提供 name
139
+ * - 黑名单按 name 或目录名匹配(大小写不敏感)
140
+ *
141
+ * @param {string} root - SKILL 根目录路径
142
+ * @param {string[]} extraExclude - 额外黑名单条目(name 或目录名)
143
+ * @returns {{name: string, dir: string, description: string}[]} 可用 SKILL 列表
144
+ */
145
+ function scanSkills(root, extraExclude = []) {
146
+ const blacklist = buildBlacklist(extraExclude);
147
+
148
+ let entries;
149
+ try {
150
+ entries = fs.readdirSync(root || DEFAULT_ROOT, { withFileTypes: true });
151
+ } catch (err) {
152
+ console.error(`Error: 无法读取 SKILL 根目录 ${root || DEFAULT_ROOT}: ${err.message}`);
153
+ process.exit(1);
154
+ }
155
+
156
+ const skills = [];
157
+ for (const entry of entries) {
158
+ if (!entry.isDirectory() || entry.name.startsWith('.')) continue;
159
+ const meta = parseSkillMeta(path.join(root || DEFAULT_ROOT, entry.name));
160
+ if (!meta) continue;
161
+ if (blacklist.has(meta.name.toLowerCase()) || blacklist.has(meta.dir.toLowerCase())) continue;
162
+ skills.push(meta);
163
+ }
164
+
165
+ skills.sort((a, b) => a.name.localeCompare(b.name));
166
+ return skills;
167
+ }
168
+
169
+ // ── 输出格式化 ────────────────────────────────────────────────
170
+
171
+ /**
172
+ * 压缩为单行并截断到指定长度(超长以 … 结尾),用于 compact 输出。
173
+ *
174
+ * @param {string} text - 原始文本(可能含换行/连续空白)
175
+ * @param {number} maxLen - 最大字符数
176
+ * @returns {string}
177
+ */
178
+ function truncateText(text, maxLen) {
179
+ const oneLine = String(text || '').replace(/\s+/g, ' ').trim();
180
+ return oneLine.length > maxLen ? oneLine.slice(0, maxLen) + '…' : oneLine;
181
+ }
182
+
183
+ /**
184
+ * 按指定格式输出 SKILL 列表文本。
185
+ *
186
+ * @param {{name: string, dir: string, description: string}[]} skills
187
+ * @param {string} format - compact | list | names | json
188
+ * @returns {string}
189
+ */
190
+ function formatSkills(skills, format) {
191
+ switch (format) {
192
+ case 'json':
193
+ return JSON.stringify(skills, null, 2);
194
+ case 'names':
195
+ return skills.map(s => s.name).join('\n');
196
+ case 'compact':
197
+ return skills.map(s => `- ${s.name}(${s.dir}): ${truncateText(s.description, 60)}`).join('\n');
198
+ case 'list':
199
+ default:
200
+ return skills.map(s => `- ${s.name}(${s.dir}): ${s.description}`).join('\n');
201
+ }
202
+ }
203
+
204
+ // ── CLI 入口 ──────────────────────────────────────────────────
205
+
206
+ /**
207
+ * 解析 CLI 参数(兼容 flag 形式与 JSON 字符串形式)。
208
+ *
209
+ * @param {string[]} argv
210
+ * @returns {{root: string, format: string, exclude: string[]}}
211
+ */
212
+ function parseArgs(argv) {
213
+ const args = { root: '', format: 'list', exclude: [] };
214
+
215
+ // JSON 字符串形式:{"root": "...", "format": "json", "exclude": ["a","b"]}
216
+ if (argv.length > 0 && typeof argv[0] === 'string' && argv[0].startsWith('{')) {
217
+ try {
218
+ const parsed = JSON.parse(argv[0]);
219
+ if (parsed.root) args.root = String(parsed.root);
220
+ if (parsed.format) args.format = String(parsed.format);
221
+ if (Array.isArray(parsed.exclude)) args.exclude = parsed.exclude.map(String);
222
+ return args;
223
+ } catch {
224
+ // 解析失败则按 flag 形式继续
225
+ }
226
+ }
227
+
228
+ // flag 形式:--root <path> | --format <compact|list|names|json> | --exclude a,b,c
229
+ for (let i = 0; i < argv.length; i++) {
230
+ const arg = argv[i];
231
+ if (arg === '--root' && argv[i + 1]) {
232
+ args.root = argv[i + 1];
233
+ i++;
234
+ } else if (arg === '--format' && argv[i + 1]) {
235
+ args.format = argv[i + 1];
236
+ i++;
237
+ } else if (arg === '--exclude' && argv[i + 1]) {
238
+ args.exclude.push(...argv[i + 1].split(',').map(s => s.trim()).filter(Boolean));
239
+ i++;
240
+ }
241
+ }
242
+ return args;
243
+ }
244
+
245
+ function main() {
246
+ const { root, format, exclude } = parseArgs(process.argv.slice(2));
247
+
248
+ if (!['compact', 'list', 'names', 'json'].includes(format)) {
249
+ console.error(`Error: 未知 format "${format}"(支持: compact | list | names | json)`);
250
+ process.exit(1);
251
+ }
252
+
253
+ const skills = scanSkills(root || DEFAULT_ROOT, exclude);
254
+ const output = formatSkills(skills, format);
255
+ if (output) console.log(output);
256
+ }
257
+
258
+ // 作为脚本直接执行时运行 CLI;被 require 时仅导出函数(供 validate-specified-skills.cjs 复用)
259
+ if (require.main === module) {
260
+ main();
261
+ }
262
+
263
+ module.exports = { scanSkills, parseSkillMeta, loadBlacklistFile, buildBlacklist, formatSkills, DEFAULT_ROOT };
@@ -1,29 +1,29 @@
1
- {
2
- "_comment": "可用 SKILL 扫描黑名单(list-available-skills.cjs 使用)。列于此的 SKILL(按 name 或目录名匹配,大小写不敏感)不会出现在可用 SKILL 列表中。默认排除两类:(1) 编排层/元技能——它们由 Brain/LoopEngine 按固定链路调用,不应作为步骤执行 SKILL 被 specifiedSkill 引用;(2) 仓库检视专用 SKILL——它们由 Web 前端固定编排(arktslibrarycheck.js / flutterlibrarycheck.js / rnlibrarycheck.js)通过 specifiedSkill 直接指定,不应出现在通用拆解的可用列表中。",
3
- "exclude": [
4
- "task-analysis",
5
- "task-decomposition",
6
- "acceptance-check",
7
- "skill-generator",
8
- "knowledge-import",
9
- "rn-library-issue-generalizer",
10
- "arkts-library-interface-spec",
11
- "arkts-library-stability-check",
12
- "arkts-library-memory-leak-check",
13
- "arkts-library-documentation-quality-check",
14
- "arkts-library-test-coverage-check",
15
- "flutter-interface",
16
- "flutter-library-stability-check",
17
- "flutter-library-consistency-check",
18
- "flutter-library-memory-leak-check",
19
- "flutter-library-documentation-quality-check",
20
- "flutter-library-test-coverage-check",
21
- "rn-library-interface-analyzer",
22
- "rn-library-stability-check",
23
- "rn-library-consistency-check",
24
- "rn-library-memory-leak-check",
25
- "rn-library-documentation-quality-check",
26
- "rn-library-test-coverage-check",
27
- "rn-library-known-issue-check"
28
- ]
29
- }
1
+ {
2
+ "_comment": "可用 SKILL 扫描黑名单(list-available-skills.cjs 使用)。列于此的 SKILL(按 name 或目录名匹配,大小写不敏感)不会出现在可用 SKILL 列表中。默认排除两类:(1) 编排层/元技能——它们由 Brain/LoopEngine 按固定链路调用,不应作为步骤执行 SKILL 被 specifiedSkill 引用;(2) 仓库检视专用 SKILL——它们由 Web 前端固定编排(arktslibrarycheck.js / flutterlibrarycheck.js / rnlibrarycheck.js)通过 specifiedSkill 直接指定,不应出现在通用拆解的可用列表中。",
3
+ "exclude": [
4
+ "task-analysis",
5
+ "task-decomposition",
6
+ "acceptance-check",
7
+ "skill-generator",
8
+ "knowledge-import",
9
+ "rn-library-issue-generalizer",
10
+ "arkts-library-interface-spec",
11
+ "arkts-library-stability-check",
12
+ "arkts-library-memory-leak-check",
13
+ "arkts-library-documentation-quality-check",
14
+ "arkts-library-test-coverage-check",
15
+ "flutter-interface",
16
+ "flutter-library-stability-check",
17
+ "flutter-library-consistency-check",
18
+ "flutter-library-memory-leak-check",
19
+ "flutter-library-documentation-quality-check",
20
+ "flutter-library-test-coverage-check",
21
+ "rn-library-interface-analyzer",
22
+ "rn-library-stability-check",
23
+ "rn-library-consistency-check",
24
+ "rn-library-memory-leak-check",
25
+ "rn-library-documentation-quality-check",
26
+ "rn-library-test-coverage-check",
27
+ "rn-library-known-issue-check"
28
+ ]
29
+ }