用途:在仓库 plans/ 目录中以 plans/YYYY-MM-DD-topic.md 记录想法、设计草稿和进行中的工作。每个计划一个文件,YAML frontmatter 的 status 字段让生命周期无需打开文件即可见,plans/ 被限定为工作集而非永久归档。
主要能力:plans.py(仅用标准库,除注明外只读)负责所有机械步骤,包括决定计划所在目录、生成正确 frontmatter、状态索引、tag 检索、晋升与删除门禁、入站引用。计划可放在仓库的 plans/、plans store,或两者(both 读两个、写一个)。store 用 repos.toml 把仓库身份链接到文件夹。
使用方式:每条命令写全路径,shell 变量在 Bash 调用之间不保留。常用命令如 python3 ~/.agents/skills/plan-conveyor/scripts/plans.py list、where、new <topic>、set-status <file> <status>、tags --tag DEFERRED、move、rename、attach、migrate start/check/finish、refs、archive、scan、push、links fix、install --explain;读命令支持 --json。status 与 updated 只由 set-status 写入,不手改 frontmatter。
适用场景:跨 repo 管理计划;员工或客户仓库无法添加 plans/ 时改用 store;需要发布计划 store 前扫描私有名称。
限制:网络仅 push 且只推 store 到其已有远端,不会新增远端或推送仓库,扫描发现私有名称即拒绝。多数命令离线。删除只通过 migrate finish --delete-sources 且需覆盖门禁通过;其他命令不写文件。设备配置分 contractor(默认)与 work,work 设备不分 tier,tier 报告为 null,并以 sanctioned_remotes 限制可推送远端。私有可见性需自行设置,脚本不发起网络检查。