SuperAPI AI 工具集

skf-export-skill

智能体与模型

查看项目

更新于 10-15 19:57

技能介绍

用途:这是 SKF(Skill Forge)模块中的导出与发布关卡。create-skill 和 update-skill 只产出草稿,只有 export-skill 会写入上下文文件并把技能登记到 .export-manifest.json。

主要能力:按 agentskills.io 导出规范校验已完成的技能包;生成上下文片段(context snippet);更新 CLAUDE.md、AGENTS.md 或 .cursorrules 中的受管区段;输出 token 报告与运行摘要;执行工作流健康检查。

使用方式:工作流分 7 个阶段——加载技能、打包、生成片段、更新上下文、Token 报告、摘要、健康检查。启动时从 {project-root}/_bmad/skf/config.yaml 读取配置,解析 headless 模式(--headless 或 -H,或 sidecar preferences.yaml 中 headless_mode: true),并通过 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow 解析自定义配置。无头模式创建运行目录:mkdir -p "{project-root}/_bmad-output/.skf-run" && mktemp -d "{project-root}/_bmad-output/.skf-run/skf-export-skill-XXXXXXXX"。交互式提示中输入 cancel、exit、[X]、q 或 :q 会以退出码 6 干净退出。

适用场景:需要把开发完成的 SKF 技能发布到项目上下文文件、并纳入统一清单管理的场景。

限制:依赖多个共享脚本(如 skf-emit-result-envelope.py、skf-manifest-ops.py、skf-rebuild-managed-sections.py 等),缺失任一脚本会以退出码 4 中止;受管区段与清单格式由共享契约约束,修改会影响 export-skill、drop-skill、rename-skill 三个技能;片段在步骤 4 §9c 才写入技能包,取消、dry-run 或提前中止不会留下片段。具体收费、平台支持等信息暂未提供。