Plannotator Compound 是一个用于对用户的 Plannotator 计划归档进行全面研究分析的技能。其目标是:从被拒绝的计划中提取模式,将其归纳为可操作的见解,并生成一份优雅的 HTML 仪表板报告。这是一个多阶段过程,每个阶段必须完全完成后才能进入下一阶段。研究完整性至关重要——每个文件都必须读取,不得跳过。
用途
该技能用于分析用户提交的计划被拒绝的原因,识别反复出现的反馈模式,并生成可操作的提示改进建议,以减少未来的拒绝。最终输出是一份自包含的 HTML 仪表板报告,保存在用户的计划目录中。
主要能力
- 源选择:自动检测可用的数据源。优先使用 Plannotator 模式(检查
~/.plannotator/plans/目录中的*-denied.md文件);如果不可用,则回退到 Claude Code 模式(检查~/.claude/projects/目录,并使用捆绑的解析器scripts/extract_exit_plan_mode_outcomes.py从 Claude Code JSONL 转录中提取拒绝原因);如果两者都不可用,则询问用户提供目录,不进行猜测。 - 阶段 0:定位计划并检查先前报告:验证计划目录,检测现有报告(命名方案:首次报告为
compound-planning-report.html,后续为compound-planning-report-v2.html、compound-planning-report-v3.html等),确定最新报告的修改日期作为截止日期,并让用户选择增量分析(仅分析截止日期之后的文件)或完整分析(从头重新分析整个归档)。 - 阶段 1:清单统计:统计所有
*-approved.md和*-denied.md文件数量、日期范围、总天数跨度、修订率(拒绝数 / (批准数 + 拒绝数))。忽略*.annotations.md文件。对于增量模式,单独报告截止日期之后的新文件计数。如果新拒绝文件少于 3 个,会警告用户增量分析可能内容单薄。还会对所有*-approved.md文件运行wc -l以获取平均行数,并尽可能按时间段细分。 - 阶段 2:映射——并行提取:读取每个在范围内的
*-denied.md文件。根据数据集大小采用不同的批处理策略:极小数据集(≤10 个文件)直接在主代理中读取;小数据集(11-30 个文件)启动 2-3 个并行 Haiku 代理;中等数据集(31-80 个文件)启动 4-6 个并行 Haiku 代理;大型数据集(80+ 个文件)启动尽可能多的并行 Haiku 代理,每批约 10-15 个文件。每个提取代理将结果写入/tmp/compound-planning/extraction-{batch-name}.md。提取内容包括:计划名称/主题、拒绝原因或反馈、具体要求更改的内容、反馈类型、特定短语或反复出现的语言、个别注释(如有)、日期。 - 阶段 3:归约——模式分析:使用 Sonnet 模型进行真正的分析推理。标准情况(≤20 个提取文件)启动单个 Sonnet 代理;大型情况(21+ 个提取文件)采用两阶段归约:第一阶段并行 Sonnet 代理生成部分分析,第二阶段单个 Sonnet 代理合成最终综合分析。分析产出包括:拒绝原因分类法(8-15 个类别,含计数、百分比和真实示例引用)、顶级反馈模式(按频率排名的 5-10 个模式,含 3+ 个示例引用和随时间变化情况)、反复出现的短语(含计数和信号含义)、审查者重视的内容(隐含偏好,按证据强度排名)、代理持续出错的地方、结构性请求、随时间演变、可操作的提示指令(最重要的输出,具体编号指令,并计算这些指令能解决多少百分比的拒绝)。
- 阶段 4:生成 HTML 仪表板:构建单个自包含 HTML 文件,保存到用户的计划目录,使用版本化文件名。如果是增量报告,标题应指示分析期间并包含副标题说明。读取
assets/report-template.html模板仅用于设计语言(颜色、排版、间距、组件样式和布局模式),忽略模板中的所有数据值、引用和百分比。设计语言包括:浅色模式,暖灰白背景(#FDFCFB),石板色文本,琥珀色用于高亮/强调,翠绿色用于正面,玫瑰色用于负面,靛蓝色用于操作元素;排版使用 Playfair Display(衬线,用于叙述标题)、Inter(无衬线,用于正文/数据)、JetBrains Mono(等宽,用于代码/短语),通过 Google Fonts CDN 加载;布局为单列。
使用方式
该技能通过技能调用触发,用户需要提供或确认 Plannotator 计划目录或 Claude Code 项目目录。技能会自动检测数据源并引导用户完成多阶段分析流程。在阶段 0 中,如果存在先前报告,用户需要选择增量或完整分析。
适用场景
- 用户希望了解其计划被拒绝的常见原因和模式。
- 用户希望改进其计划提示以减少未来拒绝。
- 用户希望跟踪其计划审查反馈随时间的变化。
- 用户希望获得关于审查者偏好和标准的深入分析。
限制
- 需要存在 Plannotator 计划归档或 Claude Code 项目目录,否则需要用户提供目录。
- 增量分析在截止日期之后新拒绝文件少于 3 个时可能内容单薄。
- 提取代理可能超时(大批量如 128 个文件可能需要 8 分钟以上),需要重新启动处理未完成的文件。
- 该技能的具体收费、价格、平台支持等信息暂未提供。