SuperAPI AI 工具集

track-ai-plans

编程与开发

查看项目

更新于 10-15 22:38

技能介绍

用途:本技能用于把长时间、多步骤的 AI 实施工作以 Plans 的形式记录在 Git 仓库中,使另一台机器或另一个智能体无需重述意图也能继续工作。qing-plans/ 充当项目持久记忆:用户目标、计划设计原因、各阶段变更、受影响模块、观察与验证结果、下一步动作。

使用方式:以 Git 顶层目录为 ROOT,将 PLANCTL 指向本技能自身的 scripts/planctl.py,所有命令以 python3 "$PLANCTL" --root ROOT ... 形式运行。仓库只存放计划数据与 dashboard.html,不含运行时,因此首次建计划前与后续机器上命令一致。若 qing-plans/index.json 存在,先 validate 再 resume;无当前计划时 resume 会找出一个未完成草稿或列出候选草稿。仅有 plans/index.json 时为只读的 V1,改动前需读 references/migration.md。两者同时存在时,仅当 qing-plans/migration.json 已验证才继续。暂停的计划是当前计划但不会自动恢复,需先向用户确认再改生命周期。

主要能力与路由:创建计划或定义模块读 references/create-plan.md;续做、检查点或改活动范围读 references/work-plan.md;记录测试、模型审查或人工证据读 references/verify-plan.md;激活/暂停/完成/取消/替换读 references/plan-lifecycle.md;迁移 V1 读 references/migration.md;诊断 JSON 或仪表盘投影读 references/schema.md。核心规则包括:index.json 独掌生命周期状态与当前计划;新计划默认 review 策略为 single,普通工作可用 none;single 要求一个真正独立的智能体审查不可变计划修订与项目地图。不可直接编辑活动范围,须用 propose-amendment 提议修正。文件变更以 changeSets 按模块与原因分组。依赖只有 A dependsOn B 一个方向。验证尝试只追加。只有人工授权命令才能激活、暂停、恢复、完成、取消或替换计划。所有变更须经 $PLANCTL 执行。

交接:停止时用 checkpoint 记录当前项、停止原因与具体下一步;在重要里程碑把 qing-plans/ 与代码一同提交并推送分支。工作树脏、缺上游或未推送会使检查点仅限本地。resume 是确定性的,并按顺序检查待办修正/审查门、进行中项、失败或阻塞项、首个依赖就绪项,再做完成检查。

仪表盘:create 与 migration 会安装 qing-plans/dashboard.html 及锁文件 .gitignore。仪表盘通过 HTTP 获取 status.json,file:// 会被阻止;运行 serve 启动绑定 127.0.0.1 的本地服务器并打开默认浏览器(--port 指定端口,--no-open 跳过启动浏览器)。可用 scripts/create_dashboard_fixture.sh EMPTY_ROOT 生成虚拟项目做仪表盘 QA。

限制:资料未提供收费、价格、平台支持范围等信息;命令与脚本名须保持原样,具体参数细节以相应参考文件为准。