@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.
- package/package.json +1 -1
- package/scripts/install.js +2 -2
- package/scripts/local-test.js +1 -1
- package/scripts/test-auto-detect.js +20 -3
- package/skills/README.md +25 -174
- package/skills/SKILL.md +17 -239
- package/skills/mono/README.md +10 -0
- package/skills/mono/SKILL.md +223 -0
- 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
- package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/README.md +2 -1
- package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-engineer/parts/part1-basic.md +1 -1
- package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/publish-gate.md +1 -0
- package/skills/mono/references/modules/soke-ai-coach-director/platform/soke-ai-training/soke-ai-training.md +123 -0
- package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/exec-handbook.md +5 -5
- package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/exec-part1.md +5 -5
- package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/platform-api-pitfalls.md +1 -1
- package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/subs/part1/SOP.md +2 -2
- package/skills/mono/references/modules/soke-ai-coach-director/scripts/gate_check.py +114 -0
- package/skills/mono/references/modules/soke-ai-coach-director/scripts/validate_operations.py +410 -0
- package/skills/{soke-ai-training/SKILL.md → mono/references/modules/soke-ai-training/MODULE.md} +3 -1
- package/skills/mono/references/modules/soke-assign/README.md +308 -0
- package/skills/{soke-certificate/SKILL.md → mono/references/modules/soke-certificate/MODULE.md} +2 -2
- package/skills/mono/references/modules/soke-course/MODULE.md +402 -0
- package/skills/mono/references/modules/soke-course/README.md +291 -0
- package/skills/{soke-course → mono/references/modules/soke-course}/references/examples.md +3 -3
- package/skills/{soke-exam/SKILL.md → mono/references/modules/soke-exam/MODULE.md} +1 -1
- package/skills/{soke-learning-map/SKILL.md → mono/references/modules/soke-learning-map/MODULE.md} +5 -6
- package/skills/{soke-learning-profile/SKILL.md → mono/references/modules/soke-learning-profile/MODULE.md} +2 -2
- package/skills/mono/references/modules/soke-lesson/README.md +53 -0
- package/skills/mono/references/modules/soke-material/README.md +49 -0
- package/skills/{soke-photo-gallery/SKILL.md → mono/references/modules/soke-photo-gallery/MODULE.md} +2 -3
- package/skills/mono/references/modules/soke-supervisor/MODULE.md +186 -0
- package/skills/mono/references/modules/soke-task/MODULE.md +146 -0
- package/skills/{soke-training-demand/SKILL.md → mono/references/modules/soke-training-demand/MODULE.md} +1 -1
- package/skills/mono/references/shared/cli-basics.md +185 -0
- package/skills/mono/scripts/check_readiness.py +28 -0
- package/skills/{soke-ai-coach-director → mono}/scripts/validate_operations.py +2 -2
- package/skills/multi/README.md +18 -0
- package/skills/multi/soke-ai-coach-director/CHANGELOG.md +203 -0
- package/skills/multi/soke-ai-coach-director/README.md +124 -0
- package/skills/multi/soke-ai-coach-director/SKILL.md +220 -0
- package/skills/multi/soke-ai-coach-director/assets/ERRORS-TEMPLATE.md +5 -0
- package/skills/multi/soke-ai-coach-director/assets/FEATURE_REQUESTS-TEMPLATE.md +5 -0
- package/skills/multi/soke-ai-coach-director/assets/LEARNINGS-TEMPLATE.md +45 -0
- package/skills/multi/soke-ai-coach-director/assets/SKILL-TEMPLATE.md +177 -0
- package/skills/multi/soke-ai-coach-director/coaching/knowledge-packager/knowledge-packager.md +91 -0
- package/skills/multi/soke-ai-coach-director/coaching/prompt-engineer/parts/part1-basic.md +59 -0
- package/skills/multi/soke-ai-coach-director/coaching/prompt-engineer/parts/part2-roles.md +97 -0
- package/skills/multi/soke-ai-coach-director/coaching/prompt-engineer/parts/part3-flow.md +72 -0
- package/skills/multi/soke-ai-coach-director/coaching/prompt-engineer/parts/part4-scoring.md +87 -0
- package/skills/multi/soke-ai-coach-director/coaching/prompt-engineer/parts/part5-constraints.md +48 -0
- package/skills/multi/soke-ai-coach-director/coaching/prompt-engineer/prompt-engineer.md +76 -0
- package/skills/multi/soke-ai-coach-director/coaching/prompt-optimizer/prompt-optimizer.md +381 -0
- package/skills/multi/soke-ai-coach-director/coaching/role-profiler/role-profiler.md +87 -0
- package/skills/multi/soke-ai-coach-director/platform/adapters/README.md +68 -0
- package/skills/multi/soke-ai-coach-director/platform/adapters/qclaw.md +67 -0
- package/skills/multi/soke-ai-coach-director/platform/adapters/workbuddy.md +44 -0
- package/skills/multi/soke-ai-coach-director/platform/adapters/wukong.md +70 -0
- package/skills/multi/soke-ai-coach-director/platform/adapters/zework.md +89 -0
- package/skills/multi/soke-ai-coach-director/platform/api-fallback.md +262 -0
- package/skills/multi/soke-ai-coach-director/platform/interaction.md +103 -0
- package/skills/multi/soke-ai-coach-director/platform/publish-gate.md +45 -0
- package/skills/multi/soke-ai-coach-director/platform/resource-finalizer.md +103 -0
- package/skills/{soke-ai-coach-director → multi/soke-ai-coach-director}/platform/soke-ai-training/soke-ai-training.md +1 -1
- package/skills/multi/soke-ai-coach-director/platform/sync-engine.md +39 -0
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/skills/multi/soke-ai-coach-director/references/change-log-partwise-refactor.md +74 -0
- package/skills/multi/soke-ai-coach-director/references/env-check.md +146 -0
- package/skills/multi/soke-ai-coach-director/references/exec-common.md +126 -0
- package/skills/multi/soke-ai-coach-director/references/exec-handbook.md +621 -0
- package/skills/multi/soke-ai-coach-director/references/exec-part1.md +86 -0
- package/skills/multi/soke-ai-coach-director/references/exec-part2.md +145 -0
- package/skills/multi/soke-ai-coach-director/references/exec-part3.md +91 -0
- package/skills/multi/soke-ai-coach-director/references/exec-part4.md +187 -0
- package/skills/multi/soke-ai-coach-director/references/gate-check-matrix.md +46 -0
- 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
- package/skills/multi/soke-ai-coach-director/references/micro-tune-labels.md +30 -0
- package/skills/multi/soke-ai-coach-director/references/platform-api-pitfalls.md +49 -0
- package/skills/multi/soke-ai-coach-director/references/role-resource-matching.md +45 -0
- package/skills/multi/soke-ai-coach-director/references/self-improvement-examples.md +376 -0
- package/skills/multi/soke-ai-coach-director/references/self-learning-engine.md +489 -0
- package/skills/multi/soke-ai-coach-director/references/shared.md +185 -0
- package/skills/multi/soke-ai-coach-director/references/subs/part1/SOP.md +17 -0
- package/skills/multi/soke-ai-coach-director/references/subs/part2/SOP.md +34 -0
- package/skills/multi/soke-ai-coach-director/references/subs/part3/SOP.md +27 -0
- package/skills/multi/soke-ai-coach-director/references/subs/part4/SOP.md +31 -0
- package/skills/multi/soke-ai-coach-director/references/subs/publish/SOP.md +81 -0
- package/skills/multi/soke-ai-coach-director/references/subs/tune/SOP.md +92 -0
- package/skills/multi/soke-ai-coach-director/references/verified-cli-cheatsheet.md +56 -0
- package/skills/multi/soke-ai-coach-director/scripts/activator.sh +4 -0
- package/skills/multi/soke-ai-coach-director/scripts/error-detector.sh +4 -0
- package/skills/multi/soke-ai-coach-director/scripts/extract-skill.sh +7 -0
- package/skills/multi/soke-ai-coach-director/scripts/gate_check.py +114 -0
- package/skills/multi/soke-ai-coach-director/scripts/validate_operations.py +410 -0
- package/skills/multi/soke-ai-training/SKILL.md +249 -0
- 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
- package/skills/multi/soke-ai-training/references/shared.md +185 -0
- package/skills/{soke-assign → multi/soke-assign}/README.md +3 -5
- package/skills/multi/soke-assign/SKILL.md +101 -0
- package/skills/{soke-course/SKILL.md → multi/soke-assign/references/dependencies/soke-course.md} +1 -1
- package/skills/multi/soke-assign/references/dependencies/soke-exam.md +600 -0
- package/skills/multi/soke-assign/references/installation.md +451 -0
- package/skills/multi/soke-assign/references/shared.md +185 -0
- package/skills/multi/soke-certificate/SKILL.md +715 -0
- package/skills/multi/soke-certificate/references/installation.md +451 -0
- package/skills/multi/soke-certificate/references/shared.md +185 -0
- package/skills/{soke-course → multi/soke-course}/README.md +5 -7
- package/skills/multi/soke-course/SKILL.md +399 -0
- package/skills/multi/soke-course/agents/openai.yaml +7 -0
- package/skills/multi/soke-course/examples/create-basic.md +70 -0
- package/skills/multi/soke-course/references/course-list-courses.md +216 -0
- package/skills/multi/soke-course/references/dependencies/soke-assign.md +103 -0
- package/skills/multi/soke-course/references/dependencies/soke-lesson.md +119 -0
- package/skills/multi/soke-course/references/dependencies/soke-material.md +105 -0
- package/skills/multi/soke-course/references/examples.md +480 -0
- package/skills/multi/soke-course/references/installation.md +451 -0
- package/skills/multi/soke-course/references/intent-cases.md +99 -0
- package/skills/multi/soke-course/references/shared.md +185 -0
- package/skills/multi/soke-course/references/sop-full-workflow.md +177 -0
- package/skills/multi/soke-course/references/sop-lesson-types.md +66 -0
- package/skills/multi/soke-course/references/sop-publish-check.md +76 -0
- package/skills/multi/soke-course/references/subs/ai/SOP.md +153 -0
- package/skills/multi/soke-course/references/subs/category/SOP.md +112 -0
- package/skills/multi/soke-course/references/subs/charge/SOP.md +107 -0
- package/skills/multi/soke-course/references/subs/copy/SOP.md +80 -0
- package/skills/multi/soke-course/references/subs/publish/SOP.md +168 -0
- package/skills/multi/soke-course/references/subs/query/SOP.md +165 -0
- package/skills/multi/soke-course/references/subs/settings/SOP.md +136 -0
- package/skills/multi/soke-course/references/subs/template/SOP.md +223 -0
- package/skills/multi/soke-course/references/troubleshoot.md +68 -0
- package/skills/multi/soke-course/scripts/check_readiness.py +87 -0
- package/skills/multi/soke-exam/SKILL.md +598 -0
- package/skills/multi/soke-exam/references/exam-get-exam-user.md +212 -0
- package/skills/multi/soke-exam/references/installation.md +451 -0
- package/skills/multi/soke-exam/references/shared.md +185 -0
- package/skills/multi/soke-exam-question-pool/SKILL.md +121 -0
- package/skills/multi/soke-exam-question-pool/references/installation.md +451 -0
- package/skills/multi/soke-exam-question-pool/references/shared.md +185 -0
- package/skills/multi/soke-learning-map/SKILL.md +553 -0
- package/skills/multi/soke-learning-map/references/dependencies/soke-assign.md +103 -0
- package/skills/{soke-task/SKILL.md → multi/soke-learning-map/references/dependencies/soke-task.md} +1 -1
- package/skills/multi/soke-learning-map/references/installation.md +451 -0
- package/skills/multi/soke-learning-map/references/shared.md +185 -0
- package/skills/multi/soke-learning-profile/SKILL.md +221 -0
- package/skills/multi/soke-learning-profile/references/installation.md +451 -0
- package/skills/multi/soke-learning-profile/references/shared.md +185 -0
- package/skills/multi/soke-lesson/SKILL.md +117 -0
- package/skills/multi/soke-lesson/references/installation.md +451 -0
- package/skills/multi/soke-lesson/references/shared.md +185 -0
- package/skills/multi/soke-material/SKILL.md +103 -0
- package/skills/multi/soke-material/references/installation.md +451 -0
- package/skills/multi/soke-material/references/shared.md +185 -0
- package/skills/multi/soke-photo-gallery/SKILL.md +284 -0
- package/skills/multi/soke-photo-gallery/references/installation.md +451 -0
- package/skills/multi/soke-photo-gallery/references/shared.md +185 -0
- package/skills/multi/soke-shared/SKILL.md +183 -0
- package/skills/multi/soke-supervisor/SKILL.md +184 -0
- package/skills/multi/soke-supervisor/references/installation.md +451 -0
- package/skills/multi/soke-supervisor/references/shared.md +185 -0
- package/skills/multi/soke-task/SKILL.md +144 -0
- package/skills/multi/soke-task/references/installation.md +451 -0
- package/skills/multi/soke-task/references/shared.md +185 -0
- package/skills/multi/soke-training-demand/SKILL.md +219 -0
- package/skills/multi/soke-training-demand/references/installation.md +451 -0
- package/skills/multi/soke-training-demand/references/shared.md +185 -0
- package/skills/soke-course/scripts/check_readiness.sh +0 -82
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /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
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/CHANGELOG.md +0 -0
- /package/skills/{soke-ai-coach-director/SKILL.md → mono/references/modules/soke-ai-coach-director/MODULE.md} +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/assets/ERRORS-TEMPLATE.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/assets/FEATURE_REQUESTS-TEMPLATE.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/assets/LEARNINGS-TEMPLATE.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/assets/SKILL-TEMPLATE.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/knowledge-packager/knowledge-packager.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-engineer/parts/part2-roles.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-engineer/parts/part3-flow.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-engineer/parts/part4-scoring.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-engineer/parts/part5-constraints.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-engineer/prompt-engineer.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/prompt-optimizer/prompt-optimizer.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/coaching/role-profiler/role-profiler.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/adapters/README.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/adapters/qclaw.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/adapters/workbuddy.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/adapters/wukong.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/adapters/zework.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/api-fallback.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/interaction.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/resource-finalizer.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/platform/sync-engine.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/change-log-partwise-refactor.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/env-check.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/exec-common.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/exec-part2.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/exec-part3.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/exec-part4.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/gate-check-matrix.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/micro-tune-labels.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/role-resource-matching.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/self-improvement-examples.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/self-learning-engine.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/subs/part2/SOP.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/subs/part3/SOP.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/subs/part4/SOP.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/subs/publish/SOP.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/subs/tune/SOP.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/references/verified-cli-cheatsheet.md +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/scripts/activator.sh +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/scripts/error-detector.sh +0 -0
- /package/skills/{soke-ai-coach-director → mono/references/modules/soke-ai-coach-director}/scripts/extract-skill.sh +0 -0
- /package/skills/{soke-assign/SKILL.md → mono/references/modules/soke-assign/MODULE.md} +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/agents/openai.yaml +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/examples/create-basic.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/course-list-courses.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/intent-cases.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/sop-full-workflow.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/sop-lesson-types.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/sop-publish-check.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/ai/SOP.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/category/SOP.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/charge/SOP.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/copy/SOP.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/publish/SOP.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/query/SOP.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/settings/SOP.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/template/SOP.md +0 -0
- /package/skills/{soke-course → mono/references/modules/soke-course}/references/troubleshoot.md +0 -0
- /package/skills/{soke-exam → mono/references/modules/soke-exam}/references/exam-get-exam-user.md +0 -0
- /package/skills/{soke-exam-question-pool/SKILL.md → mono/references/modules/soke-exam-question-pool/MODULE.md} +0 -0
- /package/skills/{soke-lesson/SKILL.md → mono/references/modules/soke-lesson/MODULE.md} +0 -0
- /package/skills/{soke-material/SKILL.md → mono/references/modules/soke-material/MODULE.md} +0 -0
- /package/skills/{soke-shared/SKILL.md → mono/references/modules/soke-shared/MODULE.md} +0 -0
- /package/skills/{soke-ai-coach-director → mono}/scripts/gate_check.py +0 -0
- /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
- /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
- /package/skills/{soke-lesson → multi/soke-lesson}/README.md +0 -0
- /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
|
+
- [ ] 如涉及具体功能,已提供对应后台路径
|