SuperAPI AI 工具集

playbooks

编程与开发

查看项目

更新于 10-15 20:10

技能介绍

用途:Playbooks 用于把个人或团队希望项目遵循的规则集中管理。每条 play 说明“这样做、不那样做”,并附理由与适用范围;所有编写或评审代码的角色都会读取这些 play。

来源与优先级:依次为个人文件 ~/.claude/aida/playbook.md(每台机器、所有项目)、项目文件 <projectPath>/playbook.md、项目声明的各 playbook 文件夹(按声明顺序,根目录放 playbook.md)、以及 project.json 中 playbookSubscriptions 记录的目录集(每个框架一套)。play 的 id 由来源与标题 slug 组成,打开 id 所指文件可读全文。

格式:## <Domain> 开启领域,### <Title> 开启一条 play,后接 What:、Rationale:、When it applies:、Example: 四个字段,示例为围栏代码块。缺少 What 时以标题代替并警告一次,不会拒绝加载。编辑或删除 play 即编辑对应 markdown 文件。

用法:list [<projectPath>] 每行输出 <id> <title>,来源为空时打印 <source>: none。capture 用于手工新增 play,需提供 domain、title、what、rationale、when,示例可写入文件后通过 --example-file 传入;命令为 "${CLAUDE_PLUGIN_ROOT}"/skills/playbooks/scripts/playbook-actions.sh capture "<projectPath>" --domain "<H2>" --title "<title>" --what "<text>" --rationale "<text>" --when "<text>" [--example-file <path>]。退出码 1 表示同 slug 已存在,需换标题。load <task_folder> 由研究流程在开始时自动运行,生成 records/playbooks.json 与 records/playbooks.md,个人无需手动执行;它不抓取外部内容,无法访问的订阅集记为 unreachable。退出码 79 表示任务在 worktree 中构建而当前窗口不在其中,需按提示切换后重跑。

限制:资料未提供收费、价格、平台支持范围及效果数据。