技能使用指南

work-report-writer(工作周报生成器)Skill 是什么?如何下载使用?

工作周报生成器Skill(work-report-writer)能从零散工作记录与 git 提交历史一键生成结构化周报月报,支持数据导向、叙事型、OKR 对齐三种风格,内置参数确认与六条生成规范,让技术人告别流水账式汇报。本文详解安装触发方式、使用步骤、竞品对比与真实场景体验,帮你快速上手。

工作周报生成器Skillwork-report-writer
19 个章节 约 15 分钟阅读 AI 智能生成

工作周报生成器Skill:把 git 提交和零散笔记,一键整理成结构化周报月报

  • 它是什么:一个专注于「写汇报」场景的 AI 技能,从零散工作记录 + git 提交历史出发,生成结构化周报或月报。
  • 三种风格:数据导向、叙事型、OKR 对齐,分别对应量化汇报、向上沟通、目标管理三类真实场景。
  • 真正的差异化:不是「让 AI 帮我写周报」这种泛泛对话,而是内置了信息采集流程、参数确认表、三套 Markdown 模板和六条生成规范。
  • 自动取数:当前目录是 git 仓库时,自动按当前用户名和时间范围拉取提交记录,并聚合成工作事项而非逐条罗列。
  • 适合谁:需要定期写周报/月报/迭代总结的开发者、技术负责人、项目经理,以及 OKR 驱动团队中的成员。

该技能叫什么?如何下载安装 AI 技能提升开发效率?

技能中文名:工作周报生成器Skill 技能英文名:work-report-writer 技能 ID:14350

它到底解决什么问题

写过周报的人都熟悉这种循环:一周干了十几件事,但打开周报文档时脑子里一片空白;翻 git log 又只能看到一堆 fix、update 的提交信息;最后要么写成流水账,要么干脆糊弄两句。问题不在于「不会写字」,而在于三件事被卡住了——素材散落在各处、事项没有归并、结构不符合汇报对象的口味。

这个技能针对的正是这三处:

  1. 把「用户口头描述 / 零散笔记 / 聊天记录摘要」和「git 提交历史」两类素材合并采集;
  2. 按已完成、进行中、问题与风险、下期计划、关键数据五个维度归类,并把相关的多个 commit 聚合为一个工作事项;
  3. 用三套现成模板输出,直接对齐汇报对象的阅读习惯。

如何「一键安装」并提升效率

AI 技能(Skill)的通用安装思路是:在你的 AI 客户端或技能市场中找到该技能 → 安装/启用 → 在对话中触发。本技能的安装包与具体安装命令、下载入口,请以官方技能市场的说明为准。

大致步骤如下:

  1. 确认安装前提:你使用的 AI 工具需支持 Skill 机制(能加载技能描述文件并识别触发条件);若希望自动采集提交记录,需在本地 git 仓库目录下工作,并已配置 user.name。
  2. 找到并安装技能:在技能市场中按英文名 work-report-writer、中文名「工作周报生成器」或技能 ID 14350 检索,安装/启用该技能。具体入口与命令以官方说明为准。
  3. 验证是否生效:在对话中直接说一句「帮我写本周周报」,或说出触发关键词——周报、月报、工作总结、weekly report、monthly report、sprint summary、迭代总结、写周报、写月报、OKR 进展汇报。如果技能被正确触发,AI 会先向你收集工作记录并确认报告参数,而不是直接甩出一篇泛泛而谈的文字。
  4. 确认权限与目录:如果你想让技能自动读取 git 提交,请确保当前工作目录就是目标仓库;如果不希望读取代码仓库,直接说「不需要 git 记录」即可跳过。

该技能的主要功能和特点

  • 双源信息采集:一类是用户提供的工作记录(笔记、待办清单、聊天摘要、口头描述都行),另一类是自动执行的 git log 采集,两路信息合并后再进入整理环节。
  • 精确的 git 取数逻辑:先读取当前 git 用户名,再按 --since、--author、--no-merges 拉取指定时间范围内属于本人的提交,默认周报取最近 7 天、月报取最近 30 天,且排除合并提交带来的噪音。
  • 五种可配置参数:报告类型(周报/月报)、报告风格(数据导向/叙事型/OKR 对齐)、时间范围、输出语言(中文/英文)、汇报对象(直属领导/团队/跨部门),默认值均已内置,不确认也能直接出稿。
  • 三套差异化模板:
    • 数据导向型:概览指标 + 已完成表格 + 进行中表格(含进度百分比与阻塞项)+ 问题风险 + 下期计划;
    • 叙事型:本期重点两三句话概括 + 按「背景—进展—下一步」展开的工作主题 + 需要关注的问题;
    • OKR 对齐型:Objective/Key Result 进展总览表 + 逐条 KR 进展 + 未对齐 OKR 的工作 + 风险与依赖 + 下期聚焦。
  • 去碎片化的聚合能力:把相关的多个 commit 合并成一个工作主题,避免「提交了 37 次」式的流水账,这是普通 AI 对话最容易忽略的一步。
  • 六条生成规范内置:去碎片化、量化优先、区分事实与计划、突出价值、风险前置、语言简洁(每项控制在 1–2 句)。
  • 输出即用:默认以 Markdown 直接输出到对话中方便复制,也可以按用户指定的路径写入文件。

和普通工具比强在哪:普通周报模板只给你一个空壳子,通用 AI 对话需要你每次重新写一大段提示词,而项目管理系统的报表只能反映系统内录入的任务。这个技能把「取数—归并—选模板—按规范成文」整条链路固化下来,你只需要提供素材和选择风格。

如何使用该技能?

第一步:准备素材(1 分钟)

不需要工整,把这一周做过的事随便敲出来即可,缺项可以跳过:

- 完成了订单导出接口重构,响应时间从 800ms 降到 200ms 左右
- 支付回调的幂等处理还没做完,大概做到 70%
- 联调时被第三方沙箱环境卡了两天
- 下周准备上线灰度,同时补监控告警
- 关键数据:接口错误率 0.3% → 0.08%

第二步:触发技能

在对话中自然表达需求即可,例如:

帮我写本周周报,用数据导向风格,给直属领导看。

第三步:让技能自动抓取 git 记录(可选)

如果当前目录是 git 仓库,技能会自动执行类似下面的命令取数(周报取 7 天,月报把 7 days ago 换成 30 days ago):

GIT_USER=$(git config user.name)
git log --since="7 days ago" --author="$GIT_USER" --pretty=format:"%h %s (%ai)" --no-merges

若你要看别人或别的周期,只需说明「作者换成张三」「时间范围改为本月 1 号至今」,技能会替换对应参数。当前目录不是仓库,或你说不需要 git 记录时,此步自动跳过。

第四步:确认报告参数

技能会向你确认下表参数;如果你在第一步已经说清楚,这一步会被跳过:

参数 选项 默认值
报告类型 周报 / 月报 周报
报告风格 数据导向 / 叙事型 / OKR 对齐 数据导向
时间范围 自定义日期 最近 7 天或 30 天
输出语言 中文 / 英文 中文
汇报对象 直属领导 / 团队 / 跨部门 直属领导

第五步:拿到报告,按需迭代

技能会把素材与提交记录按五个维度归类后成文。以数据导向风格为例,你会得到类似结构:

# 周报 2024-06-03 ~ 2024-06-09

## 本期概览
- 完成事项:4 项 | 进行中:1 项 | 延期:0 项
- 代码提交:23 次 | 涉及模块:订单、支付、监控
- 关键指标变化:接口错误率从 0.3% 降至 0.08%

## 已完成
| # | 事项 | 分类 | 产出 |
|---|---|---|---|
| 1 | 订单导出接口重构 | 开发 | 响应 800ms → 200ms |
...

拿到初稿后,可以直接追加指令,例如「进行中的支付幂等事项进度改成 80%」「把风险部分提到概览下面」「换个叙事型重写一版给 CEO 看」「保存到 ./reports/week-23.md」。技能支持重写风格、调整结构、写入指定路径。

同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
工作周报生成器(work-report-writer) 面向开发者的汇报生成技能 git 提交自动采集 + 三套风格模板 + 参数化配置 + 六条生成规范 需支持 Skill 机制的 AI 客户端;Git 采集需在仓库目录;无需额外配置提示词 技术岗周报/月报、迭代总结、OKR 进展汇报 优势:取数与成文一体化,风格可切换,输出结构稳定;不足:依赖 AI 客户端能力,非 git 类工作需手动补素材
通用 AI 对话直接写 万能助手 依赖用户每次自写提示词 极低,打开就能问 临时、低频、结构要求不高的汇报 优势:零门槛;不足:一次一个样,容易写成流水账,不会自动拉取提交记录,每次都要重复描述要求
团队协作工具的周报应用(如飞书/钉钉类) 组织内流程化汇报 表单化填报、自动提醒、汇总统计 需企业已部署并对接组织架构 管理层需要统一收集全员周报 优势:流程与催办强;不足:偏表单填空,正文质量靠人写,难以自动关联代码提交
项目管理/缺陷系统自带报表 数据统计报表 工时、燃尽图、任务完成率 需项目数据完整录入系统 项目进度追踪与度量 优势:数据客观;不足:输出的是图表与统计口径,不是可以直接发出去的汇报文稿,且只覆盖系统内任务
手写 Markdown/Notion 模板 个人模板复用 固定结构,人工填充 极低 结构稳定、内容自己完全掌控 优势:完全可控;不足:全部靠人工整理,素材归并与量化描述费时

选择建议:如果你要的是「打开就能发出去的汇报正文」,且工作痕迹主要在代码仓库里,这个技能最贴合;如果团队已经用协作工具做强制填报,可以把它作为「正文草稿生成器」,填表时粘贴使用。

该技能的典型应用场景与实际体验情况

场景一:后端开发工程师的每周例行周报

角色与痛点:小团队后端开发,一周提交几十次代码,周五下午被要求交周报,翻 git log 只看到 fix bug、update 之类的信息,回想不起具体做了什么。

使用方式:在项目仓库目录下打开 AI 客户端,口述几句关键事项,选择数据导向风格,让技能自动拉取最近 7 天本人的提交并按模块聚合。

实际体验:上手几乎没有学习成本,说一句「写本周周报」就能触发。效果最明显的是「聚合」这一步——二十多次零散提交会被归纳成三四个工作主题,比逐条罗列可读性高得多。注意点在于提交信息质量决定素材质量,如果长期写 update,AI 也只能写出含糊的事项,建议顺手把 commit message 写规范。

场景二:技术负责人向非技术高管的月报

角色与痛点:技术负责人需要向管理层汇报,对方不关心 commit 数,只关心业务影响和风险。

使用方式:选择叙事型风格,汇报对象设为跨部门,提供业务结果类信息(如转化率、稳定性指标),让技能按「背景—本期进展—下一步」组织。

实际体验:叙事型模板会自动把技术动作翻译成「为什么做、做到了什么效果」,避免了把技术细节直接怼给高管的尴尬;风险部分会被放在显眼位置。需要注意的是,业务价值这类信息技能无法凭空推断,必须由你提供,否则容易写出「完成了接口改造」这种只有动作没有价值的句子。

场景三:OKR 驱动团队的季度中途进展汇报

角色与痛点:团队按 OKR 管理,周报如果只写任务清单,就无法体现对目标的支撑,季度复盘时还要重新翻记录。

使用方式:选择 OKR 对齐风格,把本周工作对应到 O 与 KR 上,技能会输出 OKR 进展总览表、逐条 KR 进度,并单列「未对齐 OKR 的工作」与「风险与依赖」。

实际体验:这个风格的价值在于强制暴露问题——「未对齐 OKR 的工作」一栏会把临时需求和救火工作显性化,方便后续和上级讨论资源分配。注意事项是首次使用时需要把 OKR 原文提供给技能,否则它只能按你的描述猜测目标层级。

场景四:跨部门协作型岗位的月度总结

角色与痛点:项目经理或支持型岗位,工作成果往往体现在协调、推动、对齐上,很难量化。

使用方式:提供会议纪要摘要、待办清单截图内容和关键节点,选择叙事型或数据导向型(把「推进了 N 个评审」「闭环 M 个阻塞项」作为数据)。

实际体验:对于协调类工作,技能会倾向于把零散沟通归并成「工作主题」,避免写成「和小王沟通三次、和李姐对齐两次」。注意这类工作素材完全依赖用户输入,没有 git 记录兜底,因此建议平时随手记录,不要等到周五再回忆。

该技能能为用户带来的价值

对个人:把重复劳动变成一次输入 周报月报是典型的「低价值高频率」任务。这个技能把撰写过程压缩成「说几句素材 + 选一个风格」两步,把原本花在回忆、归类、调格式上的时间释放出来。更重要的是质量下限被抬高了——即使你只给了很粗糙的素材,输出也具备完整结构、量化描述和风险前置。

对团队:汇报口径更统一 三套模板固化了「概览—已完成—进行中—风险—计划」这样的汇报骨架,团队成员用同一个技能产出的周报,管理者横向对比时成本更低,也不会有人漏写风险和阻塞。

对职业发展:让工作成果更可见 很多人不是做得少,而是说不清。技能内置的「量化优先」「突出价值」「去碎片化」三条规范,本质上是把「怎么把工作讲清楚」这件事方法化了。长期使用会反过来影响你的记录习惯——你会开始主动记录指标变化,而不是等写周报时才想起来去找数据。

对使用成本:低门槛、可复用 技能本体以 MIT 协议开源,规则与模板写在技能描述中,可读、可改、可复用到团队内部;输出为 Markdown,能直接粘进飞书文档、Notion、Confluence 或提交到仓库。

常见问题 FAQ

Q1:这个技能怎么安装?装完怎么确认生效? 在支持 Skill 机制的 AI 客户端或其技能市场中,用英文名 work-report-writer、中文名「工作周报生成器」或技能 ID 14350 搜索并安装启用,具体入口与安装命令以官方说明为准。验证方法很简单:在对话里说「帮我写本周周报」,如果 AI 开始向你询问已完成事项、进行中事项、问题与阻塞、下期计划,并确认报告类型和风格,说明已生效;如果它直接开始泛泛地写,说明技能未被触发。

Q2:收费吗? 根据技能详情,该技能采用 MIT 许可证开源。技能本身的获取与使用通常不额外收费,但你使用的 AI 客户端或平台可能有自己的订阅规则,具体以官方说明为准。

Q3:我的工作不是写代码,不是 git 仓库,能用吗? 可以。git 采集只是可选的增强环节——当前目录不是 git 仓库,或你明确表示不需要 git 记录时,技能会自动跳过这一步,只用你提供的工作记录来生成报告。产品、运营、设计、项目管理等岗位同样适用,尤其是叙事型风格就是为非技术汇报场景准备的。

Q4:自动读取 git 提交,会不会泄露代码或公司信息? 技能实际执行的是 git log 的提交摘要(哈希、提交标题、时间、作者),不含代码内容。不过提交信息本身可能包含项目名、模块名等敏感信息,建议在涉密仓库中使用时先说明「不使用 git 记录」,或仅粘贴脱敏后的事项描述。

Q5:它和直接让 AI 写周报有什么区别?我该怎么选? 直接对话的灵活度更高,但每次都要重新描述要求和结构,输出质量波动大;这个技能把信息采集、事项归并、模板选择和生成规范固化下来,同样的输入能得到结构一致的结果,并且能自动关联代码提交。如果你每周都要写、且希望格式稳定可对比,用技能更省事;如果只是偶尔写一次、内容以非技术事务为主,直接对话也够用。两者也可以组合:用技能出结构化草稿,再人工润色。