@ohos-cpf/3rdloop 0.0.2 → 0.0.4

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 +290 -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,365 +1,365 @@
1
- ---
2
- name: skill-generator
3
- description: 按照Agent Skills规范生成高质量的SKILL,自动调用MCP脚本与鸿蒙知识库补充能力,生成渐进式披露结构(SKILL.md+references+assets+scripts)。当需要创建新SKILL、规范化已有SKILL、或为某个重复性任务封装可复用技能时使用。
4
- license: Apache-2.0
5
- compatibility: 需要MCP Gateway运行中(脚本工具+知识库工具),需要文件写入权限到Server/Skills目录
6
- metadata:
7
- author: LoopEngine
8
- version: "1.0.0"
9
- category: meta-skill
10
- ---
11
-
12
- # Skill Generator — SKILL 生成器
13
-
14
- 本技能用于**按规范生成新SKILL**。它不是一个简单的模板填充器,而是一个结构化生成流程:
15
- 理解需求 → 检索MCP能力 → 查询知识库 → 编写SKILL.md → 拆分references。
16
-
17
- > ⚠️ **核心原则:生成的每个SKILL必须同时满足规范合规、渐进式披露、MCP能力复用三条底线。**
18
-
19
- ---
20
-
21
- ## 任务参数
22
-
23
- | 参数 | 类型 | 必填 | 说明 |
24
- |------|------|------|------|
25
- | `skillName` | string | ✅ | SKILL名称(kebab-case,如 `arkts-api-audit`) |
26
- | `skillPurpose` | string | ✅ | SKILL要解决什么问题(自然语言描述) |
27
- | `outputDir` | string | ✅ | 输出目录绝对路径(通常为 `Server/Skills/{skillName}`) |
28
- | `domainContext` | string | ❌ | 领域上下文(如"鸿蒙ArkTS三方库"),用于知识库检索 |
29
- | `existingSkillPath` | string | ❌ | 已有SKILL路径(规范化场景),不提供则全新生成 |
30
-
31
- ---
32
-
33
- ## 输入依赖
34
-
35
- 无前置SKILL。可作为独立任务调用。
36
-
37
- ---
38
-
39
- ## 工作流程概览
40
-
41
- ```
42
- Phase 1: 需求理解与规范校验
43
-
44
- Phase 2: MCP能力检索(脚本工具 + 知识库)
45
-
46
- Phase 3: 鸿蒙知识库查询(当通用知识不够具体时)
47
-
48
- Phase 4: SKILL结构设计与SKILL.md编写
49
-
50
- Phase 5: references/assets/scripts 拆分(渐进式披露)
51
-
52
- Phase 6: 规范合规性自检
53
-
54
- Phase 7: 最终输出
55
- ```
56
-
57
- ---
58
-
59
- ## Phase 1:需求理解与规范校验
60
-
61
- ### 1.1 解析SKILL名称
62
-
63
- 验证 `skillName` 是否满足 [Agent Skills规范](https://agentskills.io/specification):
64
-
65
- | 规则 | 校验 |
66
- |------|------|
67
- | 长度 | 1-64 字符 |
68
- | 字符集 | 仅小写字母 `a-z`、数字 `0-9`、连字符 `-` |
69
- | 首尾 | 不能以 `-` 开头或结尾 |
70
- | 连续 | 不能有连续 `--` |
71
- | 目录匹配 | name 必须等于父目录名 |
72
-
73
- > 名称不合规时,**必须先修正再继续**,不允许跳过。
74
-
75
- ### 1.2 理解SKILL目标
76
-
77
- 从 `skillPurpose` 提取:
78
- - **核心任务**:SKILL做什么
79
- - **触发场景**:什么时候用(写入 description 的"when to use"部分)
80
- - **输入产出**:接收什么、输出什么
81
- - **领域关键词**:用于Phase 2/3的检索词
82
-
83
- ### 1.3 读取已有SKILL(规范化场景)
84
-
85
- 如果提供了 `existingSkillPath`,读取现有 `SKILL.md`,分析:
86
- - frontmatter 是否合规
87
- - body 是否过长(>500行需拆分)
88
- - 是否缺少 references/scripts 辅助文件
89
- - 渐进式披露是否到位
90
-
91
- > 规范化场景下,Phase 4 的工作变为"重构"而非"从零编写"。
92
-
93
- ---
94
-
95
- ## Phase 2:MCP能力检索
96
-
97
- > **目标:检查MCP Gateway中是否有可复用的脚本工具或下游工具,避免SKILL中重复造轮子。**
98
-
99
- ### 2.1 检索脚本工具
100
-
101
- MCP Gateway 的 `scripts/` 目录下每个脚本都自动注册为工具(前缀 `script_`)。
102
- 调用 `gateway_list_tools` 工具获取完整工具列表,筛选 `source: script` 的工具。
103
-
104
- **现有脚本工具示例**:
105
- | 工具名 | 脚本 | 能力 |
106
- |--------|------|------|
107
- | `script_rn_scan_exports` | rn-scan-exports.cjs | 扫描RN三方库导出接口/TurboModule Spec |
108
- | `script_rn_extract_interfaces` | rn-extract-interfaces.cjs | 提取RN三方库接口信息 |
109
-
110
- ### 2.2 检索下游MCP工具
111
-
112
- MCP Gateway 聚合了下游 Server(工具名前缀为 `{serverName}_`):
113
-
114
- | 前缀 | 来源 | 典型工具 |
115
- |------|------|----------|
116
- | `kb-server_` | 鸿蒙知识库 | 知识检索、文档查询 |
117
- | `gitcode_` | GitCode MCP | 仓库操作、PR管理、代码搜索 |
118
-
119
- ### 2.3 匹配与引用
120
-
121
- 将SKILL需求与检索到的工具匹配:
122
-
123
- - **匹配到脚本工具** → 在SKILL的对应Phase中引用 `script_{工具名}`,说明调用方式和参数
124
- - **匹配到下游工具** → 在SKILL中引用 `{serverName}_{工具名}`,说明用途
125
- - **未匹配到** → 记录为"能力缺口",考虑在 Phase 5 中创建新脚本补充
126
-
127
- > 详细检索方法参见 [MCP能力检索指南](references/MCP_TOOL_DISCOVERY.md)
128
-
129
- ---
130
-
131
- ## Phase 3:鸿蒙知识库查询
132
-
133
- > **触发条件:当 `domainContext` 涉及鸿蒙/OpenHarmony/ArkTS,且大模型通用知识不够贴合具体场景时。**
134
-
135
- ### 3.1 构建检索查询
136
-
137
- 从 Phase 1.2 提取的领域关键词 + `domainContext` 组合检索词。
138
-
139
- 示例:
140
- - domainContext = "鸿蒙ArkTS三方库内存泄漏检测"
141
- - 检索词 = `["ArkTS 内存泄漏", "OpenHarmony 内存检测", "ArkTS 生命周期泄漏"]`
142
-
143
- ### 3.2 调用知识库工具
144
-
145
- 调用 `kb-server_` 前缀的知识检索工具(具体工具名通过 Phase 2.2 获取)。
146
-
147
- **调用要点**:
148
- - 一次查询一个关键词,避免长查询导致召回率下降
149
- - 对返回结果提取:知识点、最佳实践、注意事项、代码示例
150
- - 若返回结果不相关,调整关键词重试(最多3轮)
151
-
152
- ### 3.3 知识融合
153
-
154
- 将知识库返回的内容与SKILL设计融合:
155
- - **检查清单** → 补充到 references 的检查项中
156
- - **代码示例** → 补充到 assets 的模板中
157
- - **注意事项** → 补充到 SKILL.md body 的对应Phase中(简洁引用,不照搬全文)
158
-
159
- > 知识库查询的详细操作参见 [知识库查询指南](references/KB_QUERY_GUIDE.md)
160
-
161
- ---
162
-
163
- ## Phase 4:SKILL结构设计与SKILL.md编写
164
-
165
- ### 4.1 目录结构设计
166
-
167
- 按照规范设计目录:
168
-
169
- ```
170
- {skillName}/
171
- ├── SKILL.md # 必需:元数据 + 指令
172
- ├── references/ # 可选:详细参考文档
173
- │ ├── REFERENCE.md # 技术参考
174
- │ └── {domain}.md # 领域特定文档
175
- ├── assets/ # 可选:模板、资源
176
- │ └── {template}.md # 输出模板
177
- └── scripts/ # 可选:可执行脚本
178
- └── {helper}.cjs # 辅助脚本(Node.js,跨平台)
179
- ```
180
-
181
- > ⚠️ **脚本语言要求:必须使用跨平台脚本语言(Node.js `.cjs` 或 Python `.py`),禁止使用 Bash `.sh`**,确保在 Windows 和 macOS 上均可直接运行。
182
-
183
- ### 4.2 编写 frontmatter
184
-
185
- ```yaml
186
- ---
187
- name: {skillName}
188
- description: {做什么}. Use when {什么时候用}. {关键词}.
189
- license: Apache-2.0
190
- compatibility: {环境要求}
191
- metadata:
192
- author: {作者}
193
- version: "1.0.0"
194
- ---
195
- ```
196
-
197
- **description 编写要点**:
198
- - ≤1024 字符
199
- - 必须包含"做什么"+"什么时候用"
200
- - 包含领域关键词,便于Agent匹配
201
-
202
- ### 4.3 编写 body
203
-
204
- **body 结构模板**:
205
-
206
- ```markdown
207
- # {Skill标题}
208
-
209
- {一句话定位}
210
-
211
- > ⚠️ **核心原则:{本SKILL的关键约束}**
212
-
213
- ---
214
-
215
- ## 任务参数
216
-
217
- | 参数 | 必需 | 说明 |
218
- |------|------|------|
219
- | ... | ✅ | ... |
220
-
221
- ---
222
-
223
- ## 输入依赖
224
-
225
- - 前置SKILL: {或"无"}
226
- - 输入文件: {或"无"}
227
-
228
- ---
229
-
230
- ## 工作流程概览
231
-
232
- Phase 1 → Phase 2 → ... → Phase N
233
-
234
- ---
235
-
236
- ## Phase 1:{阶段名}
237
-
238
- ### 1.1 {步骤}
239
- {详细指令,引用references时用相对路径链接}
240
-
241
- > 详细步骤参见 [参考文档](references/REFERENCE.md)
242
-
243
- ---
244
-
245
- ## Phase N:{最终阶段}
246
- {输出产物说明}
247
- ```
248
-
249
- **body 长度约束**:
250
- - 推荐 < 500 行
251
- - 推荐 < 5000 tokens
252
- - 超过时**必须**将详细内容拆分到 references/
253
-
254
- > 完整编写规范参见 [SKILL编写规范](references/SKILL_SPEC.md)
255
-
256
- ---
257
-
258
- ## Phase 5:渐进式披露拆分
259
-
260
- > **目标:确保SKILL.md保持精炼,详细内容按需加载。**
261
-
262
- ### 5.1 拆分原则
263
-
264
- | 内容类型 | 放置位置 | 加载时机 |
265
- |----------|----------|----------|
266
- | 核心流程步骤 | SKILL.md body | SKILL激活时 |
267
- | 详细检查清单 | references/ | 按需读取 |
268
- | 完整代码模板 | assets/ | 按需读取 |
269
- | 可执行辅助逻辑 | scripts/ | 按需执行 |
270
- | 领域知识参考 | references/ | 按需读取 |
271
-
272
- ### 5.2 文件引用规范
273
-
274
- - 使用**相对路径**(从SKILL根目录起)
275
- - 保持**一层深度**:`references/REF.md` ✅,`references/a/b/REF.md` ❌
276
- - 引用格式:`参见 [参考文档](references/REFERENCE.md)`
277
-
278
- ### 5.3 补充脚本(能力缺口填补)
279
-
280
- 如果 Phase 2.3 识别到能力缺口,在此创建新脚本:
281
-
282
- **脚本语言必须跨平台**(Windows/macOS/Linux 均可运行):
283
- - ✅ **Node.js(`.cjs`)**:首选,与项目 MCP scripts 惯例一致
284
- - ✅ **Python(`.py`)**:次选,需 Python 3 环境
285
- - ❌ **Bash(`.sh`)**:禁止,Windows 无原生支持
286
-
287
- 脚本头部注释约定:
288
- ```javascript
289
- #!/usr/bin/env node
290
- /**
291
- * @tool {工具名}
292
- * @description {描述}
293
- * @param {参数名}: {类型} - {说明}
294
- */
295
- ```
296
-
297
- 脚本放入 SKILL 的 `scripts/` 目录,并在 SKILL.md 中说明调用方式。
298
- 若脚本需要注册到 MCP Gateway,复制到 `MCP/scripts/` 目录。
299
-
300
- ---
301
-
302
- ## Phase 6:规范合规性自检
303
-
304
- 生成完成后,执行合规性检查:
305
-
306
- ### 6.1 frontmatter 检查
307
-
308
- | 检查项 | 规则 |
309
- |--------|------|
310
- | `name` | ✅ 合规字符集、长度、匹配目录名 |
311
- | `description` | ✅ ≤1024字符、含"做什么"+"何时用" |
312
- | `license` | ✅ 存在 |
313
- | `metadata` | ✅ 含 author、version |
314
-
315
- ### 6.2 结构检查
316
-
317
- | 检查项 | 规则 |
318
- |--------|------|
319
- | SKILL.md 存在 | ✅ |
320
- | body < 500行 | ✅(超过则拆分) |
321
- | references 一层深度 | ✅ |
322
- | 文件引用用相对路径 | ✅ |
323
-
324
- ### 6.3 内容检查
325
-
326
- | 检查项 | 规则 |
327
- |--------|------|
328
- | 有任务参数表 | ✅ |
329
- | 有工作流程概览 | ✅ |
330
- | MCP工具引用正确 | ✅(工具名前缀正确) |
331
- | 知识库内容已融合 | ✅(如适用) |
332
-
333
- > 完整检查清单参见 [合规检查清单](references/COMPLIANCE_CHECKLIST.md)
334
-
335
- 可运行校验脚本进行自动化检查(跨平台,仅需 Node.js):
336
-
337
- ```bash
338
- node {outputDir}/scripts/validate-skill.cjs {outputDir}
339
- ```
340
-
341
- ---
342
-
343
- ## Phase 7:最终输出
344
-
345
- 确认输出目录包含所有文件:
346
-
347
- ```
348
- {outputDir}/
349
- ├── SKILL.md # ✅ 主文件
350
- ├── references/ # ✅ 参考文档(至少1个)
351
- │ ├── SKILL_SPEC.md
352
- │ ├── MCP_TOOL_DISCOVERY.md
353
- │ ├── KB_QUERY_GUIDE.md
354
- │ └── COMPLIANCE_CHECKLIST.md
355
- ├── assets/ # ✅ 模板资源
356
- │ └── SKILL_TEMPLATE.md
357
- └── scripts/ # ✅ 校验脚本(Node.js,跨平台)
358
- └── validate-skill.cjs
359
- ```
360
-
361
- 输出完成确认信息,包含:
362
- - 生成的文件列表
363
- - frontmatter 摘要(name、description)
364
- - 引用的MCP工具列表
365
- - 融合的知识库要点
1
+ ---
2
+ name: skill-generator
3
+ description: 按照Agent Skills规范生成高质量的SKILL,自动调用MCP脚本与鸿蒙知识库补充能力,生成渐进式披露结构(SKILL.md+references+assets+scripts)。当需要创建新SKILL、规范化已有SKILL、或为某个重复性任务封装可复用技能时使用。
4
+ license: Apache-2.0
5
+ compatibility: 需要MCP Gateway运行中(脚本工具+知识库工具),需要文件写入权限到Server/Skills目录
6
+ metadata:
7
+ author: LoopEngine
8
+ version: "1.0.0"
9
+ category: meta-skill
10
+ ---
11
+
12
+ # Skill Generator — SKILL 生成器
13
+
14
+ 本技能用于**按规范生成新SKILL**。它不是一个简单的模板填充器,而是一个结构化生成流程:
15
+ 理解需求 → 检索MCP能力 → 查询知识库 → 编写SKILL.md → 拆分references。
16
+
17
+ > ⚠️ **核心原则:生成的每个SKILL必须同时满足规范合规、渐进式披露、MCP能力复用三条底线。**
18
+
19
+ ---
20
+
21
+ ## 任务参数
22
+
23
+ | 参数 | 类型 | 必填 | 说明 |
24
+ |------|------|------|------|
25
+ | `skillName` | string | ✅ | SKILL名称(kebab-case,如 `arkts-api-audit`) |
26
+ | `skillPurpose` | string | ✅ | SKILL要解决什么问题(自然语言描述) |
27
+ | `outputDir` | string | ✅ | 输出目录绝对路径(通常为 `Server/Skills/{skillName}`) |
28
+ | `domainContext` | string | ❌ | 领域上下文(如"鸿蒙ArkTS三方库"),用于知识库检索 |
29
+ | `existingSkillPath` | string | ❌ | 已有SKILL路径(规范化场景),不提供则全新生成 |
30
+
31
+ ---
32
+
33
+ ## 输入依赖
34
+
35
+ 无前置SKILL。可作为独立任务调用。
36
+
37
+ ---
38
+
39
+ ## 工作流程概览
40
+
41
+ ```
42
+ Phase 1: 需求理解与规范校验
43
+
44
+ Phase 2: MCP能力检索(脚本工具 + 知识库)
45
+
46
+ Phase 3: 鸿蒙知识库查询(当通用知识不够具体时)
47
+
48
+ Phase 4: SKILL结构设计与SKILL.md编写
49
+
50
+ Phase 5: references/assets/scripts 拆分(渐进式披露)
51
+
52
+ Phase 6: 规范合规性自检
53
+
54
+ Phase 7: 最终输出
55
+ ```
56
+
57
+ ---
58
+
59
+ ## Phase 1:需求理解与规范校验
60
+
61
+ ### 1.1 解析SKILL名称
62
+
63
+ 验证 `skillName` 是否满足 [Agent Skills规范](https://agentskills.io/specification):
64
+
65
+ | 规则 | 校验 |
66
+ |------|------|
67
+ | 长度 | 1-64 字符 |
68
+ | 字符集 | 仅小写字母 `a-z`、数字 `0-9`、连字符 `-` |
69
+ | 首尾 | 不能以 `-` 开头或结尾 |
70
+ | 连续 | 不能有连续 `--` |
71
+ | 目录匹配 | name 必须等于父目录名 |
72
+
73
+ > 名称不合规时,**必须先修正再继续**,不允许跳过。
74
+
75
+ ### 1.2 理解SKILL目标
76
+
77
+ 从 `skillPurpose` 提取:
78
+ - **核心任务**:SKILL做什么
79
+ - **触发场景**:什么时候用(写入 description 的"when to use"部分)
80
+ - **输入产出**:接收什么、输出什么
81
+ - **领域关键词**:用于Phase 2/3的检索词
82
+
83
+ ### 1.3 读取已有SKILL(规范化场景)
84
+
85
+ 如果提供了 `existingSkillPath`,读取现有 `SKILL.md`,分析:
86
+ - frontmatter 是否合规
87
+ - body 是否过长(>500行需拆分)
88
+ - 是否缺少 references/scripts 辅助文件
89
+ - 渐进式披露是否到位
90
+
91
+ > 规范化场景下,Phase 4 的工作变为"重构"而非"从零编写"。
92
+
93
+ ---
94
+
95
+ ## Phase 2:MCP能力检索
96
+
97
+ > **目标:检查MCP Gateway中是否有可复用的脚本工具或下游工具,避免SKILL中重复造轮子。**
98
+
99
+ ### 2.1 检索脚本工具
100
+
101
+ MCP Gateway 的 `scripts/` 目录下每个脚本都自动注册为工具(前缀 `script_`)。
102
+ 调用 `gateway_list_tools` 工具获取完整工具列表,筛选 `source: script` 的工具。
103
+
104
+ **现有脚本工具示例**:
105
+ | 工具名 | 脚本 | 能力 |
106
+ |--------|------|------|
107
+ | `script_rn_scan_exports` | rn-scan-exports.cjs | 扫描RN三方库导出接口/TurboModule Spec |
108
+ | `script_rn_extract_interfaces` | rn-extract-interfaces.cjs | 提取RN三方库接口信息 |
109
+
110
+ ### 2.2 检索下游MCP工具
111
+
112
+ MCP Gateway 聚合了下游 Server(工具名前缀为 `{serverName}_`):
113
+
114
+ | 前缀 | 来源 | 典型工具 |
115
+ |------|------|----------|
116
+ | `kb-server_` | 鸿蒙知识库 | 知识检索、文档查询 |
117
+ | `gitcode_` | GitCode MCP | 仓库操作、PR管理、代码搜索 |
118
+
119
+ ### 2.3 匹配与引用
120
+
121
+ 将SKILL需求与检索到的工具匹配:
122
+
123
+ - **匹配到脚本工具** → 在SKILL的对应Phase中引用 `script_{工具名}`,说明调用方式和参数
124
+ - **匹配到下游工具** → 在SKILL中引用 `{serverName}_{工具名}`,说明用途
125
+ - **未匹配到** → 记录为"能力缺口",考虑在 Phase 5 中创建新脚本补充
126
+
127
+ > 详细检索方法参见 [MCP能力检索指南](references/MCP_TOOL_DISCOVERY.md)
128
+
129
+ ---
130
+
131
+ ## Phase 3:鸿蒙知识库查询
132
+
133
+ > **触发条件:当 `domainContext` 涉及鸿蒙/OpenHarmony/ArkTS,且大模型通用知识不够贴合具体场景时。**
134
+
135
+ ### 3.1 构建检索查询
136
+
137
+ 从 Phase 1.2 提取的领域关键词 + `domainContext` 组合检索词。
138
+
139
+ 示例:
140
+ - domainContext = "鸿蒙ArkTS三方库内存泄漏检测"
141
+ - 检索词 = `["ArkTS 内存泄漏", "OpenHarmony 内存检测", "ArkTS 生命周期泄漏"]`
142
+
143
+ ### 3.2 调用知识库工具
144
+
145
+ 调用 `kb-server_` 前缀的知识检索工具(具体工具名通过 Phase 2.2 获取)。
146
+
147
+ **调用要点**:
148
+ - 一次查询一个关键词,避免长查询导致召回率下降
149
+ - 对返回结果提取:知识点、最佳实践、注意事项、代码示例
150
+ - 若返回结果不相关,调整关键词重试(最多3轮)
151
+
152
+ ### 3.3 知识融合
153
+
154
+ 将知识库返回的内容与SKILL设计融合:
155
+ - **检查清单** → 补充到 references 的检查项中
156
+ - **代码示例** → 补充到 assets 的模板中
157
+ - **注意事项** → 补充到 SKILL.md body 的对应Phase中(简洁引用,不照搬全文)
158
+
159
+ > 知识库查询的详细操作参见 [知识库查询指南](references/KB_QUERY_GUIDE.md)
160
+
161
+ ---
162
+
163
+ ## Phase 4:SKILL结构设计与SKILL.md编写
164
+
165
+ ### 4.1 目录结构设计
166
+
167
+ 按照规范设计目录:
168
+
169
+ ```
170
+ {skillName}/
171
+ ├── SKILL.md # 必需:元数据 + 指令
172
+ ├── references/ # 可选:详细参考文档
173
+ │ ├── REFERENCE.md # 技术参考
174
+ │ └── {domain}.md # 领域特定文档
175
+ ├── assets/ # 可选:模板、资源
176
+ │ └── {template}.md # 输出模板
177
+ └── scripts/ # 可选:可执行脚本
178
+ └── {helper}.cjs # 辅助脚本(Node.js,跨平台)
179
+ ```
180
+
181
+ > ⚠️ **脚本语言要求:必须使用跨平台脚本语言(Node.js `.cjs` 或 Python `.py`),禁止使用 Bash `.sh`**,确保在 Windows 和 macOS 上均可直接运行。
182
+
183
+ ### 4.2 编写 frontmatter
184
+
185
+ ```yaml
186
+ ---
187
+ name: {skillName}
188
+ description: {做什么}. Use when {什么时候用}. {关键词}.
189
+ license: Apache-2.0
190
+ compatibility: {环境要求}
191
+ metadata:
192
+ author: {作者}
193
+ version: "1.0.0"
194
+ ---
195
+ ```
196
+
197
+ **description 编写要点**:
198
+ - ≤1024 字符
199
+ - 必须包含"做什么"+"什么时候用"
200
+ - 包含领域关键词,便于Agent匹配
201
+
202
+ ### 4.3 编写 body
203
+
204
+ **body 结构模板**:
205
+
206
+ ```markdown
207
+ # {Skill标题}
208
+
209
+ {一句话定位}
210
+
211
+ > ⚠️ **核心原则:{本SKILL的关键约束}**
212
+
213
+ ---
214
+
215
+ ## 任务参数
216
+
217
+ | 参数 | 必需 | 说明 |
218
+ |------|------|------|
219
+ | ... | ✅ | ... |
220
+
221
+ ---
222
+
223
+ ## 输入依赖
224
+
225
+ - 前置SKILL: {或"无"}
226
+ - 输入文件: {或"无"}
227
+
228
+ ---
229
+
230
+ ## 工作流程概览
231
+
232
+ Phase 1 → Phase 2 → ... → Phase N
233
+
234
+ ---
235
+
236
+ ## Phase 1:{阶段名}
237
+
238
+ ### 1.1 {步骤}
239
+ {详细指令,引用references时用相对路径链接}
240
+
241
+ > 详细步骤参见 [参考文档](references/REFERENCE.md)
242
+
243
+ ---
244
+
245
+ ## Phase N:{最终阶段}
246
+ {输出产物说明}
247
+ ```
248
+
249
+ **body 长度约束**:
250
+ - 推荐 < 500 行
251
+ - 推荐 < 5000 tokens
252
+ - 超过时**必须**将详细内容拆分到 references/
253
+
254
+ > 完整编写规范参见 [SKILL编写规范](references/SKILL_SPEC.md)
255
+
256
+ ---
257
+
258
+ ## Phase 5:渐进式披露拆分
259
+
260
+ > **目标:确保SKILL.md保持精炼,详细内容按需加载。**
261
+
262
+ ### 5.1 拆分原则
263
+
264
+ | 内容类型 | 放置位置 | 加载时机 |
265
+ |----------|----------|----------|
266
+ | 核心流程步骤 | SKILL.md body | SKILL激活时 |
267
+ | 详细检查清单 | references/ | 按需读取 |
268
+ | 完整代码模板 | assets/ | 按需读取 |
269
+ | 可执行辅助逻辑 | scripts/ | 按需执行 |
270
+ | 领域知识参考 | references/ | 按需读取 |
271
+
272
+ ### 5.2 文件引用规范
273
+
274
+ - 使用**相对路径**(从SKILL根目录起)
275
+ - 保持**一层深度**:`references/REF.md` ✅,`references/a/b/REF.md` ❌
276
+ - 引用格式:`参见 [参考文档](references/REFERENCE.md)`
277
+
278
+ ### 5.3 补充脚本(能力缺口填补)
279
+
280
+ 如果 Phase 2.3 识别到能力缺口,在此创建新脚本:
281
+
282
+ **脚本语言必须跨平台**(Windows/macOS/Linux 均可运行):
283
+ - ✅ **Node.js(`.cjs`)**:首选,与项目 MCP scripts 惯例一致
284
+ - ✅ **Python(`.py`)**:次选,需 Python 3 环境
285
+ - ❌ **Bash(`.sh`)**:禁止,Windows 无原生支持
286
+
287
+ 脚本头部注释约定:
288
+ ```javascript
289
+ #!/usr/bin/env node
290
+ /**
291
+ * @tool {工具名}
292
+ * @description {描述}
293
+ * @param {参数名}: {类型} - {说明}
294
+ */
295
+ ```
296
+
297
+ 脚本放入 SKILL 的 `scripts/` 目录,并在 SKILL.md 中说明调用方式。
298
+ 若脚本需要注册到 MCP Gateway,复制到 `MCP/scripts/` 目录。
299
+
300
+ ---
301
+
302
+ ## Phase 6:规范合规性自检
303
+
304
+ 生成完成后,执行合规性检查:
305
+
306
+ ### 6.1 frontmatter 检查
307
+
308
+ | 检查项 | 规则 |
309
+ |--------|------|
310
+ | `name` | ✅ 合规字符集、长度、匹配目录名 |
311
+ | `description` | ✅ ≤1024字符、含"做什么"+"何时用" |
312
+ | `license` | ✅ 存在 |
313
+ | `metadata` | ✅ 含 author、version |
314
+
315
+ ### 6.2 结构检查
316
+
317
+ | 检查项 | 规则 |
318
+ |--------|------|
319
+ | SKILL.md 存在 | ✅ |
320
+ | body < 500行 | ✅(超过则拆分) |
321
+ | references 一层深度 | ✅ |
322
+ | 文件引用用相对路径 | ✅ |
323
+
324
+ ### 6.3 内容检查
325
+
326
+ | 检查项 | 规则 |
327
+ |--------|------|
328
+ | 有任务参数表 | ✅ |
329
+ | 有工作流程概览 | ✅ |
330
+ | MCP工具引用正确 | ✅(工具名前缀正确) |
331
+ | 知识库内容已融合 | ✅(如适用) |
332
+
333
+ > 完整检查清单参见 [合规检查清单](references/COMPLIANCE_CHECKLIST.md)
334
+
335
+ 可运行校验脚本进行自动化检查(跨平台,仅需 Node.js):
336
+
337
+ ```bash
338
+ node {outputDir}/scripts/validate-skill.cjs {outputDir}
339
+ ```
340
+
341
+ ---
342
+
343
+ ## Phase 7:最终输出
344
+
345
+ 确认输出目录包含所有文件:
346
+
347
+ ```
348
+ {outputDir}/
349
+ ├── SKILL.md # ✅ 主文件
350
+ ├── references/ # ✅ 参考文档(至少1个)
351
+ │ ├── SKILL_SPEC.md
352
+ │ ├── MCP_TOOL_DISCOVERY.md
353
+ │ ├── KB_QUERY_GUIDE.md
354
+ │ └── COMPLIANCE_CHECKLIST.md
355
+ ├── assets/ # ✅ 模板资源
356
+ │ └── SKILL_TEMPLATE.md
357
+ └── scripts/ # ✅ 校验脚本(Node.js,跨平台)
358
+ └── validate-skill.cjs
359
+ ```
360
+
361
+ 输出完成确认信息,包含:
362
+ - 生成的文件列表
363
+ - frontmatter 摘要(name、description)
364
+ - 引用的MCP工具列表
365
+ - 融合的知识库要点