SuperAPI AI 工具集

pk-track

通用与其它

查看项目

更新于 10-15 22:13

技能介绍

pk-track 用于跟踪目标(KR)与实际进度,并处理执行类收件箱条目。前置条件为 .cockpit/ 目录存在,缺失则转 pk-init(mode new)并停止。首次运行需按 Snapshot Contract 加载快照并写入 SNAPSHOT_LOADED 标记,已有标记则跳过。

主要模式:light(日跟踪,更新 KR/action 进度)、deep(深度复盘,含根因分析与调整建议)、inbox-only(仅处理 domain=execution 的收件箱)。

写入范围:objective.md 的 KR.current、KI.current;plan.md 的 counters、last_track_date、last_review_date 并重渲染 Roadmap;actions/.md 的 status、completed_date、## Output/Deliverable;log/.md 追加;inbox 条目状态变更;已完成动作与已处理收件箱归档。不得修改 Objective 文本、KR target、action title/due_date/deps,需改动时委托 pk-init/pk-plan(pre_confirmed: true)。

流程要点:先展示 Dashboard 再询问更新;写入前需用户确认,字段少用一行、多则用表格;KR/KI 数字输入需过 Quality Gate;写 action body 前必须先读当前 body 以防覆盖;写完后 objective.md 的 @ 块缓存失效,后续技能需从磁盘重读。light 仅写 last_track_date,deep 另写 last_review_date。deep 发现新知识时调用 pk-capture 生成 domain=knowledge 收件箱,pk-track 不直接写 knowledge。处理 related_inbox 配对条目时需提醒用户由 pk-distill 处理另一半。

限制与约束:不得修改行动结构(title、due_date、deps);不得写入 knowledge/skills/workflows;所有写入前需确认;归档按 schemas.md;遇到业务序列号空缺(如 B3→B5)需先向用户确认再编号;action ID 序列校验属 pk-plan 职责。具体安装方式暂未提供。