@sokeai/cli 1.0.77 → 1.0.79

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 (291) hide show
  1. package/package.json +1 -1
  2. package/scripts/install.js +2 -2
  3. package/scripts/local-test.js +1 -1
  4. package/scripts/test-auto-detect.js +20 -3
  5. package/skills/README.md +25 -174
  6. package/skills/SKILL.md +17 -239
  7. package/skills/mono/README.md +10 -0
  8. package/skills/mono/SKILL.md +223 -0
  9. package/skills/{soke-course/soke-cli/345/256/211/350/243/205/346/214/207/345/215/227.md → mono/references/installation.md} +0 -3
  10. package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/README.md +2 -1
  11. package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-engineer/parts/part1-basic.md +1 -1
  12. package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/publish-gate.md +1 -0
  13. package/skills/mono/references/modules/soke-ai-coach-director/platform/soke-ai-training/soke-ai-training.md +123 -0
  14. package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/exec-handbook.md +5 -5
  15. package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/exec-part1.md +5 -5
  16. package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/platform-api-pitfalls.md +1 -1
  17. package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/subs/part1/SOP.md +2 -2
  18. package/skills/mono/references/modules/soke-ai-coach-director/scripts/gate_check.py +114 -0
  19. package/skills/mono/references/modules/soke-ai-coach-director/scripts/validate_operations.py +410 -0
  20. package/skills/{soke-ai-training/SKILL.md → mono/references/modules/soke-ai-training/MODULE.md} +3 -1
  21. package/skills/mono/references/modules/soke-assign/README.md +308 -0
  22. package/skills/{soke-certificate/SKILL.md → mono/references/modules/soke-certificate/MODULE.md} +2 -2
  23. package/skills/mono/references/modules/soke-course/MODULE.md +402 -0
  24. package/skills/mono/references/modules/soke-course/README.md +291 -0
  25. package/skills/{soke-course → mono/references/modules/soke-course}/references/examples.md +3 -3
  26. package/skills/{soke-exam/SKILL.md → mono/references/modules/soke-exam/MODULE.md} +1 -1
  27. package/skills/{soke-learning-map/SKILL.md → mono/references/modules/soke-learning-map/MODULE.md} +5 -6
  28. package/skills/{soke-learning-profile/SKILL.md → mono/references/modules/soke-learning-profile/MODULE.md} +2 -2
  29. package/skills/mono/references/modules/soke-lesson/README.md +53 -0
  30. package/skills/mono/references/modules/soke-material/README.md +49 -0
  31. package/skills/{soke-photo-gallery/SKILL.md → mono/references/modules/soke-photo-gallery/MODULE.md} +2 -3
  32. package/skills/mono/references/modules/soke-supervisor/MODULE.md +186 -0
  33. package/skills/mono/references/modules/soke-task/MODULE.md +146 -0
  34. package/skills/{soke-training-demand/SKILL.md → mono/references/modules/soke-training-demand/MODULE.md} +1 -1
  35. package/skills/mono/references/shared/cli-basics.md +185 -0
  36. package/skills/mono/scripts/check_readiness.py +28 -0
  37. package/skills/{soke-ai-coach-director → mono}/scripts/validate_operations.py +2 -2
  38. package/skills/multi/README.md +18 -0
  39. package/skills/multi/soke-ai-coach-director/CHANGELOG.md +203 -0
  40. package/skills/multi/soke-ai-coach-director/README.md +124 -0
  41. package/skills/multi/soke-ai-coach-director/SKILL.md +220 -0
  42. package/skills/multi/soke-ai-coach-director/assets/ERRORS-TEMPLATE.md +5 -0
  43. package/skills/multi/soke-ai-coach-director/assets/FEATURE_REQUESTS-TEMPLATE.md +5 -0
  44. package/skills/multi/soke-ai-coach-director/assets/LEARNINGS-TEMPLATE.md +45 -0
  45. package/skills/multi/soke-ai-coach-director/assets/SKILL-TEMPLATE.md +177 -0
  46. package/skills/multi/soke-ai-coach-director/coaching/knowledge-packager/knowledge-packager.md +91 -0
  47. package/skills/multi/soke-ai-coach-director/coaching/prompt-engineer/parts/part1-basic.md +59 -0
  48. package/skills/multi/soke-ai-coach-director/coaching/prompt-engineer/parts/part2-roles.md +97 -0
  49. package/skills/multi/soke-ai-coach-director/coaching/prompt-engineer/parts/part3-flow.md +72 -0
  50. package/skills/multi/soke-ai-coach-director/coaching/prompt-engineer/parts/part4-scoring.md +87 -0
  51. package/skills/multi/soke-ai-coach-director/coaching/prompt-engineer/parts/part5-constraints.md +48 -0
  52. package/skills/multi/soke-ai-coach-director/coaching/prompt-engineer/prompt-engineer.md +76 -0
  53. package/skills/multi/soke-ai-coach-director/coaching/prompt-optimizer/prompt-optimizer.md +381 -0
  54. package/skills/multi/soke-ai-coach-director/coaching/role-profiler/role-profiler.md +87 -0
  55. package/skills/multi/soke-ai-coach-director/platform/adapters/README.md +68 -0
  56. package/skills/multi/soke-ai-coach-director/platform/adapters/qclaw.md +67 -0
  57. package/skills/multi/soke-ai-coach-director/platform/adapters/workbuddy.md +44 -0
  58. package/skills/multi/soke-ai-coach-director/platform/adapters/wukong.md +70 -0
  59. package/skills/multi/soke-ai-coach-director/platform/adapters/zework.md +89 -0
  60. package/skills/multi/soke-ai-coach-director/platform/api-fallback.md +262 -0
  61. package/skills/multi/soke-ai-coach-director/platform/interaction.md +103 -0
  62. package/skills/multi/soke-ai-coach-director/platform/publish-gate.md +45 -0
  63. package/skills/multi/soke-ai-coach-director/platform/resource-finalizer.md +103 -0
  64. package/skills/{soke-ai-coach-director → multi/soke-ai-coach-director}/platform/soke-ai-training/soke-ai-training.md +1 -1
  65. package/skills/multi/soke-ai-coach-director/platform/sync-engine.md +39 -0
  66. package/skills/multi/soke-ai-coach-director/references/cases/AI/345/256/242/346/210/267/350/247/222/350/211/262/346/250/241/346/235/277/345/272/223.md +265 -0
  67. package/skills/multi/soke-ai-coach-director/references/cases/AI/351/231/252/347/273/203Bad Case/346/240/267/346/234/254/345/272/223.md" +206 -0
  68. package/skills/multi/soke-ai-coach-director/references/cases/AI/351/231/252/347/273/203/345/210/233/345/273/272/351/227/256/351/242/230/345/272/223.md +666 -0
  69. package/skills/multi/soke-ai-coach-director/references/cases/AI/351/231/252/347/273/203/345/234/272/346/231/257/345/210/206/347/261/273/345/272/223.md +213 -0
  70. package/skills/multi/soke-ai-coach-director/references/cases/AI/351/231/252/347/273/203/345/256/242/346/210/267/346/235/220/346/226/231/346/270/205/345/215/225/344/270/216/350/256/277/350/260/210/351/242/230/345/272/223.md +229 -0
  71. package/skills/multi/soke-ai-coach-director/references/cases/AI/351/231/252/347/273/203/345/276/256/350/260/203/351/227/256/351/242/230/345/272/223.md +833 -0
  72. package/skills/multi/soke-ai-coach-director/references/cases/AI/351/231/252/347/273/203/346/212/200/346/234/257/350/276/271/347/225/214/344/270/216/346/216/222/351/232/234/345/272/223.md +239 -0
  73. package/skills/multi/soke-ai-coach-director/references/cases/AI/351/231/252/347/273/203/346/217/220/347/244/272/350/257/215/346/250/241/345/235/227/345/272/223.md +249 -0
  74. package/skills/multi/soke-ai-coach-director/references/cases/AI/351/231/252/347/273/203/346/225/260/346/215/256/346/214/207/346/240/207/344/270/216/347/234/213/346/235/277/345/217/243/345/276/204/345/272/223.md +282 -0
  75. package/skills/multi/soke-ai-coach-director/references/cases/AI/351/231/252/347/273/203/346/265/213/350/257/225/347/224/250/344/276/213/345/272/223.md +254 -0
  76. package/skills/multi/soke-ai-coach-director/references/cases/AI/351/231/252/347/273/203/350/257/204/345/210/206/346/240/207/345/207/206/347/273/204/344/273/266/345/272/223.md +264 -0
  77. package/skills/multi/soke-ai-coach-director/references/cases/AI/351/231/252/347/273/203/351/241/271/347/233/256/346/241/210/344/276/213/345/244/215/347/233/230/345/272/223.md +223 -0
  78. package/skills/multi/soke-ai-coach-director/references/cases/AI/351/241/276/345/256/242/350/247/222/350/211/262/346/250/241/346/213/237_GoodCase_BadCase_20260701.md +304 -0
  79. package/skills/multi/soke-ai-coach-director/references/cases/create//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/347/224/265/350/257/235/347/272/246/350/256/277//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/345/256/242/346/210/267/346/235/220/346/226/231/346/261/207/346/200/273_2026-05-19_1341.md +42 -0
  80. package/skills/multi/soke-ai-coach-director/references/cases/create//346/226/260/350/203/275/346/272/220/350/275/246/344/270/273/350/264/267//346/226/260/350/203/275/346/272/220/350/275/246/344/270/273/350/264/267/347/237/245/350/257/206/345/272/223/347/224/237/346/210/220_20260615.md +23 -0
  81. package/skills/multi/soke-ai-coach-director/references/cases/create//346/226/260/350/203/275/346/272/220/350/275/246/344/270/273/350/264/267//346/226/260/350/203/275/346/272/220/350/275/246/344/270/273/350/264/267/351/231/252/347/273/203/346/217/220/347/244/272/350/257/215/347/224/237/346/210/220_20260615.md +34 -0
  82. package/skills/multi/soke-ai-coach-director/references/cases/create//346/237/220/345/233/275/351/231/205/346/243/200/346/265/213/346/234/272/346/236/204//346/237/220/345/233/275/351/231/205/346/243/200/346/265/213/346/234/272/346/236/204/351/231/252/347/273/203/346/211/247/350/241/214/346/226/271/346/241/210/344/272/244/344/273/230/350/256/260/345/275/225_20260610.md +26 -0
  83. package/skills/multi/soke-ai-coach-director/references/cases/create//351/231/214/346/213/234/344/277/241/346/201/257/346/224/266/351/233/206//351/231/214/346/213/234/344/277/241/346/201/257/346/224/266/351/233/206_/346/217/220/347/244/272/350/257/215/346/220/255/345/273/272_20260622.md +30 -0
  84. package/skills/multi/soke-ai-coach-director/references/cases/micro-tune//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/347/263/273/345/210/227//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/346/217/220/347/244/272/350/257/215_/344/274/230/345/214/226/347/211/210_V1.2_20260616.md +254 -0
  85. package/skills/multi/soke-ai-coach-director/references/cases/micro-tune//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/347/263/273/345/210/227//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/346/217/220/347/244/272/350/257/215_/345/216/213/347/274/251/347/211/210_V2.0_20260616.md +96 -0
  86. package/skills/multi/soke-ai-coach-director/references/cases/micro-tune//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/347/263/273/345/210/227//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/346/217/220/347/244/272/350/257/215/344/274/230/345/214/226_20260616.md +20 -0
  87. package/skills/multi/soke-ai-coach-director/references/cases/micro-tune//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/347/263/273/345/210/227//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277AI/351/231/252/347/273/203/347/263/273/347/273/237_/346/265/213/350/257/225/345/217/215/351/246/210/346/261/207/346/200/273_2026-06-01.md +434 -0
  88. package/skills/multi/soke-ai-coach-director/references/cases/micro-tune//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/347/263/273/345/210/227//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277KYC/344/277/241/344/273/273/345/200/274/347/246/201/344/273/244_2026-06-09_0932.md +22 -0
  89. package/skills/multi/soke-ai-coach-director/references/cases/micro-tune//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/347/263/273/345/210/227//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277KYC/346/217/220/347/244/272/350/257/215_/344/274/230/345/214/226/347/211/210_v2_20260608.md +261 -0
  90. package/skills/multi/soke-ai-coach-director/references/cases/micro-tune//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/347/263/273/345/210/227//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/346/217/220/347/244/272/350/257/215_/344/274/230/345/214/226/347/211/210_v1.2.md +354 -0
  91. package/skills/multi/soke-ai-coach-director/references/cases/micro-tune//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/347/263/273/345/210/227//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/346/217/220/347/244/272/350/257/215/344/274/230/345/214/226_V2_/350/257/212/346/226/255/344/272/244/344/273/230_20260609.md +26 -0
  92. package/skills/multi/soke-ai-coach-director/references/cases//345/233/233/345/244/247/345/234/272/346/231/257_GoodCase_BadCase_20260701.md +194 -0
  93. package/skills/multi/soke-ai-coach-director/references/cases//346/241/210/344/276/213/345/272/223/350/241/245/345/205/205_2026-06-24.md +41 -0
  94. package/skills/multi/soke-ai-coach-director/references/change-log-partwise-refactor.md +74 -0
  95. package/skills/multi/soke-ai-coach-director/references/env-check.md +146 -0
  96. package/skills/multi/soke-ai-coach-director/references/exec-common.md +126 -0
  97. package/skills/multi/soke-ai-coach-director/references/exec-handbook.md +621 -0
  98. package/skills/multi/soke-ai-coach-director/references/exec-part1.md +86 -0
  99. package/skills/multi/soke-ai-coach-director/references/exec-part2.md +145 -0
  100. package/skills/multi/soke-ai-coach-director/references/exec-part3.md +91 -0
  101. package/skills/multi/soke-ai-coach-director/references/exec-part4.md +187 -0
  102. package/skills/multi/soke-ai-coach-director/references/gate-check-matrix.md +46 -0
  103. package/skills/{soke-learning-map/soke-cli/345/256/211/350/243/205/346/214/207/345/215/227.md → multi/soke-ai-coach-director/references/installation.md} +0 -3
  104. package/skills/multi/soke-ai-coach-director/references/micro-tune-labels.md +30 -0
  105. package/skills/multi/soke-ai-coach-director/references/platform-api-pitfalls.md +49 -0
  106. package/skills/multi/soke-ai-coach-director/references/role-resource-matching.md +45 -0
  107. package/skills/multi/soke-ai-coach-director/references/self-improvement-examples.md +376 -0
  108. package/skills/multi/soke-ai-coach-director/references/self-learning-engine.md +489 -0
  109. package/skills/multi/soke-ai-coach-director/references/shared.md +185 -0
  110. package/skills/multi/soke-ai-coach-director/references/subs/part1/SOP.md +17 -0
  111. package/skills/multi/soke-ai-coach-director/references/subs/part2/SOP.md +34 -0
  112. package/skills/multi/soke-ai-coach-director/references/subs/part3/SOP.md +27 -0
  113. package/skills/multi/soke-ai-coach-director/references/subs/part4/SOP.md +31 -0
  114. package/skills/multi/soke-ai-coach-director/references/subs/publish/SOP.md +81 -0
  115. package/skills/multi/soke-ai-coach-director/references/subs/tune/SOP.md +92 -0
  116. package/skills/multi/soke-ai-coach-director/references/verified-cli-cheatsheet.md +56 -0
  117. package/skills/multi/soke-ai-coach-director/scripts/activator.sh +4 -0
  118. package/skills/multi/soke-ai-coach-director/scripts/error-detector.sh +4 -0
  119. package/skills/multi/soke-ai-coach-director/scripts/extract-skill.sh +7 -0
  120. package/skills/multi/soke-ai-coach-director/scripts/gate_check.py +114 -0
  121. package/skills/multi/soke-ai-coach-director/scripts/validate_operations.py +410 -0
  122. package/skills/multi/soke-ai-training/SKILL.md +249 -0
  123. package/skills/{soke-cli/345/256/211/350/243/205/346/214/207/345/215/227.md → multi/soke-ai-training/references/installation.md} +0 -3
  124. package/skills/multi/soke-ai-training/references/shared.md +185 -0
  125. package/skills/{soke-assign → multi/soke-assign}/README.md +3 -5
  126. package/skills/multi/soke-assign/SKILL.md +101 -0
  127. package/skills/{soke-course/SKILL.md → multi/soke-assign/references/dependencies/soke-course.md} +1 -1
  128. package/skills/multi/soke-assign/references/dependencies/soke-exam.md +600 -0
  129. package/skills/multi/soke-assign/references/installation.md +451 -0
  130. package/skills/multi/soke-assign/references/shared.md +185 -0
  131. package/skills/multi/soke-certificate/SKILL.md +715 -0
  132. package/skills/multi/soke-certificate/references/installation.md +451 -0
  133. package/skills/multi/soke-certificate/references/shared.md +185 -0
  134. package/skills/{soke-course → multi/soke-course}/README.md +5 -7
  135. package/skills/multi/soke-course/SKILL.md +399 -0
  136. package/skills/multi/soke-course/agents/openai.yaml +7 -0
  137. package/skills/multi/soke-course/examples/create-basic.md +70 -0
  138. package/skills/multi/soke-course/references/course-list-courses.md +216 -0
  139. package/skills/multi/soke-course/references/dependencies/soke-assign.md +103 -0
  140. package/skills/multi/soke-course/references/dependencies/soke-lesson.md +119 -0
  141. package/skills/multi/soke-course/references/dependencies/soke-material.md +105 -0
  142. package/skills/multi/soke-course/references/examples.md +480 -0
  143. package/skills/multi/soke-course/references/installation.md +451 -0
  144. package/skills/multi/soke-course/references/intent-cases.md +99 -0
  145. package/skills/multi/soke-course/references/shared.md +185 -0
  146. package/skills/multi/soke-course/references/sop-full-workflow.md +177 -0
  147. package/skills/multi/soke-course/references/sop-lesson-types.md +66 -0
  148. package/skills/multi/soke-course/references/sop-publish-check.md +76 -0
  149. package/skills/multi/soke-course/references/subs/ai/SOP.md +153 -0
  150. package/skills/multi/soke-course/references/subs/category/SOP.md +112 -0
  151. package/skills/multi/soke-course/references/subs/charge/SOP.md +107 -0
  152. package/skills/multi/soke-course/references/subs/copy/SOP.md +80 -0
  153. package/skills/multi/soke-course/references/subs/publish/SOP.md +168 -0
  154. package/skills/multi/soke-course/references/subs/query/SOP.md +165 -0
  155. package/skills/multi/soke-course/references/subs/settings/SOP.md +136 -0
  156. package/skills/multi/soke-course/references/subs/template/SOP.md +223 -0
  157. package/skills/multi/soke-course/references/troubleshoot.md +68 -0
  158. package/skills/multi/soke-course/scripts/check_readiness.py +87 -0
  159. package/skills/multi/soke-exam/SKILL.md +598 -0
  160. package/skills/multi/soke-exam/references/exam-get-exam-user.md +212 -0
  161. package/skills/multi/soke-exam/references/installation.md +451 -0
  162. package/skills/multi/soke-exam/references/shared.md +185 -0
  163. package/skills/multi/soke-exam-question-pool/SKILL.md +121 -0
  164. package/skills/multi/soke-exam-question-pool/references/installation.md +451 -0
  165. package/skills/multi/soke-exam-question-pool/references/shared.md +185 -0
  166. package/skills/multi/soke-learning-map/SKILL.md +553 -0
  167. package/skills/multi/soke-learning-map/references/dependencies/soke-assign.md +103 -0
  168. package/skills/{soke-task/SKILL.md → multi/soke-learning-map/references/dependencies/soke-task.md} +1 -1
  169. package/skills/multi/soke-learning-map/references/installation.md +451 -0
  170. package/skills/multi/soke-learning-map/references/shared.md +185 -0
  171. package/skills/multi/soke-learning-profile/SKILL.md +221 -0
  172. package/skills/multi/soke-learning-profile/references/installation.md +451 -0
  173. package/skills/multi/soke-learning-profile/references/shared.md +185 -0
  174. package/skills/multi/soke-lesson/SKILL.md +117 -0
  175. package/skills/multi/soke-lesson/references/installation.md +451 -0
  176. package/skills/multi/soke-lesson/references/shared.md +185 -0
  177. package/skills/multi/soke-material/SKILL.md +103 -0
  178. package/skills/multi/soke-material/references/installation.md +451 -0
  179. package/skills/multi/soke-material/references/shared.md +185 -0
  180. package/skills/multi/soke-photo-gallery/SKILL.md +284 -0
  181. package/skills/multi/soke-photo-gallery/references/installation.md +451 -0
  182. package/skills/multi/soke-photo-gallery/references/shared.md +185 -0
  183. package/skills/multi/soke-shared/SKILL.md +183 -0
  184. package/skills/multi/soke-supervisor/SKILL.md +184 -0
  185. package/skills/multi/soke-supervisor/references/installation.md +451 -0
  186. package/skills/multi/soke-supervisor/references/shared.md +185 -0
  187. package/skills/multi/soke-task/SKILL.md +144 -0
  188. package/skills/multi/soke-task/references/installation.md +451 -0
  189. package/skills/multi/soke-task/references/shared.md +185 -0
  190. package/skills/multi/soke-training-demand/SKILL.md +219 -0
  191. package/skills/multi/soke-training-demand/references/installation.md +451 -0
  192. package/skills/multi/soke-training-demand/references/shared.md +185 -0
  193. package/skills/soke-course/scripts/check_readiness.sh +0 -82
  194. /package/skills/{soke-ai-coach-director → mono}/references/cases/AI/345/256/242/346/210/267/350/247/222/350/211/262/346/250/241/346/235/277/345/272/223.md" +0 -0
  195. /package/skills/{soke-ai-coach-director → mono}/references/cases/AI/351/231/252/347/273/203Bad Case/346/240/267/346/234/254/345/272/223.md" +0 -0
  196. /package/skills/{soke-ai-coach-director → mono}/references/cases/AI/351/231/252/347/273/203/345/210/233/345/273/272/351/227/256/351/242/230/345/272/223.md" +0 -0
  197. /package/skills/{soke-ai-coach-director → mono}/references/cases/AI/351/231/252/347/273/203/345/234/272/346/231/257/345/210/206/347/261/273/345/272/223.md" +0 -0
  198. /package/skills/{soke-ai-coach-director → mono}/references/cases/AI/351/231/252/347/273/203/345/256/242/346/210/267/346/235/220/346/226/231/346/270/205/345/215/225/344/270/216/350/256/277/350/260/210/351/242/230/345/272/223.md" +0 -0
  199. /package/skills/{soke-ai-coach-director → mono}/references/cases/AI/351/231/252/347/273/203/345/276/256/350/260/203/351/227/256/351/242/230/345/272/223.md" +0 -0
  200. /package/skills/{soke-ai-coach-director → mono}/references/cases/AI/351/231/252/347/273/203/346/212/200/346/234/257/350/276/271/347/225/214/344/270/216/346/216/222/351/232/234/345/272/223.md" +0 -0
  201. /package/skills/{soke-ai-coach-director → mono}/references/cases/AI/351/231/252/347/273/203/346/217/220/347/244/272/350/257/215/346/250/241/345/235/227/345/272/223.md" +0 -0
  202. /package/skills/{soke-ai-coach-director → mono}/references/cases/AI/351/231/252/347/273/203/346/225/260/346/215/256/346/214/207/346/240/207/344/270/216/347/234/213/346/235/277/345/217/243/345/276/204/345/272/223.md" +0 -0
  203. /package/skills/{soke-ai-coach-director → mono}/references/cases/AI/351/231/252/347/273/203/346/265/213/350/257/225/347/224/250/344/276/213/345/272/223.md" +0 -0
  204. /package/skills/{soke-ai-coach-director → mono}/references/cases/AI/351/231/252/347/273/203/350/257/204/345/210/206/346/240/207/345/207/206/347/273/204/344/273/266/345/272/223.md" +0 -0
  205. /package/skills/{soke-ai-coach-director → mono}/references/cases/AI/351/231/252/347/273/203/351/241/271/347/233/256/346/241/210/344/276/213/345/244/215/347/233/230/345/272/223.md" +0 -0
  206. /package/skills/{soke-ai-coach-director → mono}/references/cases/AI/351/241/276/345/256/242/350/247/222/350/211/262/346/250/241/346/213/237_GoodCase_BadCase_20260701.md" +0 -0
  207. /package/skills/{soke-ai-coach-director → mono}/references/cases/create//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/347/224/265/350/257/235/347/272/246/350/256/277//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/345/256/242/346/210/267/346/235/220/346/226/231/346/261/207/346/200/273_2026-05-19_1341.md" +0 -0
  208. /package/skills/{soke-ai-coach-director → mono}/references/cases/create//346/226/260/350/203/275/346/272/220/350/275/246/344/270/273/350/264/267//346/226/260/350/203/275/346/272/220/350/275/246/344/270/273/350/264/267/347/237/245/350/257/206/345/272/223/347/224/237/346/210/220_20260615.md" +0 -0
  209. /package/skills/{soke-ai-coach-director → mono}/references/cases/create//346/226/260/350/203/275/346/272/220/350/275/246/344/270/273/350/264/267//346/226/260/350/203/275/346/272/220/350/275/246/344/270/273/350/264/267/351/231/252/347/273/203/346/217/220/347/244/272/350/257/215/347/224/237/346/210/220_20260615.md" +0 -0
  210. /package/skills/{soke-ai-coach-director → mono}/references/cases/create//346/237/220/345/233/275/351/231/205/346/243/200/346/265/213/346/234/272/346/236/204//346/237/220/345/233/275/351/231/205/346/243/200/346/265/213/346/234/272/346/236/204/351/231/252/347/273/203/346/211/247/350/241/214/346/226/271/346/241/210/344/272/244/344/273/230/350/256/260/345/275/225_20260610.md" +0 -0
  211. /package/skills/{soke-ai-coach-director → mono}/references/cases/create//351/231/214/346/213/234/344/277/241/346/201/257/346/224/266/351/233/206//351/231/214/346/213/234/344/277/241/346/201/257/346/224/266/351/233/206_/346/217/220/347/244/272/350/257/215/346/220/255/345/273/272_20260622.md" +0 -0
  212. /package/skills/{soke-ai-coach-director → mono}/references/cases/micro-tune//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/347/263/273/345/210/227//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/346/217/220/347/244/272/350/257/215_/344/274/230/345/214/226/347/211/210_V1.2_20260616.md" +0 -0
  213. /package/skills/{soke-ai-coach-director → mono}/references/cases/micro-tune//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/347/263/273/345/210/227//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/346/217/220/347/244/272/350/257/215_/345/216/213/347/274/251/347/211/210_V2.0_20260616.md" +0 -0
  214. /package/skills/{soke-ai-coach-director → mono}/references/cases/micro-tune//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/347/263/273/345/210/227//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/346/217/220/347/244/272/350/257/215/344/274/230/345/214/226_20260616.md" +0 -0
  215. /package/skills/{soke-ai-coach-director → mono}/references/cases/micro-tune//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/347/263/273/345/210/227//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277AI/351/231/252/347/273/203/347/263/273/347/273/237_/346/265/213/350/257/225/345/217/215/351/246/210/346/261/207/346/200/273_2026-06-01.md" +0 -0
  216. /package/skills/{soke-ai-coach-director → mono}/references/cases/micro-tune//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/347/263/273/345/210/227//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277KYC/344/277/241/344/273/273/345/200/274/347/246/201/344/273/244_2026-06-09_0932.md" +0 -0
  217. /package/skills/{soke-ai-coach-director → mono}/references/cases/micro-tune//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/347/263/273/345/210/227//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277KYC/346/217/220/347/244/272/350/257/215_/344/274/230/345/214/226/347/211/210_v2_20260608.md" +0 -0
  218. /package/skills/{soke-ai-coach-director → mono}/references/cases/micro-tune//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/347/263/273/345/210/227//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/346/217/220/347/244/272/350/257/215_/344/274/230/345/214/226/347/211/210_v1.2.md" +0 -0
  219. /package/skills/{soke-ai-coach-director → mono}/references/cases/micro-tune//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/347/263/273/345/210/227//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/346/217/220/347/244/272/350/257/215/344/274/230/345/214/226_V2_/350/257/212/346/226/255/344/272/244/344/273/230_20260609.md" +0 -0
  220. /package/skills/{soke-ai-coach-director → mono}/references/cases//345/233/233/345/244/247/345/234/272/346/231/257_GoodCase_BadCase_20260701.md" +0 -0
  221. /package/skills/{soke-ai-coach-director → mono}/references/cases//346/241/210/344/276/213/345/272/223/350/241/245/345/205/205_2026-06-24.md" +0 -0
  222. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/CHANGELOG.md +0 -0
  223. /package/skills/{soke-ai-coach-director/SKILL.md → mono/references/modules/soke-ai-coach-director/MODULE.md} +0 -0
  224. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/assets/ERRORS-TEMPLATE.md +0 -0
  225. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/assets/FEATURE_REQUESTS-TEMPLATE.md +0 -0
  226. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/assets/LEARNINGS-TEMPLATE.md +0 -0
  227. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/assets/SKILL-TEMPLATE.md +0 -0
  228. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/knowledge-packager/knowledge-packager.md +0 -0
  229. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-engineer/parts/part2-roles.md +0 -0
  230. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-engineer/parts/part3-flow.md +0 -0
  231. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-engineer/parts/part4-scoring.md +0 -0
  232. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-engineer/parts/part5-constraints.md +0 -0
  233. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-engineer/prompt-engineer.md +0 -0
  234. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-optimizer/prompt-optimizer.md +0 -0
  235. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/role-profiler/role-profiler.md +0 -0
  236. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/adapters/README.md +0 -0
  237. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/adapters/qclaw.md +0 -0
  238. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/adapters/workbuddy.md +0 -0
  239. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/adapters/wukong.md +0 -0
  240. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/adapters/zework.md +0 -0
  241. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/api-fallback.md +0 -0
  242. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/interaction.md +0 -0
  243. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/resource-finalizer.md +0 -0
  244. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/sync-engine.md +0 -0
  245. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/change-log-partwise-refactor.md +0 -0
  246. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/env-check.md +0 -0
  247. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/exec-common.md +0 -0
  248. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/exec-part2.md +0 -0
  249. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/exec-part3.md +0 -0
  250. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/exec-part4.md +0 -0
  251. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/gate-check-matrix.md +0 -0
  252. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/micro-tune-labels.md +0 -0
  253. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/role-resource-matching.md +0 -0
  254. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/self-improvement-examples.md +0 -0
  255. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/self-learning-engine.md +0 -0
  256. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/subs/part2/SOP.md +0 -0
  257. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/subs/part3/SOP.md +0 -0
  258. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/subs/part4/SOP.md +0 -0
  259. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/subs/publish/SOP.md +0 -0
  260. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/subs/tune/SOP.md +0 -0
  261. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/verified-cli-cheatsheet.md +0 -0
  262. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/scripts/activator.sh +0 -0
  263. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/scripts/error-detector.sh +0 -0
  264. /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/scripts/extract-skill.sh +0 -0
  265. /package/skills/{soke-assign/SKILL.md → mono/references/modules/soke-assign/MODULE.md} +0 -0
  266. /package/skills/{soke-course → mono/references/modules/soke-course}/agents/openai.yaml +0 -0
  267. /package/skills/{soke-course → mono/references/modules/soke-course}/examples/create-basic.md +0 -0
  268. /package/skills/{soke-course → mono/references/modules/soke-course}/references/course-list-courses.md +0 -0
  269. /package/skills/{soke-course → mono/references/modules/soke-course}/references/intent-cases.md +0 -0
  270. /package/skills/{soke-course → mono/references/modules/soke-course}/references/sop-full-workflow.md +0 -0
  271. /package/skills/{soke-course → mono/references/modules/soke-course}/references/sop-lesson-types.md +0 -0
  272. /package/skills/{soke-course → mono/references/modules/soke-course}/references/sop-publish-check.md +0 -0
  273. /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/ai/SOP.md +0 -0
  274. /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/category/SOP.md +0 -0
  275. /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/charge/SOP.md +0 -0
  276. /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/copy/SOP.md +0 -0
  277. /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/publish/SOP.md +0 -0
  278. /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/query/SOP.md +0 -0
  279. /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/settings/SOP.md +0 -0
  280. /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/template/SOP.md +0 -0
  281. /package/skills/{soke-course → mono/references/modules/soke-course}/references/troubleshoot.md +0 -0
  282. /package/skills/{soke-exam → mono/references/modules/soke-exam}/references/exam-get-exam-user.md +0 -0
  283. /package/skills/{soke-exam-question-pool/SKILL.md → mono/references/modules/soke-exam-question-pool/MODULE.md} +0 -0
  284. /package/skills/{soke-lesson/SKILL.md → mono/references/modules/soke-lesson/MODULE.md} +0 -0
  285. /package/skills/{soke-material/SKILL.md → mono/references/modules/soke-material/MODULE.md} +0 -0
  286. /package/skills/{soke-shared/SKILL.md → mono/references/modules/soke-shared/MODULE.md} +0 -0
  287. /package/skills/{soke-ai-coach-director → mono}/scripts/gate_check.py +0 -0
  288. /package/skills/{soke-ai-coach-director → multi/soke-ai-coach-director}/references/cases/micro-tune//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/347/263/273/345/210/227//344/274/201/344/270/232/345/256/266/347/216/213/346/200/273/346/217/220/347/244/272/350/257/215_/344/274/230/345/214/226/347/211/210_V1.1_20260616.md" +0 -0
  289. /package/skills/{soke-ai-coach-director → multi/soke-ai-coach-director}/references/cases/micro-tune//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/347/263/273/345/210/227//345/206/234/346/210/267/345/274/240/350/200/201/346/235/277/346/217/220/347/244/272/350/257/215_/344/274/230/345/214/226/347/211/210_v1.1.md" +0 -0
  290. /package/skills/{soke-lesson → multi/soke-lesson}/README.md +0 -0
  291. /package/skills/{soke-material → multi/soke-material}/README.md +0 -0
@@ -0,0 +1,185 @@
1
+ ---
2
+ name: soke-shared
3
+ summary: 授客CLI共享基础(配置/登录/权限/错误处理/安全规则)
4
+ version: 1.0.0
5
+ description: "授客CLI共享基础:应用配置初始化、认证登录(auth login)、权限管理、错误处理、安全规则。当用户需要第一次配置(soke-cli auth login)、使用登录授权(soke-cli auth login)、遇到权限不足、或首次使用soke-cli时触发。"
6
+ ---
7
+
8
+ # soke-cli 共享规则
9
+
10
+ 本技能指导你如何通过soke-cli操作授客AI资源,以及有哪些注意事项。
11
+
12
+ ## 配置初始化
13
+
14
+ 首次使用需运行 `soke-cli auth login` 完成应用配置。
15
+
16
+ 当你帮用户初始化配置时,引导用户按照交互式提示完成配置:
17
+
18
+ ```bash
19
+ # 初始化配置
20
+ soke-cli auth login
21
+ ```
22
+
23
+ 配置项包括:
24
+ - `app_id`: 开放平台应用ID
25
+ - `app_key`: 开放平台应用Key
26
+ - `app_secret`: 开放平台应用Secret
27
+ - `api_base_url`: API地址(默认: https://opendev.soke.cn)
28
+ - `corpid`: 企业ID
29
+
30
+ 配置文件保存在 `~/.soke-cli/config.json`
31
+
32
+ ## 认证
33
+
34
+ ### 用户登录
35
+
36
+ 用户需要通过OAuth授权获取访问令牌:
37
+
38
+ ```bash
39
+ # 用户登录授权
40
+ soke-cli auth login
41
+ ```
42
+
43
+ 登录成功后,`access_token` 和 `refresh_token` 会自动保存到配置文件中。
44
+
45
+ ### Token管理
46
+
47
+ - **access_token**: 用户访问令牌,用于调用API
48
+ - **refresh_token**: 刷新令牌,用于获取新的access_token
49
+ - Token过期后需要重新执行 `soke-cli auth login`
50
+
51
+ ### 查看当前配置
52
+
53
+ ```bash
54
+ # 查看当前配置(不显示敏感信息)
55
+ soke-cli config show
56
+ ```
57
+
58
+ ## 权限不足处理
59
+
60
+ 遇到权限相关错误时,通常有以下几种情况:
61
+
62
+ ### 1. 未登录或Token过期
63
+
64
+ **错误特征**: 返回401 Unauthorized或Token无效
65
+
66
+ **解决方案**:
67
+ ```bash
68
+ soke-cli auth login
69
+ ```
70
+
71
+ ### 2. 缺少必要权限
72
+
73
+ **错误特征**: 返回403 Forbidden或权限不足提示
74
+
75
+ **解决方案**:
76
+ - 联系管理员在开放平台后台为应用开通相应权限
77
+ - 确认企业ID(corpid)和应用配置正确
78
+
79
+ ### 3. 参数错误
80
+
81
+ **错误特征**: 返回400 Bad Request或参数验证失败
82
+
83
+ **解决方案**:
84
+ - 检查必需参数是否提供
85
+ - 使用 `--help` 查看命令参数说明
86
+ - 参考API文档确认参数格式
87
+
88
+ ## 命令结构
89
+
90
+ ### Shortcuts(推荐)
91
+
92
+ Shortcuts是对常用操作的高级封装,参数友好,最适合AI Agent调用:
93
+
94
+ ```bash
95
+ soke-cli <service> +<verb> [flags]
96
+ ```
97
+
98
+ 示例:
99
+ ```bash
100
+ soke-cli exam +get-exam-user --exam-id exam123 --dept-user-id user456
101
+ soke-cli course +list-courses --page 1 --page-size 10
102
+ ```
103
+
104
+ ### 通用API调用
105
+
106
+ 支持直接调用任意API:
107
+
108
+ ```bash
109
+ soke-cli api <METHOD> <path> [--data <json>] [--params <json>]
110
+ ```
111
+
112
+ 示例:
113
+ ```bash
114
+ soke-cli api GET /users/me
115
+ soke-cli api POST /some/endpoint --data '{"key": "value"}'
116
+ ```
117
+
118
+ ## 输出格式
119
+
120
+ ### JSON格式(默认)
121
+
122
+ 所有命令默认输出JSON格式,便于程序解析:
123
+
124
+ ```bash
125
+ soke-cli exam +list-exams --format json
126
+ ```
127
+
128
+ ### 表格格式
129
+
130
+ 部分命令支持表格格式输出,更易读:
131
+
132
+ ```bash
133
+ soke-cli exam +list-exams --format table
134
+ ```
135
+
136
+ ## 安全规则
137
+
138
+ - **禁止输出密钥**(app_secret、access_token)到终端明文
139
+ - **写入/删除操作前必须确认用户意图**
140
+ - 敏感操作建议先使用 `--dry-run`(如果支持)预览
141
+
142
+ ## 错误处理
143
+
144
+ 当命令执行失败时:
145
+
146
+ 1. **检查配置**: 运行 `soke-cli config show` 确认配置正确
147
+ 2. **检查登录状态**: 如果是认证错误,运行 `soke-cli auth login`
148
+ 3. **检查参数**: 使用 `soke-cli <service> <command> --help` 查看参数说明
149
+ 4. **查看错误信息**: 错误响应中通常包含详细的错误原因
150
+
151
+ ## 常见问题
152
+
153
+ ### Q: 如何获取app_key和app_secret?
154
+
155
+ A: 登录授客AI开放平台(https://opendev.soke.cn),创建应用后即可获取。
156
+
157
+ ### Q: Token过期了怎么办?
158
+
159
+ A: 重新执行 `soke-cli auth login` 进行授权。
160
+
161
+ ### Q: 如何切换企业?
162
+
163
+ A: 运行 `soke-cli auth login` 重新配置,或直接编辑 `~/.soke-cli/config.json` 文件。
164
+
165
+ ### Q: 支持哪些业务模块?
166
+
167
+ A: 目前支持以下模块:
168
+ - `contact`: 组织架构(部门、用户、岗位、讲师)
169
+ - `course`: 课程管理
170
+ - `exam`: 考试管理
171
+ - `training`: 培训管理
172
+ - `learning_map`: 学习地图
173
+ - `credit`: 学分管理
174
+ - `point`: 积分管理
175
+ - `news`: 资讯管理
176
+ - `certificate`: 证书管理
177
+ - 等等...
178
+
179
+ 每个模块都有对应的Skill,AI Agent会根据用户意图自动选择。
180
+
181
+ ## 相关链接
182
+
183
+ - 授客AI开放平台: https://opendev.soke.cn
184
+ - NPM包: @sokeai/cli
185
+ - 代码仓库: https://codeup.aliyun.com/5edbc121d1d1abe63b55f1c7/soke/soke-cli.git
@@ -0,0 +1,177 @@
1
+ # 全流程 SOP — Phase 1-6 详细操作
2
+
3
+ ## Phase 1: 创建课程骨架
4
+
5
+ ### Step 1.1: 权限检查
6
+ 目标: 确认用户已登录且有创建课程权限
7
+ 自身: soke-cli config show
8
+ 输出: 登录状态
9
+ 失败: 引导 soke-cli auth login
10
+
11
+ ### Step 1.2: 获取分类
12
+ 读取: subs/category/SOP.md 执行
13
+ 输入: 用户指定的分类关键词(可选)
14
+ 操作:
15
+ 用户指定名称 → course +list-categories → 精确匹配 → 模糊匹配 → 列全部
16
+ 用户不指定 → 列出所有 → 让用户选
17
+ "随便" → 取第一个
18
+ 无分类 → 提示创建(⚠️ CLI 不支持 → 告知后台路径)
19
+ 提取: category-id → 存上下文
20
+ 失败: 列所有分类让用户手动选
21
+
22
+ ### Step 1.3: 创建课程
23
+ 自身: course +create --title "xxx" --category-id "xxx"
24
+ 可选: --description "..."
25
+ 提取: course-id + title + category + status → 存上下文
26
+ 失败: 检查标题长度、分类 UUID 有效性
27
+
28
+ Gate 1→2: ✅ course-id 非空
29
+
30
+ ---
31
+
32
+ ## Phase 2: 构建课件
33
+
34
+ ### Step 2.1: 选择素材来源
35
+ → `ask_user_question` 弹窗: "从哪儿添加课件素材?" → ["📁 本地上传"/"📚 素材库选择"]
36
+ 选"本地上传" → 进入 Step 2.2
37
+ 选"素材库选择" → 进入 Step 2.2b
38
+
39
+ ### Step 2.2: 本地上传
40
+ 调度: soke-material
41
+ 告知: 可上传视频(.mp4/.avi/.mov/.mkv/.webm)、音频(.mp3/.wav/.ogg/.flac/.aac)、文档(.pdf/.ppt/.pptx/.doc/.docx/.xls/.xlsx)
42
+ ⚠️ 不支持 CLI: 图片/文章/外链/小测验/作业 → 告知后台路径
43
+ 输入: 本地文件路径
44
+ 操作: file +upload --path <path>(自动根据扩展名判断类型)
45
+ 输出: { uuid, filename, type, ext, filesize, object }
46
+ 提取: media-id + 全字段 → 存 media_ids[] 数组
47
+ 失败: 检查文件存在/格式/大小
48
+ → 进入 Step 2.3
49
+
50
+ ### Step 2.2b: 素材库选择
51
+ 调度: soke-material
52
+ 操作: file list-files --page-size 100(分页拉取)
53
+ 展示: 文件名 / 类型 / 大小 / 日期(截取前 20-50 条)
54
+ 告知: "输入关键词搜索素材,或输入序号选择"
55
+ 用户输入:
56
+ - 关键词 → 模糊匹配文件名 → 弹窗列匹配项
57
+ - 序号 → 直接确认该素材
58
+ 提取: 全字段 → 存 media_ids[]
59
+ 无匹配: 弹窗 "素材库中没找到,切到本地上传?" → ["切本地上传"/"重新搜索"]
60
+ 选"切本地上传" → 回到 Step 2.2
61
+ → 进入 Step 2.3
62
+
63
+ ### Step 2.3: 创建课件
64
+ 调度: soke-lesson
65
+ 输入: course-id + 所有 Step 2.2 字段 + 自定义 title
66
+ 操作: course +lesson-create --course-id <uuid> --title "..." --media-id <uuid> --type video|audio|document --length <s> --object "..." --filename "..." --ext "..." --filesize <bytes>
67
+ 输出: { uuid, title, type, transcode_status }
68
+ 提取: lesson-id → 存 lesson_ids[] 数组
69
+
70
+ ### Step 2.4: 循环
71
+ 询问: "还要加课件吗?"
72
+ 是 → 回到 Step 2.1
73
+ 否 → 进入 Step 2.5
74
+
75
+ ### Step 2.5: 排序(可选)
76
+ 询问: "要调整课件顺序吗?"
77
+ 是 → 调度 soke-lesson 排序
78
+ 否 → 进入 Phase 3
79
+
80
+ Gate 2→3: ✅ lesson_ids 长度 ≥ 1
81
+
82
+ ---
83
+
84
+ ## Phase 3: 课程设置
85
+
86
+ ### Step 3.1: 基础设置
87
+ 读取: subs/settings/SOP.md 执行
88
+ 输入: course-id + 要修改的字段
89
+ 操作: course +update --course-id <uuid> --title "..." --description "..."
90
+ 成功: 更新后数据
91
+ 失败: 检查字段有效性
92
+
93
+ ### Step 3.2: 高级设置
94
+ 调度: soke-course-settings
95
+ 操作: course +advanced --course-id <uuid> ...
96
+ 支持: 学习模式/待办推送/截止后学习/人脸识别/学习中人脸识别/未学提醒/倍速/拖动/评价/交流群二维码/文档防挂机/评论
97
+ 交流群二维码: 用户给本地图片时,使用 course +advanced --image-file <path>,命令内部只上传 OSS 并生成 imageOssUrl,不进入图片库
98
+ 证书/签名仍需后台操作。
99
+
100
+ ### Step 3.3: 收费设置(可选)
101
+ 读取: subs/charge/SOP.md 执行
102
+ 全部 ⚠️ CLI 不支持:
103
+ "收费设置(价格/试看)需在后台→课程编辑→收费设置中手动配置。"
104
+
105
+ Gate 3→4: 无硬阻塞(设置可跳过)
106
+
107
+ ---
108
+
109
+ ## Phase 4: 发布
110
+
111
+ ### Step 4.1: Gate Check
112
+ 读取: subs/publish/SOP.md 执行
113
+ 检查项:
114
+ ① 标题非空 — course +get-course → title
115
+ ② 分类已选 — course +get-course → category_id
116
+ ③ 课件 ≥ 1 — course +lesson-list → count
117
+ ④ 无转码失败 — course +lesson-list → 逐条 transcode_status
118
+ ⑤ 无转码中 — course +lesson-list → 逐条(警告)
119
+ 结果:
120
+ 全部通过 → 执行发布
121
+ 阻塞项 → 列出 + 修复指引,停止
122
+ 仅警告 → 询问是否忽略
123
+
124
+ ### Step 4.2: 执行发布
125
+ 直接发布: course +publish --course-id <uuid>
126
+ 定时发布: course +publish --course-id <uuid> --publish-time "<北京时间>"
127
+ 提取: 发布状态 → 存上下文
128
+ 失败: 检查 Gate Check 结果
129
+
130
+ ### Step 4.3: 后续(可选)
131
+ 审批/批量 → ⚠️ CLI 不支持 → 告知后台路径
132
+
133
+ Gate 4→5: ✅ status=1
134
+
135
+ ---
136
+
137
+ ## Phase 5: 指派学员
138
+
139
+ ### Step 5.1: 拉取全量部门
140
+ 调度: soke-assign
141
+ exec: soke assign +list-departments
142
+ 提取: 全量部门名称+ID → 存内存(供模糊搜索用)
143
+
144
+ ### Step 5.2: 用户输入关键词搜索部门
145
+ 告知: "请输入要指派的部门名称(支持模糊搜索)"
146
+ 用户输入关键词 → 在部门列表中模糊匹配(不区分大小写、部分匹配)
147
+ 匹配结果:
148
+ - 唯一匹配 → 直接确认使用
149
+ - 多个匹配 → `ask_user_question` 弹窗列出匹配项让用户选
150
+ - 无匹配 → 建议换关键词,或弹窗列所有部门
151
+
152
+ ### Step 5.3: 确认指派方式
153
+ → `ask_user_question` 弹窗: "必修还是选修?" → ["必修"/"选修"]
154
+
155
+ ### Step 5.4: 执行指派
156
+ 调度: soke-assign
157
+ 操作: assign +create --module course --module-id <uuid> --compulsory 1|0 --user-ids "<ids>"
158
+ 输出: 指派 UUID + 指派人数
159
+ 通知: "已指派 N 人,学员将收到学习通知"
160
+
161
+ ---
162
+
163
+ ## Phase 6: 运营维护
164
+
165
+ ### Step 6.1: 查询进度
166
+ 读取: subs/query/SOP.md 执行
167
+ 操作: course +list-course-users / +get-course-user / +list-lesson-learns / +list-lesson-faces
168
+
169
+ ### Step 6.2: 关闭/删除
170
+ 读取: subs/publish/SOP.md 执行
171
+ 关闭: course +update --course-id <uuid> --action close
172
+ 删除: 先查 status,仅 status=0 未发布或 status=2 已关闭时执行 course +delete --course-id <uuid>
173
+ 阻塞: status=1 已发布课程不能直接删除,先关闭再删除
174
+
175
+ ### Step 6.3: 复制(⚠️ CLI 不支持)
176
+ 读取: subs/copy/SOP.md 执行
177
+ 告知: "课程复制需在后台→已发布/已关闭列表→复制中操作"
@@ -0,0 +1,66 @@
1
+ # 课件类型创建 SOP
2
+
3
+ ## 支持的课件类型(CLI 可用)
4
+
5
+ ### video(视频课件)
6
+
7
+ **判断**: 文件后缀 .mp4|.avi|.mov|.mkv|.webm|.flv|.wmv
8
+
9
+ **流程**:
10
+ 1. 调度 soke-material → file +upload --file <video.mp4>
11
+ 2. 提取: { uuid, filename, type: "video", ext, filesize, object }
12
+ 3. 调度 soke-lesson → course +lesson-create --type video --length <秒> ...(参数全部来自步骤2)
13
+
14
+ **配置项**(⚠️ CLI 暂不支持):
15
+ - 积分设置(完成获得)
16
+ - 下载开关
17
+ - 弹出学习格言
18
+ - 弹出测试题(1-5个节点,按视频时长百分比)
19
+ - 观看监控提示语
20
+ → 告知用户: "视频课件的高级配置需在后台→课件编辑中设置"
21
+
22
+ ### audio(音频课件)
23
+
24
+ **判断**: .mp3|.wav|.ogg|.flac|.aac|.wma|.m4a
25
+
26
+ **流程**: 同 video,type=audio,默认 length=300s
27
+
28
+ ### document(文档课件)
29
+
30
+ **判断**: .pdf|.ppt|.pptx|.doc|.docx|.xls|.xlsx|.txt
31
+
32
+ **流程**: 同 video,type=document,默认 length=0s
33
+
34
+ ---
35
+
36
+ ## 不支持 CLI 的课件类型(告知后台路径)
37
+
38
+ ### image(图片课件)
39
+ **判断**: .jpg|.jpeg|.png|.gif|.webp|.bmp|.svg
40
+ **话术**: "图片课件暂不支持 CLI 创建。你可以先把图片上传到 photo-gallery,然后在后台→课程编辑→添加课件→选择图片库中操作。一张图片一个课件,无数量上限。"
41
+
42
+ ### article(文章课件)
43
+ **判断**: 用户输入纯文本 + 提到"文章"
44
+ **话术**: "文章课件暂不支持 CLI 创建。请在后台→课程编辑→添加课件→手动添加文章中编辑。"
45
+
46
+ ### link(外链课件)
47
+ **判断**: 用户输入含 http:// 或 https:// + 提到"链接"/"外链"
48
+ **话术**: "外链课件暂不支持 CLI 创建。请在后台→课程编辑→添加课件→添加外链中操作。"
49
+
50
+ ### quiz(小测验课件)
51
+ **判断**: 用户提到"测验"/"试卷"/"小测验"
52
+ **话术**: "小测验课件暂不支持 CLI 创建。你可以先用 soke-exam skill 创建试卷,然后到后台→课程编辑→添加课件→小测验中关联试卷。注意:小测验仅支持客观题(单选/多选/判断),不限次数的测验必须通过才能记录进度。"
53
+
54
+ ### homework(作业课件)
55
+ **判断**: 用户提到"作业"/"批改"
56
+ **话术**: "作业课件暂不支持 CLI 创建。请在后台→课程编辑→添加课件→作业中操作。作业支持三种审批方式:①无需批改(提交自动记录进度)②PC后台批改③移动端多级审批(按人员/角色/主管审批,或签/会签)。"
57
+
58
+ ---
59
+
60
+ ## 课件上传规则
61
+
62
+ - 上传文件自动转存素材库
63
+ - 都需经阿里云转码
64
+ - 转码中/失败 → 不能发布课程
65
+ - 上传失败时提示具体原因(文件超大小、格式不对)
66
+ - 发布后删减课件:对未完成进度有影响,已完成无影响
@@ -0,0 +1,76 @@
1
+ # 发布前置 Gate Check 完整矩阵
2
+
3
+ ## 校验清单
4
+
5
+ | # | 检查项 | 获取方式 | 严重度 | 不通过时提示 | 修复指引 |
6
+ |---|--------|---------|--------|-------------|---------|
7
+ | 1 | 课程标题非空 | `course +get-course` → `data.title` | 🔴 阻塞 | "课程标题不能为空" | 执行 `course +update --title "新标题"` |
8
+ | 2 | 课程分类已选 | `course +get-course` → `data.category_id` | 🔴 阻塞 | "课程分类不能为空" | 先查分类 `+list-categories`,再 `+update --category-id` |
9
+ | 3 | 课件数量 ≥ 1 | `course +lesson-list` → `data.list.length` | 🔴 阻塞 | "课程至少需要 1 个课件才能发布" | 进入 Phase 2 添加课件 |
10
+ | 4 | 所有课件无转码失败 | `course +lesson-list` → 逐条检查 `.transcode_status` | 🔴 阻塞 | "课件 [X] 转码失败,请删除后重新上传" | 删除失败课件,重新上传素材 |
11
+ | 5 | 所有课件无转码中 | `course +lesson-list` → 逐条检查 `.transcode_status` | 🟡 警告 | "课件 [X] 还在转码中,发布后学员暂时看不到该课件。确认发布吗?" | 可忽略警告继续,或等转码完成 |
12
+ | 6 | 课程未被学习地图关联(关闭时) | 需在后台检查 | 🟡 警告 | "该课程被学习地图关联,无法关闭" | 先在学习地图中移除此课程 |
13
+
14
+ ## 校验流程
15
+
16
+ ```
17
+ 开始 Gate Check
18
+
19
+
20
+ 逐项检查 ①-⑥
21
+
22
+ ├── 全部通过 → 执行发布
23
+
24
+ ├── 有 🔴 阻塞项 → 列出所有阻塞项 + 每项修复指引 → 停止发布
25
+
26
+ └── 仅 🟡 警告 → 列出警告 → 询问: "有 X 项警告,确认继续发布吗?"
27
+ ├── 确认 → 执行发布
28
+ └── 取消 → 先处理警告项
29
+ ```
30
+
31
+ ## 转码状态码对照
32
+
33
+ | 状态值 | 含义 | 能否发布 |
34
+ |--------|------|---------|
35
+ | success | 转码成功 | ✅ |
36
+ | transcoding | 转码中 | ⚠️ 可忽略警告发布,但学员暂时看不到 |
37
+ | failed | 转码失败 | ❌ 阻塞,必须删除重传 |
38
+ | pending | 待转码 | ⚠️ 同 transcoding |
39
+
40
+ ## 发布后验证
41
+
42
+ 发布后执行:
43
+ 1. `course +get-course --course-id <uuid>` → 确认 `status == 1`
44
+ 2. `course +lesson-list --course-id <uuid>` → 确认课件状态
45
+
46
+ ## 审批流程(⚠️ CLI 暂不支持)
47
+
48
+ - 默认关闭
49
+ - 开启后: 未发布课程需审批才能发布
50
+ - 审批通过 → 发布成功
51
+ - 审批驳回 → 修改后可重新提交
52
+ - 审批人为空 → 默认通过
53
+ - 多级审批: 一级不可删除,默认主管理员和或签
54
+
55
+ ## 定时发布
56
+
57
+ - 执行: `course +publish --course-id <uuid> --publish-time "<北京时间>"`
58
+ - 输入北京时间,会在规定时间发布课程
59
+ - 到时间点自动发布并推送消息
60
+ - 未到点时学员收不到消息、前端看不到
61
+
62
+ ## 批量操作(⚠️ CLI 暂不支持)
63
+
64
+ - 批量发布: 跨页最多选 40 条
65
+ - 批量指派: 增量不是替换
66
+
67
+ ## 课程状态流转
68
+
69
+ ```
70
+ 上传 → 上传成功 → 转码中 → 未发布(status=0) → 发布(status=1)
71
+
72
+ 已关闭(status=2)
73
+ 上传 → 上传失败(可修改重试)
74
+ 转码 → 转码失败(可删除重传)
75
+ 未发布 → 编辑/删除/提交审批
76
+ ```
@@ -0,0 +1,153 @@
1
+ ---
2
+ name: soke-course-ai
3
+ version: 1.0.0
4
+ description: AI做课(远期规划) — 7项AI功能概述,全部需后台操作
5
+ tags: [soke, ai, smart-generation, auto-courseware, future]
6
+ ---
7
+
8
+ # AI做课(远期规划)
9
+
10
+ ## 触发描述
11
+
12
+ 用户询问是否支持 AI 自动生成课程、AI 智能出题、AI 课件制作等功能时触发本技能。以下所有功能均为远期规划,CLI 不支持,需通过后台操作。
13
+
14
+ ## ⚠️ CLI 不支持
15
+
16
+ 所有 AI 做课功能均需前往:
17
+
18
+ ```
19
+ 后台 → 课程管理 → AI做课
20
+ ```
21
+
22
+ ## AI 功能全景
23
+
24
+ ### 1. AI 智能生成 `smart_generation`
25
+
26
+ 自动生成课程核心元信息:
27
+
28
+ - **课程标题**:根据输入主题/关键词生成多个备选标题
29
+ - **课程封面**:AI 生成课程封面图(多种风格可选)
30
+ - **课程描述**:自动撰写课程简介和学习目标
31
+ - **讲师介绍**:生成讲师简介文案
32
+
33
+ ```
34
+ 后台 → 课程管理 → AI做课 → 智能生成
35
+ ```
36
+
37
+ ### 2. AI 文件导入 `file_import`
38
+
39
+ 支持导入以下文件格式自动解析为课程结构:
40
+
41
+ | 格式 | 说明 |
42
+ |------|------|
43
+ | **Word (.docx)** | 解析标题层级生成章节,正文生成课件内容 |
44
+ | **Xmind (.xmind)** | 解析思维导图结构,中心主题→课程,分支→章节 |
45
+ | **Freemind (.mm)** | 同上,FreeMind 思维导图格式 |
46
+ | **Markdown (.md)** | 解析 H1-H6 标题生成课程层级 |
47
+ | **PPT (.pptx)** | 每页幻灯片生成一节课件,讲义区生成课件描述 |
48
+
49
+ ```
50
+ 后台 → 课程管理 → AI做课 → 文件导入
51
+ ```
52
+
53
+ ### 3. AI 课件制作 `ai_lesson_creation`
54
+
55
+ 对视频/音频课件进行智能处理:
56
+
57
+ | 功能 | 说明 |
58
+ |------|------|
59
+ | **AI 字幕** | 自动语音识别 (ASR) 生成字幕,支持多语言 |
60
+ | **互动题** | 在视频播放中插入互动选择题,提升参与度 |
61
+ | **推荐题** | AI 分析课件内容后推荐相关练习题 |
62
+ | **随堂小测** | 课件学完后自动弹出 AI 生成的迷你测验 |
63
+
64
+ ```
65
+ 后台 → 课程管理 → AI做课 → 课件制作
66
+ ```
67
+
68
+ ### 4. AI 课上测验 `ai_in_class_quiz`
69
+
70
+ 基于课件内容自动生成课堂测验:
71
+
72
+ - 支持单选题、多选题、判断题
73
+ - 题目难度自动分级(简单/中等/困难)
74
+ - 批量生成,人工审核后发布
75
+
76
+ ```
77
+ 后台 → 课程管理 → AI做课 → 课上测验
78
+ ```
79
+
80
+ ### 5. AI 智能学习 `ai_smart_learning`
81
+
82
+ 构建课程知识库以实现智能化学习体验:
83
+
84
+ - 提取课件核心知识点建立知识图谱
85
+ - 学员可向 AI 提问课程相关问题
86
+ - AI 根据学员薄弱点推荐复习内容
87
+ - 支持知识库自定义补充 FAQ
88
+
89
+ ```
90
+ 后台 → 课程管理 → AI做课 → 智能学习
91
+ ```
92
+
93
+ ### 6. AI 作业 `ai_homework`
94
+
95
+ AI 辅助作业设计:
96
+
97
+ - 根据课程内容自动生成作业题目
98
+ - 支持主观题 AI 辅助批改
99
+ - 生成作业参考答案与评分标准
100
+ - 个性化作业推荐(薄弱知识点针对性练习)
101
+
102
+ ```
103
+ 后台 → 课程管理 → AI做课 → AI作业
104
+ ```
105
+
106
+ ### 7. AI 绘图 `ai_art`
107
+
108
+ AI 生成课程视觉素材:
109
+
110
+ - **课程封面生成**:多种风格(扁平、3D、手绘、科技、商务等)
111
+ - **课件配图**:根据课件内容自动生成插图
112
+ - **证书背景**:AI 生成结业证书背景图
113
+ - **品牌素材**:课程 Logo、水印等视觉元素
114
+
115
+ ```
116
+ 后台 → 课程管理 → AI做课 → AI绘图
117
+ ```
118
+
119
+ ## 输出标准
120
+
121
+ 当用户询问 AI 做课功能时,输出:
122
+
123
+ ```
124
+ 🤖 AI 做课功能(远期规划 — 全部需后台操作)
125
+
126
+ 支持 7 大功能,入口:后台 → 课程管理 → AI做课
127
+
128
+ 1. 智能生成 — 标题/封面/描述/讲师
129
+ 2. 文件导入 — Word/Xmind/Freemind/Markdown/PPT
130
+ 3. 课件制作 — 字幕/互动题/推荐题/随堂小测
131
+ 4. 课上测验 — 自动出题,多题型,难度分级
132
+ 5. 智能学习 — 知识库 + AI问答 + 智能推荐
133
+ 6. AI 作业 — 自动出题 + 辅助批改 + 个性化推荐
134
+ 7. AI 绘图 — 封面/配图/证书背景/品牌素材
135
+
136
+ ⚠️ 以上功能 CLI 均不支持,请前往后台操作。
137
+ ```
138
+
139
+ ## 注意事项
140
+
141
+ 1. 以上功能为远期规划,具体上线时间和功能范围以产品实际发布为准
142
+ 2. AI 生成内容(标题/描述/题目/封面等)建议人工审核后使用
143
+ 3. 文件导入的解析效果取决于源文件格式规范程度,建议导入后检查结构完整性
144
+ 4. AI 字幕的识别准确率受视频音频质量影响,建议提供清晰音质的素材
145
+ 5. AI 作业批改仅适用于客观题和结构化主观题,开放性问题准确率有限
146
+ 6. AI 绘图生成的视觉素材建议确认版权和使用条款后再投入使用
147
+ 7. 所有 AI 功能均需消耗 AI 调用配额,具体额度以租户套餐为准
148
+
149
+ ## 检查清单
150
+
151
+ - [ ] 用户已了解所有 AI 功能为远期规划
152
+ - [ ] 用户已确认需要前往后台操作
153
+ - [ ] 如涉及具体功能,已提供对应后台路径