)
knowledge-work-plugins 实战用 monday-brief 技能一键生成周一经营晨报周一简报【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins本篇文章围绕开源仓库 knowledge-work-plugins 中 small-business 插件提供的monday-brief技能展开。它用于在每周一清晨为小企业主生成一份一页式经营简报——覆盖现金、销售、销售管道、本周待办与今日最重要的三件事并支持自动保存到云端或本地、可选推送到 Slack/Teams。读完本文你将掌握该技能的参数用法、与底层business-pulse技能的数据拉取链路、一页简报的格式规范、审批门禁与自动化调度方式并能结合仓库源码理解其优雅降级的设计原理。一、技能概览monday-brief 是什么monday-brief是 small-business 插件中商业情报类的一个命令级技能定义于 small-business/skills/monday-brief/SKILL.md。它的官方描述是Generates a one-page Monday morning briefing — cash, sales, pipeline, week ahead, top three to-dos. Accepts optional post destination and save-to arguments.即生成一页式周一晨报涵盖现金、销售、销售管道、本周前瞻和三项最高优先级待办接受可选的发布目的地与保存位置参数。该技能声明了allowed-tools: Read, WebFetch, Bash。它与插件的三层架构密切相关。根据 small-business/README.md 的说明插件由三层组成Skills技能构建块、Commands命令工作流与Router路由器。monday-brief属于命令层它在 README 中被列为 15 个命令之一命令作用用户可说使用的技能必需连接器可选连接器/monday-brief周一晨报现金、销售、管道、本周前瞻、前三待办Monday brief、whats on my plate、start of weekbusiness-pulse--优雅降级QuickBooks、PayPal、HubSpot、Calendar、Gmail、Slack在 small-business/skills/smb-router/SKILL.md 的路由表中用户说出 Monday brief / whats on my plate? / start of week 时路由器会把请求导向/monday-brief。路由表同时标明该命令必需连接器为 --degrades gracefully即即使一个连接器都没接也能运行这是它与/friday-brief必需 PayPal 或 HubSpot、/quarterly-review必需 QuickBooks最显著的区别。二、参数解析--post 与 --save-tomonday-brief 在启动时解析两个可选参数参数默认值可选值含义--postnoneslack、teams、none是否把简报摘要发布到 Slack 或 Teams 频道--save-tofilesfilesGoogle Drive / OneDrive、desktop本地桌面、both简报文件的保存位置--post slack/--post teams只发布Three things三件事小节而不是完整简报——保持频道消息简短并附带已保存文件的链接详见下文保存与发布。--save-to决定落盘位置files写入 Google Drive 或 OneDrive 根目录文件名固定为monday-brief-YYYY-MM-DD.mddesktop写入本地~/Desktop/monday-brief-YYYY-MM-DD.mdboth则两处都写。从源码结构看该技能目录下仅有一个 SKILL.md参数解析逻辑由技能自身在运行时按上述约定执行并不依赖额外的脚本或配置文件。三、Step 1触发 business-pulse 拉取六大板块monday-brief 的第一步是触发同插件内的business-pulse技能工作流按其既定顺序拉取数据范围自动收敛到已连接的连接器现金Cash——QuickBooks 余额 最近 7 天净流量销售趋势Sales trend——PayPal/Square 最近 7 天 vs 前 7 天百分比变化、畅销 SKU管道Pipeline——HubSpot 成交变动的 deals、停滞 deals14 天无活动、新增入站线索本周承诺This weeks commitments——带外部参会人的日历事件、交付截止日期关注清单Watch-list——Gmail 标旗为 needs reply 的未读邮件、Slack 待回复私信三件事The 3 things——今天优先级最高的三个行动按影响排序3.1 底层的数据拉取链路business-pulse技能本身定义于 small-business/skills/business-pulse/SKILL.md其核心执行原则是单次并行批次拉取所有连接器调用在同一批次内并行分发绝不串行——串行会把原本 30 秒的技能变成漫长的等待。技能要求参考 small-business/skills/business-pulse/reference/data_sources.md 中的工具到指标精确映射板块指标工具说明现金与财务现金/银行余额cash-flow-quickbooks-account当前余额有可用时展示环比周差现金与财务本月收入profit-loss-quickbooks-account本月 vs 上月现金与财务应收/账龄QuickBooks 发票列表按逾期天数分组0–30、31–60、61销售7 天结算总额PayPal transactions汇总窗口内已完成结算销售销售趋势PayPal transactions本周 vs 前 7 天计算差值管道分阶段管道get_crm_objectstypedeals按 deal 阶段分组并汇总金额管道本周关闭 dealssearch_crm_objects窗口内 closedate阶段 closed-won管道变冷 dealssearch_crm_objectshs_last_activity_date 7 天前且处于开启阶段承诺本周关键事项list_events聚焦本周突出客户会议、截止日期关注清单紧急线程search_threads查询is:important OR is:starred近 7 天关注清单客户升级search_threads关键词如 escalation、complaint、cancel、refund、urgent内部信号紧急线程/行动项Slack 搜索如已连接提及所有者或标记跟进的消息一份完整的 pulse 通常对应8–15 个并行调用其中某个失败不会阻塞其余调用失败来源会出现在简报底部的 Sources unavailable 列表中。除指标拉取外data_sources.md还要求风险扫描与指标拉取同时进行逾期 ARQuickBooks 发票due_date超 30 天未付、停滞 deals开启状态且 7 天无活动、滑期 deals关闭日期已过但仍在开启状态、紧急 Gmail 线程、失败付款失败或待处理且 $200。3.2 优雅降级连接器缺失时的处理monday-brief 明确要求若某个连接器缺失在简报中注明而不是失败。例如写 PayPal not connected — sales trend skippedPayPal 未连接——销售趋势已跳过然后继续生成其余板块。这正是该技能必要连接器为空的设计体现。这一降级哲学在business-pulse中有完整实现其关键规则见 business-pulse/SKILL.md 与 reference/gotchas.mdQuickBooks 异常状态回退若 QBO 返回未连接同步中或空响应将现金板块标记为 n/a — QuickBooks unavailable 并继续不重试、不要求用户重连Gmail 认证回退Gmail 认证间歇性不稳定是已知问题。调用失败时静默跳过关注清单板块在附录中注明 Gmail unavailable绝不在简报中间抛出错误不向用户讨要数据技能被调用就代表已获授权先拉数再汇报禁止反问要不要我查一下 QuickBooks不臆造数字来源无数据就明确写 n/a绝不用猜测填补空缺没有前期基线就写 (no prior baseline)。gotchas.md 用 Good/Bad 成对示例说明了这些失败模式的正确与错误处理方式是排查 monday-brief 运行异常的第一手参考。四、Step 2一页式简报的排版规范第二步是把拉取到的数据整理为单屏可读的一页 Markdown。SKILL.md 给出了精确的布局骨架# Monday Brief — {Mon DD, YYYY} ## Cash {$X balance · {/-}$Y net last 7 days · runway note} ## Sales (last 7d vs prior 7d) {$X total · {/-}Z% · top SKU: {name} ({$})} ## Pipeline {N deals moved · M stalled · K new leads} ## Week ahead - {Tue 10am} — {Customer X discovery call} - {Thu EOD} — {Proposal due to Y} - ... ## Three things that need you today 1. {Highest-leverage action with one-line why} 2. {...} 3. {...}4.1 与 business-pulse 输出模板的关系business-pulse的完整输出模板reference/output_template.md比 monday-brief 的骨架更细每个板块带 // 状态、TL;DR 区、#1 Priority区以及附录窗口、已拉取来源、不可用来源、所用阈值。模板规定只保留有真实数据的板块绝不留空标题、数字先行、文字后置写$43k this month, ▲ 8% MoM而不是 revenue is healthy、指名道姓、给出金额写 $4,200 from Acme, 23 days overdue 而不是 some concerning receivables。格式规则还包括金额简写千用$43k、百万用$1.2m无必要不加小数趋势保留一位小数如▲ 8.3%其余整数正文用人类可读日期Apr 14元数据用 ISO 格式2026-04-14箭头与数值之间保留空格▲ $2k而非▲$2k篇幅控制在一页以内最多两页过长必须精简。monday-brief 的一页版可视为该模板的浓缩形态——保留了 Cash / Sales / Pipeline / Week ahead / Three things 五个核心区把 business-pulse 的详细指标折叠为单行摘要。4.2 红黄绿阈值的判定依据monday-brief 简报中若需标注状态其判定标准来自 reference/thresholds.md这些是 SMB 默认值、可按企业主实际目标调整指标现金跑道≥ 6 个月3–6 个月 3 个月收入趋势环比≥ 0%-5% ~ 0% -5%AR 账龄无超 31 天发票任一发票逾期 31–60 天任一逾期 60 天或 61 桶 AR 的 10%7 天销售趋势≥ 0%-10% ~ 0% -10%失败交易—任一失败 $200任一失败 $1,000或一周内 3 次失败管道覆盖率加权管道 ÷ 月收入目标≥ 2x1–2x 1x整体状态取各板块中的最差值覆盖规则若任一风险指名了具体客户、给出金额且截止日期在 7 天内无论板块颜色如何一律滚升为 。标注了# TODO: confirm with owner的阈值如现金跑道、管道覆盖率目标会在首次输出时提示企业主去校准。建议使用 4 周后重新审视阈值——默认值是保守起点。五、Step 3保存与可选发布第三步处理简报的落盘与分发保存到--save-to指定的位置files—— Google Drive 或 OneDrive 根目录文件名monday-brief-YYYY-MM-DD.mddesktop——~/Desktop/monday-brief-YYYY-MM-DD.mdboth—— 两处都保存。若--post slack或--post teams只发布Three things小节不发完整简报保持频道消息简短并附上已保存文件的链接。无论保存目标如何都在聊天窗口中展示完整简报。六、审批门禁Approval gatesmonday-brief 明确划分了自动执行与必须确认的边界保存文件是自动的无需审批——这是企业主自己的网盘发布到 Slack/Teams 需要确认——先展示发布草稿等待企业主说 post it 后才真正发布若简报中出现不体面的数字如现金大幅下降、交易滑期绝不未经明确询问就发布——频道里可能有非管理层成员。这一门禁与 business-pulse 的分享规则一致business-pulse/SKILL.md 第 5 步规定pulse 结束后只提出一次保存/发布询问若企业主没有回应就继续、不重复追问Slack 写入需要明确的是 频道名授权。gotchas.md 也专门以 Slack write requires explicit confirmation 为例Slack 写入未纳入标准验证路径且发布到他人可见的频道未经确认自动发布可能让整个团队看到财务数据。七、节奏设计周度自动化SKILL.md 的 Cadence note 明确该命令设计为每周运行一次企业主可通过 Cowork 的任务调度器设置计划任务在周一早上 7 点ET运行时输出将直接写入其网盘并在配置后推送到 Slack/Teams 的 DM 频道。从仓库结构看这与插件的 onboarding 流程衔接smb-onboard技能small-business/skills/smb-onboard/SKILL.md会引导用户连接工具、运行演示流程、捕获业务上下文并设置每周检查节奏为 monday-brief 的周度调度提供前置条件。八、在技能家族中的定位与运行前提monday-brief 是每周一检家族的起点与同一business-pulse引擎驱动的另外两个命令形成闭环命令时点核心内容必需连接器/monday-brief周一晨现金、销售、管道、本周、三件事无优雅降级/friday-brief周五末本周收入 vs 上周、赢与关注点PayPal 或 HubSpot/quarterly-review季末完整 QBR 叙事收入、毛利、客户健康、机会与风险QuickBooks三者共享business-pulse作为数据引擎friday-brief 用其 7/14 天回看窗口计算周环比quarterly-review 以deep mode拉取季度 PL 并交叉验证 PayPal 结算。而 monday-brief 的独特性在于零必需连接器——哪怕只接通了一个工具它也能产出部分脉冲one connector gives a partial pulse; the full stack gives the full picture。运行前提与限制该技能依赖 Cowork或 Claude Code环境中已安装的 MCP 连接器连接器清单见 small-business/README.md 的What youll need to connect核心为 QuickBooks、PayPal、HubSpot辅助为 Gmail、Google Calendar、Slack、Stripe、Square 等在 Claude Code 中安装插件claude plugin marketplace add anthropics/knowledge-work-plugins后执行claude plugin install small-businessknowledge-work-plugins需要提醒的是插件明确声明不提供财务、税务、法律或人力资源建议所有输出应在使用前由企业主必要时含专业顾问复核。九、小结monday-brief 是把零散数据变成两分钟决策的样板技能以business-pulse为数据引擎并行拉取六个维度的经营指标以优雅降级为兜底策略在连接器缺失或异常时依然交付可读的简报以审批门禁约束对外发布守住保存自动、发布确认的边界。对开发者而言研读 small-business/skills/monday-brief/SKILL.md 及其依赖的 business-pulse/SKILL.md、data_sources.md、thresholds.md、output_template.md 与 gotchas.md即可完整复现从并行取数 → 指标计算 → 一页排版 → 保存分发的完整链路并将其模式迁移到其他周期性的经营情报场景中。【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考