用途:pk-init 负责 Project Cockpit 的初始化与目标/工具配置维护。模式分三种:new 在尚无 .cockpit/ 时创建完整结构、SCHEMA.md 与各 registry;update-objective 修改目标文本、KR/KI 目标、起止日期、容量、预算、缺口风险等;update-tools 增删工具。
主要能力:new 模式依次执行 mkdir -p .cockpit/{actions,inbox,raw,log,archive/{actions,inbox,knowledge,skills,workflows},knowledge,skills,workflows};生成 SCHEMA.md,约定命名与 frontmatter;生成 knowledge/index.md(8 列)、skills/registry.md(6 列)、workflows/registry.md(7 列)、schema-signals.md;询问工具清单并写入 tools.md;可选地收集目标及 KR/KI,若跳过则建仅含 status: empty 的 objective.md 并进入 knowledge-only 模式;最后将说明块写入 AGENTS.md 的 <!-- personal-assistant:start --> 与 <!-- personal-assistant:end --> 标记之间,该写入具幂等性。
使用方式:一次只问一个问题,写文件前必须确认表格,除非从 pk-track 收到 pre_confirmed: true 则跳过确认直接写入。update 模式需先确保 snapshot,再读取现有文件,确认差异后写回。
适用场景:单人单目标的个人助理项目从零搭建,或调整目标与工具清单。
限制:不创建 plan.md 或 action 文件(属 pk-plan)、不修改 action 状态(属 pk-track)、不创建或修改 knowledge 页面(属 pk-distill);不创建或修改 CLAUDE.md,连接 CLAUDE.md 到 AGENTS.md 由用户负责;仅限单人单目标。