用途:pk-analyze 用于查看项目状况、度量进度、分析问题,全程只读,不创建、修改或删除任何文件。适用于用户询问“情况如何”、想看仪表盘或汇总指标时。
前置条件:需存在 .cockpit/ 目录;若缺失则路由到 pk-init(mode new),不加载其他内容并停止。
主要能力:读取 .cockpit/ 计算指标、发现问题并按优先级排序;支持并行读取多个文件;指标使用标准公式,数字均从文件提取;deep 模式下对每个问题做至少 3 次“为什么”的根因分析;所有判断附证据。
使用方式:通过参数控制。mode 默认 light,仅生成标准仪表盘,不读日志历史与正文、不做根因,但仍会 grep 近 7 天日志文件名用于 System Pulse;mode=deep 启用日志历史、根因与完成速度。focus 默认 full,可选 full、progress、issues、priority、knowledge、track;focus=track 仅计算进度并扫描 1-3 类问题。max_items 默认 2(仪表盘)/3(track),horizon_days 默认 3(仪表盘)/7(track)。
输出:统一仪表盘含 Execution 与 Knowledge 两个模块,包括目标、Key Results 进度条、Actions 统计、Inbox、Wiki/Skills/Workflows 数量、System Pulse(Capture 7d、Inbox 压力、最近 Distill、待处理信号)及“需要关注”问题列表。无 objective 时仅显示 Knowledge 部分。
限制:只读,绝不写文件;快照通过 SNAPSHOT_LOADED 标记幂等加载,已加载则跳过;registry 同步属于 pk-lint 而非本技能;建议性操作需用户确认后才执行。具体公式与阈值见共享引用文件,资料未提供其完整内容。