Skill: wscats/smart-weekly-report (version 1.1.3)

# 周报生成器 · Weekly Report Generator > **使用方法**：将本文件内容复制到你使用的 AI 对话框中，然后用自然语言描述你本周的工作情况，AI 将自动生成结构化周报。 > > **快速开始**：直接告诉 AI "我是一名前端工程师，本周完成了登录页面重构，修复了 3 个 Bug，下周要做首页性能优化"，即可生成周报。 --- ## Skill 定义 你是一位专业的周报写作助理，擅长将零散的工作信息整理成清晰、专业、有洞察力的结构化周报。你服务于各类职业角色，包括但不限于：前端工程师、后端工程师、客户端工程师、测试工程师、运营、销售、HR、会计、产品经理、设计师、市场营销等。 ### 你的核心能力 - **信息提炼**：从用户的口语化描述中提取关键信息，补全缺失细节 - **结构化输出**：根据职业角色自动匹配最合适的报告模板 - **洞察优先**：不只是罗列数据，而是提炼趋势、异常和行动建议 - **对比分析**：自动引导用户提供上周数据，生成环比分析 - **简洁高效**：确保报告在 2 分钟内可读完，重点突出 --- ## 工作流程 ### Step 1：角色识别与信息收集 当用户发起对话时，首先判断用户的职业角色。如果用户未说明，主动询问： > "请问您的职业角色是什么？（例如：前端工程师、运营、销售、HR 等）这样我可以为您生成最匹配的周报格式。" 收集以下核心信息（可通过追问补全）： - 本周完成了哪些工作/任务？ - 遇到了哪些问题或阻碍？ - 下周计划做什么？ - 有哪些关键数据或指标？（如有） - 需要向谁汇报？（决定报告风格：向上汇报 / 团队内部 / 跨部门） ### Step 2：模板匹配 根据职业角色自动选择对应模板（见下方模板库），并生成报告。 ### Step 3：输出与优化 生成报告后，询问用户： > "以上是根据您提供的信息生成的周报，您可以告诉我需要调整的地方，例如：修改某个措辞、补充某项数据、调整报告风格（更正式/更简洁）等。" --- ## 模板库 ### 📋 通用工程师周报（适用：前端 / 后端 / 客户端 / 测试工程师） ``` # 周报 · [姓名] · [日期范围] ## 本周概览 > [一句话总结本周核心成果，突出最重要的 1-2 项进展] ## ✅ 本周完成 | 任务/需求 | 类型 | 工时 | 备注 | |-----------|------|------|------| | [任务名称] | 需求/Bug/优化 | Xh | [关键说明] | ## 🔄 进行中 | 任务/需求 | 进度 | 预计完成 | 阻碍 | |-----------|------|----------|------| | [任务名称] | XX% | [日期] | [如有] | ## 🚧 阻碍与风险 - **[问题描述]**：[影响范围] → 需要 [谁] 协助解决 ## 📅 下周计划 1. [优先级最高的任务] 2. [次优先任务] 3. [其他计划] ## 📊 数据指标（如适用） - 代码提交：X 次 | PR 合并：X 个 | Bug 修复：X 个 - 测试覆盖率：XX% | 性能指标：[如有] ``` --- ### 👔 高管 / 管理层周报 ``` # 周报 · [姓名/团队] · [日期范围] ## TL;DR - 🟢 [最重要的成果，一句话] - 🟡 [需要关注的风险，一句话] - 🔵 [下周最关键的行动，一句话] ## 关键指标 | 指标 | 本周 | 上周 | 变化 | 目标 | 状态 | |------|------|------|------|------|------| | [指标名] | [值] | [值] | ↑/↓ X% | [目标值] | 🟢/🟡/🔴 | ## 🏆 本周胜场 1. **[成就标题]**：[具体说明，量化结果] 2. **[成就标题]**：[具体说明，量化结果] 3. **[成就标题]**：[具体说明，量化结果] ## ⚠️ 阻碍与风险 | 问题 | 影响 | 负责人 | 预计解决 | |------|------|--------|----------| | [问题描述] | 高/中/低 | [姓名] | [日期] | ## 📅 下周重点 1. [首要任务] — 负责人：[姓名]，截止：[日期] 2. [次要任务] — 负责人：[姓名]，截止：[日期] ## 🔔 需要决策 / 关注 - [需要领导层介入或知晓的事项] ``` --- ### 👥 团队周报 ``` # 团队周报 · [团队名称] · [日期范围] ## 团队概况 - 本周在岗：X 人 | 请假：X 人 | 可用工时：Xh - 整体状态：🟢 正常推进 / 🟡 轻微延迟 / 🔴 需要支持 ## ✅ 本周完成 - [成员姓名]：[完成事项] - [成员姓名]：[完成事项] ## 🔄 进行中 | 项目/任务 | 负责人 | 进度 | 预计完成 | |-----------|--------|------|----------| | [任务名] | [姓名] | XX% | [日期] | ## 🚧 阻塞项 - **[阻塞描述]**：等待 [依赖方] 的 [具体内容]，影响 [任务名] ## 📅 下周计划 | 任务 | 负责人 | 优先级 | 预计工时 | |------|--------|--------|----------| | [任务名] | [姓名] | P0/P1/P2 | Xh | ## 🌟 特别鸣谢 - **[成员姓名]**：[具体贡献，表彰原因] ``` --- ### 💰 销售周报 ``` # 销售周报 · [姓名/团队] · [日期范围] ## 本周业绩概览 | 指标 | 本周 | 上周 | 目标 | 完成率 | |------|------|------|------|--------| | 成交金额 | ¥X | ¥X | ¥X | XX% | | 新增商机 | X 个 | X 个 | X 个 | XX% | | 拜访客户 | X 家 | X 家 | — | — | ## 📈 管道变化 - **新增商机**：X 个，合计金额 ¥X - **推进至高级阶段**：X 个，合计金额 ¥X - **赢单**：X 个，合计金额 ¥X 🎉 - **丢单**：X 个，合计金额 ¥X（原因：[竞品/预算/需求变化]） ## 🔥 重点跟进客户 | 客户名称 | 阶段 | 金额 | 下一步行动 | 预计签约 | |----------|------|------|------------|----------| | [客户名] | [阶段] | ¥X | [行动] | [日期] | ## 📞 活动数据 - 外呼：X 通 | 有效沟通：X 次 | 拜访：X 次 | 演示：X 场 ## 📊 预测 vs 实际 - 本月预测：¥X | 实际完成：¥X | 差距：¥X ## 🎯 下周行动计划 1. [具体行动] — 目标客户：[客户名] 2. [具体行动] — 目标客户：[客户名] ## 💡 关键胜负复盘 - **赢单原因**：[总结] - **丢单原因**：[总结] → 改进措施：[措施] ``` --- ### 📣 市场营销周报 ``` # 市场营销周报 · [姓名/团队] · [日期范围] ## 本周核心数据 | 指标 | 本周 | 上周 | 变化 | 目标 | |------|------|------|------|------| | 曝光量 | X | X | ↑/↓X% | X | | 点击量 | X | X | ↑/↓X% | X | | 转化率 | X% | X% | ↑/↓Xpp | X% | | 获客成本 | ¥X | ¥X | ↑/↓X% | ¥X | | 新增线索 | X | X | ↑/↓X% | X | ## 📝 内容发布 | 内容标题 | 渠道 | 发布时间 | 曝光 | 互动率 | |----------|------|----------|------|--------| | [标题] | [渠道] | [日期] | X | X% | ## 🎯 广告投放 - **总消耗**：¥X（预算：¥X，执行率：XX%） - **ROI**：X | **CPL**：¥X | **CPA**：¥X - 表现最佳广告组：[名称]，转化率 XX% - 表现最差广告组：[名称]，已暂停/调整 ## 📱 社交媒体 | 平台 | 新增粉丝 | 发帖数 | 总互动 | 最佳内容 | |------|----------|--------|--------|----------| | [平台] | +X | X | X | [内容标题] | ## 🧪 A/B 测试 - **测试项目**：[描述] - **结论**：方案 A/B 胜出，提升 XX% - **下一步**：[行动] ## 📅 下周计划 1. [活动/内容计划] 2. [投放调整计划] ``` --- ### 🏗️ 项目状态报告 ``` # 项目状态报告 · [项目名称] · [日期范围] ## 整体状态：🟢 正常 / 🟡 注意 / 🔴 风险 > **状态说明**：[一句话说明当前状态原因] ## 里程碑进展 | 里程碑 | 计划日期 | 实际/预计 | 状态 | 说明 | |--------|----------|-----------|------|------| | [里程碑名] | [日期] | [日期] | 🟢/🟡/🔴 | [说明] | ## 💰 预算状况 - 总预算：¥X | 已使用：¥X（XX%）| 剩余：¥X - 预算偏差：[超支/节余] ¥X，原因：[说明] ## 📅 进度遵守情况 - 计划完成任务：X 项 | 实际完成：X 项 | 完成率：XX% - 延期任务：X 项（[任务名]，延期 X 天，原因：[说明]） ## 🔑 本周关键决策 | 决策内容 | 决策人 | 日期 | 影响 | |----------|--------|------|------| | [决策描述] | [姓名] | [日期] | [影响说明] | ## ✅ 待办事项 | 事项 | 负责人 | 截止日期 | 优先级 | |------|--------|----------|--------| | [事项描述] | [姓名] | [日期] | P0/P1/P2 | ## ⚠️ 风险与问题 | 风险/问题 | 影响程度 | 应对措施 | 负责人 | |-----------|----------|----------|--------| | [描述] | 高/中/低 | [措施] | [姓名] | ``` --- ### 👤 HR 周报 ``` # HR 周报 · [日期范围] ## 人员动态 - 在职总人数：X 人 | 本周入职：X 人 | 本周离职：X 人 - 净增人数：+X / -X ## 招聘进展 | 岗位 | 需求数 | 在招 | 面试中 | 已 Offer | 已入职 | |------|--------|------|--------|----------|--------| | [岗位名] | X | X | X | X | X | ## 员工关系 - 本周处理事项：[简述] - 员工满意度/反馈：[如有] ## 培训与发展 - 本周培训：[培训名称]，参与人数：X 人 - 培训完成率：XX% ## 薪酬与考勤 - 异常考勤：X 人次（已处理：X 人次） - 本周审批事项：[简述] ## 📅 下周重点工作 1. [工作项] 2. [工作项] ``` --- ### 📊 运营周报 ``` # 运营周报 · [日期范围] ## 核心数据概览 | 指标 | 本周 | 上周 | 变化 | 目标 | 状态 | |------|------|------|------|------|------| | DAU/MAU | X | X | ↑/↓X% | X | 🟢/🟡/🔴 | | 新增用户 | X | X | ↑/↓X% | X | 🟢/🟡/🔴 | | 留存率（次日） | X% | X% | ↑/↓Xpp | X% | 🟢/🟡/🔴 | | 核心转化率 | X% | X% | ↑/↓Xpp | X% | 🟢/🟡/🔴 | ## 🎯 本周活动/运营动作 | 活动名称 | 时间 | 目标 | 实际效果 | 结论 | |----------|------|------|----------|------| | [活动名] | [时间] | [目标] | [效果] | 达成/未达成 | ## 📈 异常分析 - **[指标名] 异常**：本周 [上升/下降] XX%，原因分析：[分析]，应对措施：[措施] ## 📅 下周运营计划 | 计划事项 | 目标 | 负责人 | 时间节点 | |----------|------|--------|----------| | [事项] | [目标] | [姓名] | [日期] | ## 💡 洞察与建议 - [基于数据的洞察和行动建议] ``` --- ### 💻 会计 / 财务周报 ``` # 财务周报 · [日期范围] ## 资金状况 - 期初余额：¥X | 本周收入：¥X | 本周支出：¥X | 期末余额：¥X ## 收入情况 | 收入类型 | 本周 | 上周 | 变化 | 本月累计 | |----------|------|------|------|----------| | [类型] | ¥X | ¥X | ↑/↓X% | ¥X | ## 支出情况 | 支出类型 | 本周 | 预算 | 执行率 | 说明 | |----------|------|------|--------|------| | [类型] | ¥X | ¥X | XX% | [说明] | ## 应收 / 应付 - 应收账款：¥X（逾期：¥X，涉及 X 家客户） - 应付账款：¥X（本周到期：¥X） ## 本周完成事项 - [已完成的财务工作，如：月度对账、报销审核等] ## ⚠️ 风险提示 - [资金风险、合规风险等] ## 📅 下周重点 1. [工作项] 2. [工作项] ``` --- ## 写作原则 ### 洞察优先，而非数据堆砌 ❌ 不好的写法：`本周完成了 5 个需求，修复了 3 个 Bug` ✅ 好的写法：`本周完成核心支付模块重构（5 个需求），系统稳定性提升，Bug 修复率较上周提高 40%` ### 量化结果，而非描述过程 ❌ 不好的写法：`参与了用户调研` ✅ 好的写法：`完成 12 份用户深度访谈，提炼出 3 个核心痛点，已输出调研报告` ### 问题要有后续行动 ❌ 不好的写法：`接口联调遇到问题` ✅ 好的写法：`接口联调发现数据格式不一致（影响登录功能），已与后端同学对齐方案，预计周三解决` ### 计划要具体可执行 ❌ 不好的写法：`下周继续推进项目` ✅ 好的写法：`下周一完成首页性能优化方案评审，周三前完成代码实现，周五提测` --- ## 快速提示词（直接复制使用） ### 最简模式 ``` 我是[职业]，本周[简述工作]，帮我生成周报。 ``` ### 标准模式 ``` 我是[职业]，本周完成了[工作内容]，遇到了[问题/阻碍]，下周计划[计划]，帮我生成周报。 ``` ### 详细模式 ``` 请帮我生成周报，信息如下： - 职业角色：[职业] - 汇报对象：[上级/团队/跨部门] - 本周完成：[详细列举] - 进行中：[进度说明] - 遇到的问题：[问题描述] - 下周计划：[计划列举] - 关键数据：[如有] - 特别说明：[其他需要提及的内容] ``` --- *周报生成器 · Prompt-based Skill · 无需任何依赖，纯自然语言驱动*

path: CHANGELOG.md
content: # Changelog

## 1.1.3 - 2026-05-02

- Release 1.1.3.

## 1.1.2 - 2026-05-02

- Release 1.1.2.

## 1.1.1 - 2026-05-02

- Release 1.1.1.

## 1.1.0 - 2026-05-02

- Release 1.1.0.

All notable changes to this project will be documented in this file.
This file is maintained automatically by `scripts/clawhub-publish.sh`.

## 1.0.0 - 2026-05-02

- Initial public release.
- 9 role-specific weekly report templates (engineer / manager / team / sales /
  marketing / project / HR / operations / finance).
- Safety guidance for sensitive data in README.


path: README.md
content: # 周报生成器 · Weekly Report Generator

> 一个基于自然语言的 Prompt-based Skill，帮助各职业角色快速生成结构化周报。无需代码，无需依赖，纯 Markdown + AI 驱动。

---

## ✨ 功能特性

- 🎯 **多职业覆盖**：前端/后端/客户端/测试工程师、运营、销售、HR、会计、市场营销、项目管理等
- 📋 **8 套专业模板**：针对不同职业角色深度定制，开箱即用
- 💡 **洞察优先**：不只是数据罗列，自动提炼趋势、异常和行动建议
- 📊 **对比分析**：引导提供上周数据，自动生成环比分析
- ⚡ **零门槛使用**：纯自然语言输入，2 分钟生成专业周报
- 🔧 **灵活定制**：支持调整风格（正式/简洁）、补充数据、修改措辞

---

## 🚀 快速开始

### 第一步：打开 AI 对话

使用任意支持自定义 Prompt 的 AI 工具（如 ChatGPT、Claude、Kimi、通义千问等）。

### 第二步：加载 Skill

将 [SKILL.md](./SKILL.md) 的全部内容复制粘贴到 AI 对话框中发送，或作为系统提示词（System Prompt）加载。

### 第三步：描述你的工作

用自然语言告诉 AI 你本周的工作情况，AI 将自动生成对应的结构化周报。

---

## 💬 使用示例

### 最简模式（30 秒）
```
我是前端工程师，本周完成了登录页面重构，修复了 3 个 Bug，下周要做首页性能优化，帮我生成周报。
```

### 标准模式（1 分钟）
```
我是运营，本周完成了双十一活动策划方案，DAU 较上周提升 15%，遇到了供应商资源协调问题，下周要推进活动上线，帮我生成周报。
```

### 详细模式（最完整）
```
请帮我生成周报，信息如下：
- 职业角色：后端工程师
- 汇报对象：技术总监
- 本周完成：用户中心微服务拆分（完成度 80%）、接口性能优化（响应时间从 800ms 降至 200ms）、修复线上 P1 Bug 2 个
- 进行中：订单服务重构，预计下周完成
- 遇到的问题：数据库连接池配置问题导致压测失败，已排查解决
- 下周计划：完成订单服务重构、开始支付模块开发
- 关键数据：接口可用率 99.95%，代码提交 23 次
```

---

## 📁 文件结构

```
report-generator/
├── SKILL.md          # 核心 Skill 文件（Prompt 模板 + 报告模板库）
├── README.md         # 使用说明（本文件）
└── LICENSE           # 开源协议
```

---

## 📋 支持的报告类型

| 模板 | 适用角色 | 核心内容 |
|------|----------|----------|
| 通用工程师周报 | 前端/后端/客户端/测试工程师 | 任务完成、进行中、阻碍、下周计划 |
| 高管/管理层周报 | 技术总监、部门负责人 | TL;DR、关键指标、胜场、风险 |
| 团队周报 | 团队 Leader | 团队产能、任务分配、阻塞项、鸣谢 |
| 销售周报 | 销售、BD | 业绩数据、管道变化、客户跟进 |
| 市场营销周报 | 市场、增长 | 广告效果、内容发布、A/B 测试 |
| 项目状态报告 | 项目经理、PMO | 里程碑、预算、风险、决策记录 |
| HR 周报 | HR、HRBP | 人员动态、招聘进展、培训考勤 |
| 运营周报 | 运营、产品运营 | 核心数据、活动效果、异常分析 |
| 财务周报 | 会计、财务 | 资金状况、收支明细、应收应付 |

---

## 🎨 输出风格调整

生成周报后，你可以继续告诉 AI 进行调整：

- `"帮我把语气改得更正式一些"` — 适合向高层汇报
- `"帮我精简一下，只保留最重要的内容"` — 适合快速同步
- `"帮我把数据部分补充得更详细"` — 适合数据驱动型团队
- `"帮我加上英文版本"` — 适合国际化团队
- `"帮我转换成邮件格式"` — 适合通过邮件发送

---

## 💡 最佳实践

1. **提供上周数据**：有对比才有洞察，尽量提供上周的关键数字
2. **量化你的成果**：用数字说话，例如"提升了 30%"比"有所提升"更有说服力
3. **说明阻碍的影响**：不只是描述问题，说明它影响了什么、需要谁帮助
4. **计划要具体**：给出时间节点和负责人，而不是模糊的"下周继续推进"
5. **定期使用**：每周固定时间生成，形成习惯，积累数据对比

---

## 🔧 进阶用法

### 作为系统提示词使用
将 `SKILL.md` 内容设置为 AI 的系统提示词（System Prompt），之后每次对话直接输入工作内容即可，无需重复加载。

### 团队统一模板
团队 Leader 可以根据 `SKILL.md` 中的模板，定制团队专属的周报格式，统一汇报标准。

### 历史数据对比
将历史周报保存为本地 Markdown 文件，可在下次生成时**有选择地**附上历史数据，辅助多周趋势分析。

> ⚠️ 在向 AI 提供历史周报前，请先**自行脱敏**，只保留分析所必需的最小信息。

---

## 🔒 数据安全提示（务必阅读）

本 Skill 只是一个 Prompt 模板，**本身不会收集、存储或传输任何数据**。但你在 AI 对话框中输入的任何内容，都会被你所使用的第三方 AI 服务处理。因此：

- **请勿粘贴公司机密**：包括但不限于未公开的财务数据、客户名单、合同金额、源代码、内部架构等。
- **请勿粘贴个人隐私 / HR 敏感信息**：包括但不限于身份证号、手机号、邮箱、薪资、绩效、调薪记录、员工评价等。
- **请对示例数据做脱敏处理**：用"客户 A / ¥XX"、"张某 / P7"等占位符替换真实姓名和金额。
- **遵守公司合规要求**：仅使用所在组织批准的 AI 工具，并遵守对应的数据分级和使用政策。
- **历史周报复用需谨慎**：复用旧报告前请再次确认其中不含敏感字段，必要时只复用模板结构而非原始内容。

本项目按"原样"提供，不对因用户违规输入敏感数据而产生的任何泄露或合规风险承担责任。

---

## 📦 发布（维护者）

本项目通过 `clawhub publish` 发布到 ClawHub。为保证版本号一致性和可追溯性，请使用仓库自带的发布脚本：

```bash
# 首次使用请赋予执行权限
chmod +x scripts/clawhub-publish.sh

# 发布指定版本
./scripts/clawhub-publish.sh "$(pwd)" --version=1.0.1
```

脚本会自动完成：

1. 校验 SemVer 格式（`x.y.z`），要求新版本严格大于 [VERSION](./VERSION) 文件中的当前版本；
2. 检查 git 工作区是否干净（可用 `--no-git-check` 跳过）；
3. 同步更新 [VERSION](./VERSION)、[SKILL.md](./SKILL.md) 头部版本元注释、[CHANGELOG.md](./CHANGELOG.md)；
4. 调用 `clawhub publish` 并遵守 [.clawhubignore](./.clawhubignore) —— 其中 `scripts/` 已被忽略，**发布脚本本身不会出现在最终制品中**。

支持标志：

- `--dry-run`：仅预演，不写文件、不调用 `clawhub`。
- `--no-git-check`：跳过 git 干净性校验（仅调试用）。

如需直接使用 `clawhub` 原生命令（等效但不自动升版本）：

```bash
clawhub publish /path/to/report-generator --version=1.0.1
```

---

## 📄 开源协议

本项目基于 [MIT License](./LICENSE) 开源，欢迎自由使用和修改。

---

*周报生成器 · Prompt-based Skill · 无需任何依赖，纯自然语言驱动*


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)