SuperAPI AI 工具集

skf-drop-skill

通用与其它

查看项目

更新于 10-16 05:00

技能介绍

用途:skf-drop-skill 用于从 SKF 模块中移除技能,可针对单个技能版本或整个技能。它提供两种方式:软弃用(仅更新导出清单,保留磁盘文件)和硬清除(删除文件),随后重建平台上下文文件,使被移除的版本不再出现在其中。导出清单是事实来源,文件系统会同步更新。

主要能力:交互模式下每个破坏性动作都需用户明确确认,不会静默删除;无头模式自动以默认动作通过确认门并记录每次自动决策。工作流分四步:选择目标、执行移除、报告、工作流健康检查。内置安全规则包括:清除前必须通过确认门;存在其他未弃用版本时不得移除活动版本;不删除 SKF 未生成的内容;一次只加载一个步骤文件。

使用方式:通过 SKF 模块调用,激活时从 {project-root}/_bmad/skf/config.yaml 加载配置,解析 headless_mode(--headless 或 -H,或 preferences.yaml 中 headless_mode: true),并运行 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow 解析自定义配置。无头调用方所需的输入、标志、门映射、退出码和 SKF_DROP_SKILL_RESULT_JSON 信封见 references/invocation-contract.md。

适用场景:需要弃用或彻底移除某个技能版本、保持导出清单与磁盘状态一致、并让下游平台上下文文件同步更新的场景。

限制:无头模式下若 forbid_purge_in_headless 开启且模式为 purge,会以退出码 6 停止;草稿技能无法弃用,需交互运行或关闭该限制。若缺少必要辅助脚本、运行文件夹无法创建或输出目录不可写,会在首次提示前停止且不更改任何内容。具体安装与配置细节以官方资料为准,暂未提供更多信息。