@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.
- package/README.md +290 -244
- package/bin/3rdloop.mjs +46 -46
- package/lib/cli.js +781 -781
- package/lib/config-cmd.js +451 -451
- package/lib/config.js +318 -318
- package/lib/doctor.js +113 -113
- package/lib/exit-codes.js +30 -30
- package/lib/opencode.js +155 -155
- package/lib/orch.js +426 -426
- package/lib/queries.js +263 -263
- package/lib/step.js +325 -325
- package/lib/ui.js +222 -222
- package/lib/update.js +279 -279
- package/lib/workflow.js +308 -308
- package/lib/workflows.js +131 -131
- package/package.json +50 -50
- package/vendor/Server/Agent/SkillSelector/README.md +343 -343
- package/vendor/Server/Agent/SkillSelector/core/Agent.js +207 -207
- package/vendor/Server/Agent/SkillSelector/index.js +14 -14
- package/vendor/Server/Agent/SkillSelector/llm/llmClient.js +313 -313
- package/vendor/Server/Agent/SkillSelector/llm/prompts.js +161 -161
- package/vendor/Server/Agent/SkillSelector/llm/reactSteps.js +144 -144
- package/vendor/Server/Agent/SkillSelector/matcher/fuzzyMatcher.js +433 -433
- package/vendor/Server/Agent/SkillSelector/scanner/skillScanner.js +382 -382
- package/vendor/Server/Agent/SkillSelector/utils/actionWords.js +59 -59
- package/vendor/Server/Brain/AnalysisStrategies.js +422 -422
- package/vendor/Server/Brain/Brain.js +686 -686
- package/vendor/Server/Brain/DecompositionStrategies.js +621 -621
- package/vendor/Server/Brain/PlanPersistence.js +196 -196
- package/vendor/Server/Brain/SkillExecutor.js +251 -251
- package/vendor/Server/Brain/index.js +11 -11
- package/vendor/Server/CLI/cli.js +275 -275
- package/vendor/Server/CLI/deveco-code/index.js +71 -71
- package/vendor/Server/CLI/deveco-code.js +5 -5
- package/vendor/Server/CLI/opencode/index.js +817 -818
- package/vendor/Server/CLI/opencode.js +5 -5
- package/vendor/Server/DbUse/MessageArchive.js +61 -61
- package/vendor/Server/DbUse/StorageManager.js +107 -107
- package/vendor/Server/DbUse/adapters/BaseAdapter.js +94 -94
- package/vendor/Server/DbUse/adapters/FileAdapter.js +138 -138
- package/vendor/Server/DbUse/adapters/JsonAdapter.js +138 -138
- package/vendor/Server/DbUse/adapters/JsonlAdapter.js +114 -114
- package/vendor/Server/DbUse/adapters/SqliteAdapter.js +157 -157
- package/vendor/Server/DbUse/index.js +160 -160
- package/vendor/Server/DbUse/stores/SessionStore.js +279 -279
- package/vendor/Server/DbUse/stores/TaskExecutionStore.js +133 -133
- package/vendor/Server/DbUse/stores/TaskRegistryStore.js +262 -262
- package/vendor/Server/DbUse/stores/TaskStepStore.js +279 -279
- package/vendor/Server/FlexRunner/FlexRunner.js +1759 -1759
- package/vendor/Server/FlexRunner/index.js +12 -12
- package/vendor/Server/Knowledge/KnowledgeImporter.js +523 -523
- package/vendor/Server/Knowledge/KnowledgeManager.js +341 -341
- package/vendor/Server/Knowledge/index.js +33 -33
- package/vendor/Server/LoopEngine/LoopEngine.js +1133 -1133
- package/vendor/Server/LoopEngine/index.js +11 -11
- package/vendor/Server/Orchestrator/Orchestrator.js +0 -3
- package/vendor/Server/Orchestrator/StepNode.js +312 -312
- package/vendor/Server/Orchestrator/index.js +13 -13
- package/vendor/Server/Routes/controllers/BrainController.js +241 -241
- package/vendor/Server/Routes/controllers/FlexRunnerController.js +1125 -1125
- package/vendor/Server/Routes/controllers/HealthController.js +44 -44
- package/vendor/Server/Routes/controllers/KnowledgeImportController.js +355 -355
- package/vendor/Server/Routes/controllers/LoopEngineController.js +788 -788
- package/vendor/Server/Routes/controllers/StatsController.js +57 -57
- package/vendor/Server/Routes/controllers/StreamController.js +67 -67
- package/vendor/Server/Routes/library/logger.js +179 -179
- package/vendor/Server/Routes/library/zipArchive.js +172 -172
- package/vendor/Server/Routes/router/Router.js +204 -204
- package/vendor/Server/Routes/routes/brain.js +47 -47
- package/vendor/Server/Routes/routes/flexrunner.js +72 -72
- package/vendor/Server/Routes/routes/health.js +28 -28
- package/vendor/Server/Routes/routes/index.js +57 -57
- package/vendor/Server/Routes/routes/knowledge.js +55 -55
- package/vendor/Server/Routes/routes/loopengine.js +58 -58
- package/vendor/Server/Routes/routes/orchestrator.js +61 -61
- package/vendor/Server/Routes/routes/registry.js +97 -97
- package/vendor/Server/Routes/routes/stats.js +23 -23
- package/vendor/Server/Routes/routes/stream.js +30 -30
- package/vendor/Server/Routes/server.js +203 -203
- package/vendor/Server/Routes/sse/SseHub.js +308 -308
- package/vendor/Server/Skills/acceptance-check/SKILL.md +191 -191
- package/vendor/Server/Skills/acceptance-check/references/PHASE1_ARTIFACT_COLLECTION.md +52 -52
- package/vendor/Server/Skills/acceptance-check/references/PHASE2_CRITERIA_EVALUATION.md +77 -77
- package/vendor/Server/Skills/acceptance-check/references/PHASE2_EVIDENCE_VERIFICATION.md +70 -70
- package/vendor/Server/Skills/arkts-code-check/SKILL.md +320 -320
- package/vendor/Server/Skills/arkts-code-check/references/CODE_CHECK_GUIDE.md +210 -210
- package/vendor/Server/Skills/arkts-code-check/references/FILE_TYPE_GUIDE.md +28 -28
- package/vendor/Server/Skills/arkts-code-check/references/PHASE1_INFO_COLLECTION.md +233 -233
- package/vendor/Server/Skills/arkts-code-check/references/REPORT_TEMPLATE.md +219 -219
- package/vendor/Server/Skills/arkts-library-compile-validate/SKILL.md +328 -328
- package/vendor/Server/Skills/arkts-library-compile-validate/scripts/build.ps1 +93 -93
- package/vendor/Server/Skills/arkts-library-compile-validate/scripts/code-linter.cjs +432 -432
- package/vendor/Server/Skills/arkts-library-compile-validate/scripts/migrate.cjs +851 -851
- package/vendor/Server/Skills/arkts-library-compile-validate/scripts/ohpm-switch.cjs +788 -788
- package/vendor/Server/Skills/arkts-library-demo-code/SKILL.md +291 -291
- package/vendor/Server/Skills/arkts-library-demo-code/references/API_SIGNATURE_CHECKS.md +68 -68
- package/vendor/Server/Skills/arkts-library-demo-code/references/BUILD_VALIDATION.md +184 -184
- package/vendor/Server/Skills/arkts-library-demo-code/references/CODE_STANDARDS.md +337 -337
- package/vendor/Server/Skills/arkts-library-demo-code/references/EXAMPLES.md +400 -400
- package/vendor/Server/Skills/arkts-library-demo-code/references/SYSTEM_API_LOOKUP.md +98 -98
- package/vendor/Server/Skills/arkts-library-demo-code/references/TEMPLATE.md +544 -544
- package/vendor/Server/Skills/arkts-library-demo-code/scripts/build.ps1 +93 -93
- package/vendor/Server/Skills/arkts-library-demo-code/scripts/code-linter.cjs +432 -432
- package/vendor/Server/Skills/arkts-library-demo-code/scripts/migrate.cjs +851 -851
- package/vendor/Server/Skills/arkts-library-demo-code/scripts/ohpm-switch.cjs +788 -788
- package/vendor/Server/Skills/arkts-library-demo-coverage/SKILL.md +174 -174
- package/vendor/Server/Skills/arkts-library-demo-scenario/SKILL.md +321 -321
- package/vendor/Server/Skills/arkts-library-demo-scenario/references/EXAMPLES.md +100 -100
- package/vendor/Server/Skills/arkts-library-demo-scenario/references/TEMPLATE.md +185 -185
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/SKILL.md +233 -233
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/assets/REPORT_TEMPLATE.md +102 -102
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/CHECK_DIMENSIONS.md +89 -89
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/COMPLIANCE_CHECKLIST.md +62 -62
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/KB_QUERY_GUIDE.md +107 -107
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/MCP_TOOL_DISCOVERY.md +124 -124
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/REPORT_TEMPLATE.md +90 -90
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/SCORING_FORMULA.md +57 -57
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/scripts/validate-skill.cjs +259 -259
- package/vendor/Server/Skills/arkts-library-interface-spec/SKILL.md +97 -97
- package/vendor/Server/Skills/arkts-library-memory-leak-check/SKILL.md +391 -391
- package/vendor/Server/Skills/arkts-library-source-clone/SKILL.md +113 -113
- package/vendor/Server/Skills/arkts-library-stability-check/SKILL.md +312 -312
- package/vendor/Server/Skills/arkts-library-stability-check/assets/REPORT_TEMPLATE.md +154 -154
- package/vendor/Server/Skills/arkts-library-stability-check/references/CHECKLIST.md +165 -165
- package/vendor/Server/Skills/arkts-library-stability-check/references/CODE_EXAMPLES.md +308 -308
- package/vendor/Server/Skills/arkts-library-stability-check/references/SCORING_RULES.md +90 -90
- package/vendor/Server/Skills/arkts-library-stability-check/scripts/validate-skill.cjs +282 -282
- package/vendor/Server/Skills/arkts-library-test-coverage-check/SKILL.md +360 -360
- package/vendor/Server/Skills/arkts-library-test-coverage-check/assets/REPORT_TEMPLATE.md +145 -145
- package/vendor/Server/Skills/arkts-library-test-coverage-check/references/CHECKLIST.md +252 -252
- package/vendor/Server/Skills/arkts-library-test-coverage-check/references/MCP_TOOL_USAGE.md +114 -114
- package/vendor/Server/Skills/arkts-library-test-coverage-check/scripts/validate-skill.cjs +262 -262
- package/vendor/Server/Skills/arkts-library-xts-code/SKILL.md +455 -455
- package/vendor/Server/Skills/arkts-library-xts-code/assets/report-template.md +60 -60
- package/vendor/Server/Skills/arkts-library-xts-code/references/ACCESS_MODIFIER_PRECHECK.md +76 -76
- package/vendor/Server/Skills/arkts-library-xts-code/references/BUILD_VERIFICATION.md +200 -200
- package/vendor/Server/Skills/arkts-library-xts-code/references/CODE_STANDARDS.md +518 -518
- package/vendor/Server/Skills/arkts-library-xts-code/references/SUBAGENT_PROMPT_TEMPLATE.md +276 -276
- package/vendor/Server/Skills/arkts-library-xts-code/references/SYSTEM_API_LOOKUP.md +92 -92
- package/vendor/Server/Skills/arkts-library-xts-code/references/XTS_TEMPLATE.md +767 -767
- package/vendor/Server/Skills/arkts-library-xts-code/scripts/build.ps1 +93 -93
- package/vendor/Server/Skills/arkts-library-xts-code/scripts/code-linter.cjs +432 -432
- package/vendor/Server/Skills/arkts-library-xts-code/scripts/migrate.cjs +851 -851
- package/vendor/Server/Skills/arkts-library-xts-code/scripts/ohpm-switch.cjs +788 -788
- package/vendor/Server/Skills/arkts-library-xts-code/scripts/precheck-access-modifiers.cjs +221 -221
- package/vendor/Server/Skills/arkts-library-xts-code-fix/SKILL.md +228 -228
- package/vendor/Server/Skills/arkts-library-xts-coverage/SKILL.md +97 -97
- package/vendor/Server/Skills/arkts-library-xts-doc/SKILL.md +194 -194
- package/vendor/Server/Skills/arkts-library-xts-doc/references/EXAMPLES.md +575 -575
- package/vendor/Server/Skills/arkts-library-xts-doc/references/TEMPLATE.md +574 -574
- package/vendor/Server/Skills/arkts-library-xts-doc/references/TESTABILITY_GUIDE.md +182 -182
- package/vendor/Server/Skills/arkts-library-xts-execution/SKILL.md +490 -490
- package/vendor/Server/Skills/arkts-library-xts-execution/references/error-fixing-examples.md +217 -217
- package/vendor/Server/Skills/arkts-library-xts-execution/scripts/build.ps1 +93 -93
- package/vendor/Server/Skills/arkts-library-xts-execution/scripts/code-linter.cjs +432 -432
- package/vendor/Server/Skills/arkts-library-xts-execution/scripts/migrate.cjs +851 -851
- package/vendor/Server/Skills/arkts-library-xts-execution/scripts/ohpm-switch.cjs +788 -788
- package/vendor/Server/Skills/flutter-code-check/SKILL.md +299 -299
- package/vendor/Server/Skills/flutter-code-check/assets/OUTPUT_TEMPLATE.md +311 -311
- package/vendor/Server/Skills/flutter-code-check/references/CHECKLIST.md +190 -190
- package/vendor/Server/Skills/flutter-code-check/references/PLATFORMS.md +133 -133
- package/vendor/Server/Skills/flutter-code-check/scripts/validate-skill.cjs +259 -259
- package/vendor/Server/Skills/flutter-interface/README.md +75 -75
- package/vendor/Server/Skills/flutter-interface/SKILL.md +291 -291
- package/vendor/Server/Skills/flutter-interface/references/EXAMPLES.md +336 -336
- package/vendor/Server/Skills/flutter-interface/references/GIT_CLONE_GUIDE.md +190 -190
- package/vendor/Server/Skills/flutter-interface/references/SCRIPT_REFERENCE.md +258 -258
- package/vendor/Server/Skills/flutter-interface/references/TEMPLATE.md +254 -254
- package/vendor/Server/Skills/flutter-library-consistency-check/SKILL.md +517 -517
- package/vendor/Server/Skills/flutter-library-consistency-check/references/CHECKLIST.md +381 -381
- package/vendor/Server/Skills/flutter-library-consistency-check/references/FUNCTION_COMPARISON_GUIDE.md +341 -341
- package/vendor/Server/Skills/flutter-library-consistency-check/references/PLATFORM_LIMITATION_GUIDE.md +71 -71
- package/vendor/Server/Skills/flutter-library-documentation-quality-check/SKILL.md +518 -518
- package/vendor/Server/Skills/flutter-library-documentation-quality-check/references/CHECKLIST.md +406 -406
- package/vendor/Server/Skills/flutter-library-memory-leak-check/SKILL.md +652 -652
- package/vendor/Server/Skills/flutter-library-memory-leak-check/references/CHECKLIST.md +396 -396
- package/vendor/Server/Skills/flutter-library-stability-check/SKILL.md +744 -744
- package/vendor/Server/Skills/flutter-library-stability-check/references/CHECKLIST.md +720 -720
- package/vendor/Server/Skills/flutter-library-test-coverage-check/SKILL.md +414 -414
- package/vendor/Server/Skills/flutter-library-test-coverage-check/assets/REPORT_TEMPLATE.md +150 -150
- package/vendor/Server/Skills/flutter-library-test-coverage-check/references/CHECKLIST.md +304 -304
- package/vendor/Server/Skills/flutter-library-test-coverage-check/references/SCORING_RULES.md +265 -265
- package/vendor/Server/Skills/flutter-library-test-coverage-check/references/SCRIPT_USAGE.md +286 -286
- package/vendor/Server/Skills/knowledge-import/SKILL.md +383 -383
- package/vendor/Server/Skills/knowledge-import/references/MCP_TOOL_USAGE.md +165 -165
- package/vendor/Server/Skills/knowledge-import/references/SKILL_LOCATOR_GUIDE.md +91 -91
- package/vendor/Server/Skills/knowledge-import/references/SKILL_OPTIMIZATION_GUIDE.md +127 -127
- package/vendor/Server/Skills/ohos-lib-pr-push/SKILL.md +453 -301
- package/vendor/Server/Skills/ohos-lib-pr-push/assets/PR_CHECKLIST.md +151 -0
- package/vendor/Server/Skills/ohos-lib-pr-push/assets/PR_ISSUE_TEMPLATE.md +257 -105
- package/vendor/Server/Skills/ohos-lib-pr-push/references/GITCODE_API.md +191 -127
- package/vendor/Server/Skills/ohos-lib-pr-push/scripts/gitcode-api.cjs +317 -208
- package/vendor/Server/Skills/rn-code-check/SKILL.md +320 -320
- package/vendor/Server/Skills/rn-code-check/references/API-GUIDE.md +234 -234
- package/vendor/Server/Skills/rn-code-check/references/CHECKLIST.md +188 -188
- package/vendor/Server/Skills/rn-code-check/references/REPORT-TEMPLATE.md +246 -246
- package/vendor/Server/Skills/rn-lib-add-example/SKILL.md +198 -198
- package/vendor/Server/Skills/rn-lib-add-example/references/APP_RENAME_GUIDE.md +40 -40
- package/vendor/Server/Skills/rn-lib-add-example/references/SHELL_ADAPTATION_CHECKLIST.md +78 -78
- package/vendor/Server/Skills/rn-lib-add-example/references/TEMPLATE_REPO_GUIDE.md +70 -70
- package/vendor/Server/Skills/rn-lib-add-example/references/VERIFICATION_GUIDE.md +47 -47
- package/vendor/Server/Skills/rn-lib-add-example/scripts/create-example.cjs +252 -252
- package/vendor/Server/Skills/rn-lib-update-doc/SKILL.md +176 -176
- package/vendor/Server/Skills/rn-lib-update-doc/config.json +5 -5
- package/vendor/Server/Skills/rn-lib-update-doc/references/changelog-template.md +35 -35
- package/vendor/Server/Skills/rn-lib-update-doc/references/format-diff.md +137 -137
- package/vendor/Server/Skills/rn-lib-update-doc/references/link-registry.json +33 -33
- package/vendor/Server/Skills/rn-lib-update-doc/references/model-0.4.2-overview.md +40 -40
- package/vendor/Server/Skills/rn-lib-update-doc/references/model-0.4.2.md +429 -429
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/detect-readme-format.cjs +105 -105
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/find-usage-doc.cjs +90 -90
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/link-verify.cjs +213 -213
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-changelog.cjs +73 -73
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-package-meta.cjs +258 -258
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-readme-links.cjs +341 -341
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/resolve-usage-docs.cjs +67 -67
- package/vendor/Server/Skills/rn-library-consistency-check/SKILL.md +299 -299
- package/vendor/Server/Skills/rn-library-consistency-check/assets/REPORT_TEMPLATE.md +293 -293
- package/vendor/Server/Skills/rn-library-consistency-check/references/ARKTS_COMPONENT_CHECK_GUIDE.md +857 -857
- package/vendor/Server/Skills/rn-library-consistency-check/references/ARKTS_TURBOMODULE_CHECK_GUIDE.md +856 -856
- package/vendor/Server/Skills/rn-library-consistency-check/references/CHECKLIST.md +157 -157
- package/vendor/Server/Skills/rn-library-consistency-check/references/CPP_COMPONENT_CHECK_GUIDE.md +801 -801
- package/vendor/Server/Skills/rn-library-consistency-check/references/CPP_TURBOMODULE_CHECK_GUIDE.md +683 -683
- package/vendor/Server/Skills/rn-library-consistency-check/references/FUNCTION_COMPARISON_GUIDE.md +233 -233
- package/vendor/Server/Skills/rn-library-consistency-check/references/NATIVE_COMPONENT_IDENTIFICATION.md +1373 -1373
- package/vendor/Server/Skills/rn-library-consistency-check/references/SCORING_STANDARD.md +220 -220
- package/vendor/Server/Skills/rn-library-consistency-check/scripts/validate-skill.py +245 -245
- package/vendor/Server/Skills/rn-library-documentation-quality-check/SKILL.md +263 -263
- package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/MODEL.md +414 -414
- package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/MODEL_en.md +413 -413
- package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/REPORT_TEMPLATE.md +311 -311
- package/vendor/Server/Skills/rn-library-documentation-quality-check/references/CHECK_CHECKLIST.md +355 -355
- package/vendor/Server/Skills/rn-library-documentation-quality-check/references/CROSS_VALIDATION_GUIDE.md +115 -115
- package/vendor/Server/Skills/rn-library-documentation-quality-check/references/DOC_COLLECTION_GUIDE.md +139 -139
- package/vendor/Server/Skills/rn-library-documentation-quality-check/references/EXAMPLES.md +586 -586
- package/vendor/Server/Skills/rn-library-documentation-quality-check/references/GOTCHAS.md +57 -57
- package/vendor/Server/Skills/rn-library-documentation-quality-check/scripts/validate-skill.py +259 -259
- package/vendor/Server/Skills/rn-library-interface-analyzer/SKILL.md +301 -301
- package/vendor/Server/Skills/rn-library-interface-analyzer/assets/REPORT_TEMPLATE.md +148 -148
- package/vendor/Server/Skills/rn-library-interface-analyzer/references/DOC_ANNOTATION_GUIDE.md +118 -118
- package/vendor/Server/Skills/rn-library-interface-analyzer/references/SCRIPT_USAGE_GUIDE.md +168 -168
- package/vendor/Server/Skills/rn-library-interface-analyzer/references/URL_PARSING_RULES.md +176 -176
- package/vendor/Server/Skills/rn-library-issue-generalizer/SKILL.md +274 -274
- package/vendor/Server/Skills/rn-library-issue-generalizer/assets/case-template.md +45 -45
- package/vendor/Server/Skills/rn-library-issue-generalizer/assets/rule-template.md +25 -25
- package/vendor/Server/Skills/rn-library-issue-generalizer/references/PR_FETCH_GUIDE.md +61 -61
- package/vendor/Server/Skills/rn-library-issue-generalizer/references/RULE_TEMPLATE_GUIDE.md +165 -165
- package/vendor/Server/Skills/rn-library-issue-generalizer/scripts/fetch-pr-info.py +239 -239
- package/vendor/Server/Skills/rn-library-known-issue-check/SKILL.md +263 -263
- package/vendor/Server/Skills/rn-library-known-issue-check/assets/REPORT_TEMPLATE.md +96 -96
- package/vendor/Server/Skills/rn-library-known-issue-check/references/COMPLIANCE_CHECKLIST.md +57 -57
- package/vendor/Server/Skills/rn-library-known-issue-check/references/INSPECTION_GUIDE.md +99 -99
- package/vendor/Server/Skills/rn-library-known-issue-check/references/PRESCREEN_GUIDE.md +64 -64
- package/vendor/Server/Skills/rn-library-known-issue-check/references/SOURCE_PREP_GUIDE.md +74 -74
- package/vendor/Server/Skills/rn-library-known-issue-check/scripts/validate-known-issue-report.py +164 -164
- package/vendor/Server/Skills/rn-library-memory-leak-check/SKILL.md +356 -339
- package/vendor/Server/Skills/rn-library-memory-leak-check/assets/REPORT_TEMPLATE.md +85 -83
- package/vendor/Server/Skills/rn-library-memory-leak-check/references/CHECKLIST.md +905 -859
- package/vendor/Server/Skills/rn-library-memory-leak-check/references/HARMONY_CODE_PATTERNS.md +124 -122
- package/vendor/Server/Skills/rn-library-memory-leak-check/scripts/scan_harmony_code.py +287 -279
- package/vendor/Server/Skills/rn-library-stability-check/SKILL.md +273 -273
- package/vendor/Server/Skills/rn-library-stability-check/assets/REPORT_TEMPLATE.md +129 -129
- package/vendor/Server/Skills/rn-library-stability-check/references/CHECKLIST.md +581 -581
- package/vendor/Server/Skills/rn-library-stability-check/references/SCORING_RULES.md +138 -138
- package/vendor/Server/Skills/rn-library-stability-check/scripts/scan-harmony-code.py +168 -168
- package/vendor/Server/Skills/rn-library-test-coverage-check/SKILL.md +526 -506
- package/vendor/Server/Skills/rn-library-test-coverage-check/references/CHECKLIST.md +321 -280
- package/vendor/Server/Skills/rn-library-test-coverage-check/references/DEMO_LOCATION.md +221 -221
- package/vendor/Server/Skills/rn-library-test-coverage-check/references/REPORT_TEMPLATE.md +220 -209
- package/vendor/Server/Skills/rn-library-test-coverage-check/references/SCRIPT_USAGE.md +325 -325
- package/vendor/Server/Skills/rn-ohos-xts-generator/SKILL.md +279 -279
- package/vendor/Server/Skills/rn-ohos-xts-generator/assets/TEST_FILE_TEMPLATES.md +404 -404
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/BUILD_TROUBLESHOOTING.md +185 -185
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/BUILD_WORKFLOW.md +265 -265
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/COMMON_CONFIG.md +189 -189
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/CONFIG_GUIDE.md +203 -203
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/COVERAGE_ANALYZER.md +147 -147
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/DESIGN_DOC_GUIDE.md +148 -148
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/GENERATION_FLOW.md +165 -165
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/GENERATION_STRATEGY.md +195 -195
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/HARMONY_SCANNER.md +249 -249
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/JEST_FRAMEWORK.md +235 -235
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/PLATFORM_COMPAT.md +161 -161
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/RN_TEST_PATTERNS.md +413 -413
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/SOURCE_PARSER.md +235 -235
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/TEST_CONVENTIONS.md +245 -245
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/TROUBLESHOOTING.md +282 -282
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/USAGE_GUIDE.md +251 -251
- package/vendor/Server/Skills/rnoh-cptf-api-test/SKILL.md +469 -469
- package/vendor/Server/Skills/rnoh-cptf-api-test/assets/CPTF_TEST_TEMPLATE.md +310 -310
- package/vendor/Server/Skills/rnoh-cptf-api-test/assets/DEMO_PAGE_TEMPLATE.md +303 -303
- package/vendor/Server/Skills/rnoh-cptf-api-test/references/CPTF_TEST_GENERATION_GUIDE.md +421 -421
- package/vendor/Server/Skills/rnoh-cptf-api-test/references/DEMO_GENERATION_GUIDE.md +358 -358
- package/vendor/Server/Skills/rnoh-cptf-api-test/references/QUALITY_CHECKLIST.md +114 -114
- package/vendor/Server/Skills/rnoh-cptf-api-test/references/SPEC_PARSING_GUIDE.md +274 -274
- package/vendor/Server/Skills/rnoh-cptf-api-test/scripts/validate-rnoh-cptf-api-test.sh +185 -185
- package/vendor/Server/Skills/rnoh-cptf-demo-test/SKILL.md +191 -191
- package/vendor/Server/Skills/rnoh-cptf-demo-test/assets/TEST_TEMPLATE.md +216 -216
- package/vendor/Server/Skills/rnoh-cptf-demo-test/references/CPTF_SETUP.md +107 -107
- package/vendor/Server/Skills/rnoh-cptf-demo-test/references/DEMO_ANALYSIS.md +120 -120
- package/vendor/Server/Skills/rnoh-cptf-demo-test/scripts/validate-rnoh-cptf-test.sh +108 -108
- package/vendor/Server/Skills/rnoh-cptf-test-run/SKILL.md +237 -237
- package/vendor/Server/Skills/rnoh-cptf-test-run/references/DEBUG_PLAYBOOK.md +261 -261
- package/vendor/Server/Skills/rnoh-cptf-test-run/scripts/validate-run-env.sh +112 -112
- package/vendor/Server/Skills/rnoh-lib-code-adapt/SKILL.md +497 -497
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/adapt-checklist.md +270 -270
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/api-migration-checklist.md +164 -164
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/common-compile-errors.md +556 -556
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/deveco-cli-tools.md +459 -459
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/edge-cases.md +65 -65
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/har-tgz-build.md +512 -512
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/version-compat-matrix.md +132 -132
- package/vendor/Server/Skills/rnoh-lib-code-adapt/scripts/auto-integrate.sh +424 -424
- package/vendor/Server/Skills/rnoh-lib-demo-coverage/SKILL.md +137 -137
- package/vendor/Server/Skills/rnoh-lib-demo-create/SKILL.md +306 -306
- package/vendor/Server/Skills/rnoh-lib-demo-create/assets/DEMO_PAGE_TEMPLATE.md +485 -485
- package/vendor/Server/Skills/rnoh-lib-demo-create/assets/INDEX_TEMPLATE.md +172 -172
- package/vendor/Server/Skills/rnoh-lib-demo-create/references/DEMO_CODE_RULES.md +422 -422
- package/vendor/Server/Skills/rnoh-lib-demo-create/references/QUALITY_CHECKLIST.md +95 -95
- package/vendor/Server/Skills/rnoh-lib-demo-create/references/SOURCE_EXPLORATION.md +169 -169
- package/vendor/Server/Skills/rnoh-lib-demo-doc/SKILL.md +554 -554
- package/vendor/Server/Skills/rnoh-lib-demo-doc/assets/DEMO_DOC_TEMPLATE.md +106 -106
- package/vendor/Server/Skills/rnoh-lib-demo-doc/references/COVERAGE_INCREMENTAL.md +216 -216
- package/vendor/Server/Skills/rnoh-lib-demo-doc/references/DEMO_DESIGN_RULES.md +413 -413
- package/vendor/Server/Skills/rnoh-lib-demo-doc/references/OUTPUT_FORMAT.md +269 -269
- package/vendor/Server/Skills/rnoh-lib-demo-doc/references/QUALITY_CHECKLIST.md +98 -98
- package/vendor/Server/Skills/rnoh-lib-func-test/SKILL.md +337 -337
- package/vendor/Server/Skills/rnoh-lib-rnt-search/SKILL.md +722 -722
- package/vendor/Server/Skills/rnoh-lib-rnt-search/assets/PORT_REPORT_TEMPLATE.md +219 -219
- package/vendor/Server/Skills/rnoh-lib-rnt-search/references/DEMO_PORTING_GUIDE.md +345 -345
- package/vendor/Server/Skills/rnoh-lib-rnt-search/references/PORT_VERIFICATION.md +269 -269
- package/vendor/Server/Skills/rnoh-lib-rnt-search/references/RNT_PROJECT_STRUCTURE.md +173 -173
- package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/analyze-demo-deps.cjs +267 -267
- package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/detect-rnoh-version.cjs +174 -174
- package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/find-rnt-demo.sh +111 -111
- package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/port-demo.sh +186 -186
- package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/read-lib-meta.cjs +150 -150
- package/vendor/Server/Skills/rnoh-lib-test-align/SKILL.md +296 -296
- package/vendor/Server/Skills/rnoh-lib-test-align/references/jest-troubleshooting.md +371 -371
- package/vendor/Server/Skills/rnoh-lib-test-align/references/port-test-demo-guide.md +212 -212
- package/vendor/Server/Skills/rnoh-lib-test-align/references/runtime-troubleshooting.md +345 -345
- package/vendor/Server/Skills/rnoh-lib-test-align/references/unit-test-template.md +223 -223
- package/vendor/Server/Skills/rnoh-lib-test-align/scripts/port-test-demo.sh +1053 -1053
- package/vendor/Server/Skills/rnoh-lib-version-diff/SKILL.md +295 -255
- package/vendor/Server/Skills/rnoh-lib-version-diff/references/OHOS_ADAPTATION.md +82 -77
- package/vendor/Server/Skills/rnoh-lib-version-diff/references/OHOS_API_LOOKUP.md +224 -224
- package/vendor/Server/Skills/rnoh-lib-version-diff/references/script-reference.md +175 -174
- package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/detect-upstream-version.js +967 -967
- package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/generate-diff.js +1798 -1798
- package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/package.json +5 -5
- package/vendor/Server/Skills/rnoh-lib-version-diff/templates/report-template.md +180 -137
- package/vendor/Server/Skills/rnoh-lib-xts-coverage/SKILL.md +145 -145
- package/vendor/Server/Skills/skill-generator/SKILL.md +365 -365
- package/vendor/Server/Skills/skill-generator/assets/SKILL_TEMPLATE.md +183 -183
- package/vendor/Server/Skills/skill-generator/references/COMPLIANCE_CHECKLIST.md +82 -82
- package/vendor/Server/Skills/skill-generator/references/KB_QUERY_GUIDE.md +110 -110
- package/vendor/Server/Skills/skill-generator/references/MCP_TOOL_DISCOVERY.md +122 -122
- package/vendor/Server/Skills/skill-generator/references/SKILL_SPEC.md +121 -121
- package/vendor/Server/Skills/skill-generator/scripts/validate-skill.cjs +259 -259
- package/vendor/Server/Skills/task-analysis/SKILL.md +234 -234
- package/vendor/Server/Skills/task-analysis/assets/OUTPUT_EXAMPLES.md +160 -160
- package/vendor/Server/Skills/task-analysis/references/ACCEPTANCE_CRITERIA_GUIDE.md +190 -190
- package/vendor/Server/Skills/task-analysis/references/ANALYSIS_SCHEMA.md +224 -224
- package/vendor/Server/Skills/task-analysis/references/INTEGRATION_CONTEXT.md +162 -162
- package/vendor/Server/Skills/task-analysis/references/LESSONS_LEARNED.md +55 -55
- package/vendor/Server/Skills/task-analysis/references/REPLAN_CONTEXT_GUIDE.md +126 -126
- package/vendor/Server/Skills/task-analysis/scripts/validate-analysis-output.sh +256 -256
- package/vendor/Server/Skills/task-decomposition/SKILL.md +528 -528
- package/vendor/Server/Skills/task-decomposition/assets/OUTPUT_EXAMPLES.md +451 -451
- package/vendor/Server/Skills/task-decomposition/references/ACCEPTANCE_CRITERIA_GUIDE.md +179 -179
- package/vendor/Server/Skills/task-decomposition/references/DEPENDENCY_GRAPH_GUIDE.md +152 -152
- package/vendor/Server/Skills/task-decomposition/references/INTEGRATION_CONTEXT.md +175 -175
- package/vendor/Server/Skills/task-decomposition/references/REPLAN_CONTEXT_GUIDE.md +195 -195
- package/vendor/Server/Skills/task-decomposition/references/TASK_DECOMPOSITION_TEMPLATES.md +226 -226
- package/vendor/Server/Skills/task-decomposition/scripts/list-available-skills.cjs +263 -263
- package/vendor/Server/Skills/task-decomposition/scripts/skill-blacklist.json +29 -29
- package/vendor/Server/Skills/task-decomposition/scripts/validate-decomposition-output.cjs +376 -376
- package/vendor/Server/Skills/task-decomposition/scripts/validate-param-consistency.cjs +259 -259
- package/vendor/Server/Skills/task-decomposition/scripts/validate-specified-skills.cjs +216 -216
- package/vendor/Server/Skills/task-decomposition/scripts/validate-step-graph.cjs +424 -424
- package/vendor/Server/Skills/tpc-cpp-check/SKILL.md +427 -427
- package/vendor/Server/Skills/tpc-cpp-check/references/CHECKLIST.md +214 -214
- package/vendor/Server/Skills/tpc-cpp-check/references/HPKBUILD_GUIDE.md +235 -235
- package/vendor/Server/Skills/tpc-cpp-check/references/REPORT_TEMPLATE.md +250 -250
- package/vendor/Server/TestCheck/TestCheck.js +775 -775
- package/vendor/Server/TestCheck/index.js +11 -11
- package/vendor/Server/library/McpToolGuide.js +280 -280
- package/vendor/Server/library/StatsService.js +126 -126
- package/vendor/Server/library/cstTime.js +16 -16
- package/vendor/VERSION +3 -3
- package/workflows/pr-check.mjs +105 -105
- package/workflows/pr-push.mjs +192 -192
- 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
|
+
- 融合的知识库要点
|