用途
ceos-scorecard-autopull 是一个用于以交互方式记录周度计分卡(Scorecard)的技能。它会在用户手动输入数值之前,先自动汇集数据并生成每项指标的预填充建议值,从而节省录入时间。它是 ceos-scorecard 技能的包装(wrapper),并不替代它:在交互式确认后,它会使用与 ceos-scorecard“Log Weekly”模式相同的格式写入文件。ceos-scorecard 仍可用于“Define Metrics”和“Trend Analysis”模式。
主要能力
- 从 L10 会议记录(主要数据源)中提取数据:包括 Headlines、Scorecard Review、IDS、To-Do Review、Conclude / New To-Dos 等部分,用于推断各项指标的值。
- 从可用的 MCP 数据源自动拉取补充数据:CRM(如 Attio、HubSpot)、日历(Google、Outlook)、邮件(Gmail)、文件系统(Glob、Grep)。此步骤为可选,没有 MCP 数据源时会跳过。
- 合并多个来源并解决冲突,优先级顺序为:L10 中用户原话 > CRM 数据 > 日历数据 > 文件系统 > 默认 0。
- 逐项询问每个指标(一次只呈现一个),显示指标名称与目标、带证据的综合建议值、来源以及状态。
- 在全部指标确认后,自动生成 Notes 部分(含 L10 Context 与 Data Sources),展示完整计分卡表格并请求确认保存。
- 对 off_track 项进行标记提示。
使用方式
- 确定当前 ISO 周(YYYY-WNN),检查 data/scorecard/weeks/YYYY-WNN.md 是否已存在,并确定本周日期范围(周一至周日)。
- 读取 data/scorecard/metrics.md 获取指标列表、目标与绿/红阈值。
- 从 data/meetings/l10/ 中读取本周日期范围内的所有 L10 文件,为每项指标构建综合。
- 可选:在运行时发现可用的 MCP 工具并查询补充数据。
- 合并来源并解决冲突。
- 按 metrics.md 的顺序,使用 AskUserQuestion 逐项走查每个指标,建议值作为默认选项,用户可确认、提供不同数值或输入 0。
- 生成 Notes 与 L10 Context。
- 展示完整计分卡表格,询问“是否保存本周计分卡?”,确认后按标准 CEOS 模板写入 data/scorecard/weeks/YYYY-WNN.md。
- 标记 off_track 项,提示在下一次 L10 中讨论;若 3 项以上 off track,提示判断是异常还是值得调查的模式;并提供提交该文件的操作。
适用场景
- 你希望以自动填充建议的方式记录周度计分卡,而不是纯手工输入。
- 你的工作流基于 CEOS/EOS,并已在仓库中维护 L10 会议记录与指标定义。
- 你连接了 CRM、日历、邮件或文件系统等 MCP 数据源,希望获得更完整的指标建议。
限制与前提
- 必须在 CEOS 仓库内运行:需从当前目录向上查找 .ceos 标记文件;若项目的 CLAUDE.md 指定了 CEOS/EOS 根路径,则使用该路径。找不到 .ceos 时应停止并提示用户先克隆 CEOS 仓库并运行 setup.sh。
- 所有路径均相对于 CEOS 根目录,不硬编码绝对路径。
- 没有用户确认绝不写入计分卡文件;始终逐项询问,不一次性抛出所有指标。
- 每个建议都必须展示来源,不能只给数字。
- L10 是主要数据源;外部来源用于验证与补充。
- 需具备优雅降级能力:本周无 L10 时退回仅用外部来源;无 MCP 来源时改为手动输入,不应让整个流程失败。
- 状态计算需遵循 metrics.md 中的阈值。
- 代码、安装命令与模板格式不在本介绍中更改;具体实现细节以原始技能定义为准。
关键文件(均相对于 CEOS 根目录)
- data/scorecard/metrics.md:指标定义(名称、负责人、目标、阈值)。
- data/scorecard/weeks/YYYY-WNN.md:周度计分卡记录。
- data/meetings/l10/:L10 会议记录(主要数据源)。