# Weekly Report

> 帮助用户梳理周报，按照完整逻辑展示工作价值和边界。当用户说"写周报"、"周报"、"梳理周报"、"整理工作"时触发。

- **Type:** Skill
- **Install:** `agentstack add skill-yunshu0909-yunshu-skillshub-weekly-report`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [yunshu0909](https://agentstack.voostack.com/s/yunshu0909)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [yunshu0909](https://github.com/yunshu0909)
- **Source:** https://github.com/yunshu0909/yunshu_skillshub/tree/master/weekly-report

## Install

```sh
agentstack add skill-yunshu0909-yunshu-skillshub-weekly-report
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 周报写作助手

## 用途

帮助用户把一周的工作梳理成逻辑清晰、价值明确的周报，让团队了解做了什么、遇到什么问题、下一步计划。

## 工作流程

### 第一步：收集素材

引导用户讲述本周工作，可以想到什么说什么，不需要有条理：

1. **按模块引导**：你这周主要做了哪几块的事情？（客户、项目、内部工作等）
2. **自由描述**：每一块具体做了什么？不用组织语言，想到什么说什么
3. **不打断**：让用户先全部讲完，再补充细节

### 第二步：分类整理

根据用户的工作性质和角色，灵活选择合适的模块分类。以下是不同角色的常见分类参考：

**技术/开发角色**：
- 功能开发/需求实现
- Bug修复/问题排查
- 技术优化/重构
- Code Review/技术评审
- 技术调研/学习
- 文档编写

**产品经理角色**：
- 需求调研/用户访谈
- 产品设计/原型设计
- 需求评审/排期
- 数据分析/用户反馈
- 竞品分析
- 产品迭代/上线

**运营角色**：
- 活动策划/执行
- 用户增长/留存
- 内容运营/社区运营
- 数据分析/效果复盘
- 用户反馈处理
- 渠道合作/商务对接

**设计角色**：
- UI/视觉设计
- 交互设计/用户体验
- 设计规范/组件库
- 设计评审/走查
- 视觉优化

**测试/QA角色**：
- 测试用例编写
- 功能测试/回归测试
- 自动化测试
- Bug跟踪/质量分析
- 性能测试/安全测试

**SA/售前/商务角色**：
- 客户跟进/拜访
- POC/Demo演示
- 方案设计/技术支持
- 商务谈判/合同
- 客户培训/分享

**通用模块**（适用所有角色）：
- 项目交付/执行
- 内部提效/工具建设
- 会议/培训/分享
- 团队协作/跨部门沟通
- 学习/调研

**使用建议**：
- 根据自己的实际工作选择2-4个主要模块
- 模块名称可以根据自己习惯调整（如"功能开发"可以叫"需求实现"）
- 每个模块下按具体项目/客户/事项进一步细分

### 第三步：补充关键信息

针对每件事，通过追问补充完整逻辑：

1. **背景/原因**：为什么要做这件事？基于什么需求或问题？
2. **具体做了什么**：采取了什么行动？用了什么方法/工具？
3. **结果/价值**：
   - 达到了什么效果？
   - 有具体数字吗？（成本、收益、时间等）
   - 给客户/团队带来了什么价值？
4. **当前状态**：
   - 完成了？进行中？等待反馈？
   - 遇到什么卡点或问题？
   - 问题的本质是什么？（技术问题、交付问题、沟通问题？）
5. **下一步动作**：
   - 接下来要做什么？
   - 谁来负责？

**关键追问模板**：
- "这个成本大概是多少？"（能量化的尝试量化）
- "为什么要做这个？是客户要求还是主动优化？"
- "结果怎么样？客户反馈如何？"
- "目前卡在哪里？本质是什么问题？"
- "下一步谁来处理？"

### 第四步：讨论调整

给用户看初稿，确认：
1. **表述习惯**：是否保持了用户的表达方式？不要用自己的套路改写
2. **逻辑完整**：每件事是否说清楚了背景→做了什么→结果→下一步？
3. **重点突出**：哪些是重点成果？是否体现出来了？
4. **问题明确**：遇到的卡点和挑战是否说清楚了？

根据用户反馈调整措辞、结构和重点。

### 第五步：输出文档

生成最终的周报文档，包含：

```markdown
# 本周工作

## 一、[模块名称]

**1. [客户/项目名称] - [一句话概括]**
[完整描述：背景 → 做了什么 → 结果 → 下一步]

**2. [客户/项目名称] - [一句话概括]**
① [子项1]：[描述]
② [子项2]：[描述]
③ [子项3]：[描述]

**核心卡点/挑战**：[如果有重要问题，单独说明]

## 二、[模块名称]
...

## 下周重点

**1. [重点事项1]**
- [具体内容]

**2. [重点事项2]**
- [具体内容]
```

## 核心原则

1. **用用户的话**：保持用户的表达习惯和语气，不要用自己的套路改写
2. **完整的逻辑链**：每件事都要有背景→做了什么→结果→下一步
3. **能量化的就量化**：用户提到数字就写上，用户没说也不强求
4. **如实展示边界**：
   - 能搞定的：体现专业能力和价值
   - 搞不定的：说清楚卡在哪、为什么、谁来解决
5. **明确下一步**：每个事项说清楚当前状态和下一步动作
6. **格式自然**：该有的结构要有，但内容要自然成段，不要搞成标签式（"做了什么：""取得结果："）

## 常见场景

### 场景 1：用户说得很散乱

- 不要急着整理，先全部听完
- 记录关键词和模块，脑子里分类
- 听完后按模块复述一遍，确认没有遗漏

### 场景 2：用户不愿意提供细节

- 不要强求量化或过度追问
- 重点是把逻辑讲清楚
- 如果确实影响表达，可以说明"如果有具体数字会更有说服力"

### 场景 3：用户觉得自己做得不够多

- 周报不是炫耀，是信息同步
- 如实写做了什么、遇到什么问题
- 卡点和挑战也是价值，说明你在解决难题

### 场景 4：用户想美化或夸大

- 提醒周报的目的是如实展示价值和边界
- 过度美化会导致预期不符，后续更被动
- 建议保持客观真实的表述

## 输出物存放

把生成的周报文档保存为：
`周报-[日期].md`

建议放在用户的工作目录或文档目录中，如：
- `/Users/xxx/Documents/周报/`
- 项目目录下的 `weekly-reports/` 文件夹

## 示例对话流程

```
助手：你好，我来帮你梳理周报。这周主要做了哪几块的事情？

用户：[描述工作内容]

助手：好的，我理解了。让我确认几个细节：
1. [追问背景]
2. [追问结果]
3. [追问下一步]
...

用户：[回答]

助手：明白了。我按这个逻辑整理一下：
[展示分类后的结构]

你看看有没有遗漏的？

用户：[补充或确认]

助手：好的，我写个初稿给你看看：
[展示周报初稿]

这样可以吗？有哪里需要调整的？

用户：[反馈调整意见]

助手：好，我按你说的改一下：
[展示调整后的版本]

现在说说下周重点做啥？

用户：[说下周计划]

助手：好的，完整的周报已经整理好了：
[展示最终版本]

我把周报保存在：[路径]

你可以直接复制去提交了。
```

## 注意事项

- **不要过度美化**：周报是信息同步，不是自我表扬，保持客观真实
- **不要强求量化**：能量化的就量化，量化不了的就讲清楚逻辑
- **不要忽略问题**：卡点和挑战也是价值的一部分，要如实写出来
- **不要用自己的套路**：每个人的表达习惯不同，要保持用户的风格
- **格式服务于内容**：结构化是为了清晰，不是为了好看，不要本末倒置
- **明确责任边界**：问题要说清楚谁来解决，不要让人觉得你在甩锅或揽功

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [yunshu0909](https://github.com/yunshu0909)
- **Source:** [yunshu0909/yunshu_skillshub](https://github.com/yunshu0909/yunshu_skillshub)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-yunshu0909-yunshu-skillshub-weekly-report
- Seller: https://agentstack.voostack.com/s/yunshu0909
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.