用途:在技能的所有版本中安全地重命名技能。agentskills.io 规范要求名称与父目录名一致,因此重命名实际上是跨每个版本 9 处以上位置的协同迁移,该工作流以事务方式完成这一过程。
主要能力:先复制到新名称,校验所有引用已更新,仅在校验通过后删除旧名称;重建平台上下文文件以引用新名称。工作流分四步:Select & Validate(需确认)、Execute Rename、Report、Workflow Health Check(后三步自动推进)。
使用方式:从 references/select.md 开始逐步执行,一次只加载一个步骤文件,不预载后续步骤。激活时从 {project-root}/_bmad/skf/config.yaml 读取配置并绑定一次调用,解析 headless_mode、acknowledge_official、dry_run、old_name_arg 与 new_name_arg 等参数,并运行凭证解析:uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow。无头调用方所需的输入、标志、门控映射、输出、并发规则与 SKF_RENAME_SKILL_RESULT_JSON 结果信封见 references/invocation-contract.md,退出码见 references/exit-codes.md。
限制与规则:在新名称完全具现并校验通过前不得删除旧目录;校验失败即回滚(删除新目录)并终止;不得与已有技能名冲突;不得重命名非 SKF 生成的文件夹(由 select.md §4a 依据清单助手判定);每个辅助脚本都必需,不得手工代替其写入、扫描或检查;交互提示中输入 cancel、exit、[X]、q 或 :q 会以退出码 6 干净退出(halt_reason: user-cancelled);headless_mode 为 true 时按默认动作自动通过确认门控并记录每次自动决策。收费、价格、平台或效果资料暂未提供。