---
id: xstongxue/best-skills/md-report-summary
version: "cd2810e4"
license: Apache-2.0
install: manual
updated: 2026-07-19
---

# md-report-summary — This skill produces polished Markdown documents for weekly reports, work summaries, project recaps, and introductions. It handles two workflows: when you provide a draft, it refines structure, language, and completeness while preserving all tables, data, and images; when starting fresh, it searches for context and applies templates. Output follows quality standards emphasizing concrete results, quantified metrics, and actionable next steps over generic statements.

Publisher: xstongxue · Stars: 2407 · Updated: 2026-07-19

Install (manual): `git clone https://github.com/xstongxue/best-skills`

## SKILL.md

# Markdown 周报 / 汇报 / 总结 / 介绍

## 一、任务识别


| 文档类型 | 触发词                   |
| ---- | --------------------- |
| 周报   | 周报、本周总结、weekly report |
| 工作汇报 | 工作汇报、汇报材料、进度汇报        |
| 总结   | 总结、复盘、阶段总结、项目总结       |
| 介绍   | 介绍、简介、项目介绍、个人介绍       |

### 周报类型选择

识别到「周报」类任务后，**先询问用户选择周报类型**，再继续后续流程：

> 请选择周报类型（默认：结果导向周报）：
> 1. **结果导向周报 — APB**（默认）— Accomplishments · Plans · Blockers，量化结果 / 下步方向 / 需要的资源与协助，适合向上汇报或跨团队对齐
> 2. **标准周报 — 3P Report** — Progress · Plans · Problems，本周完成 / 进行中 / 下周计划 / 问题与风险，适合团队内部同步

用户未指定类型时，默认使用**结果导向周报**。用户选定后，按对应模板执行后续流程。


## 二、流程分支


| 情况        | 执行          |
| --------- | ----------- |
| **未提供草稿** | 执行「三、无草稿流程」 |
| **已提供草稿** | 执行「四、有草稿流程」 |


## 三、无草稿流程

1. **确认信息**：向用户确认主题、时间范围、受众、重点方向
2. **Web 搜索**：用 `WebSearch` 搜索相关背景、行业进展、最佳实践（搜索结果仅作参考，不可直接照抄）
3. **选模板**：按 [reference/templates.md](reference/templates.md) 选择对应模板
4. **撰写**：按「六、写作质量标准」填充内容并输出

## 四、有草稿流程

1. **读取草稿**：读取用户粘贴的内容或文件路径中的草稿
2. **分析草稿**：识别结构完整性、遗漏点、可优化表述
3. **整理输出**：
  - 表格、列表、引用块、数据、图片**全部原样保留，不删减、不概括**
  - 图片引用 `![描述](路径)` 路径不可修改，原样保留
  - 润色语句、理顺段落逻辑、补充过渡语
  - 缺失章节可用 `WebSearch` 补充，但需注明为补充内容
4. **输出**：整理后的完整 Markdown

## 五、通用原则

- **不省略**：有草稿时，原内容（表格、数据、图片、引用块）全部保留
- **不编造**：不虚构草稿中不存在的事实；搜索补充内容需概括性表述，不夸大
- **图片原样**：`![描述](路径)` 中的路径绝对不能修改
- **格式统一**：标题层级清晰，列表、表格按需使用，不滥用加粗

## 六、写作质量标准

**高质量输出需满足以下要求：**

### 内容层面

- **有结论，不只有陈述**：每个工作项应写清楚"做了什么 → 结果/进展如何"，而非只罗列动作
  - 🚫 差：`完成了模型测试`
  - 👍 好：`完成 Qwen3.5-122B-A10B-AWQ 在 4×24G NVIDIA 环境下的高考模拟卷测试，错题率降至 1/18，推荐作为 NVIDIA 多卡方案首选`
- **数据具体**：尽可能保留时间、数量、百分比等量化信息
- **问题定位清晰**：问题描述需包含"现象 → 根因 → 影响范围"三要素
- **计划可执行**：下周计划要具体，写清楚目标和预计时间，不写"继续推进"类空话

### 结构层面

- 用**小标题**区分不同业务模块，避免将所有内容塞进一个列表
- 多项工作优先用**表格**呈现对比（如模型测试结果），清晰直观
- 重要结论或推荐可用**引用块（`>`）**突出

### 语言层面

- 主动语态，简洁直接
- 专业术语保留（如模型名称、参数名、配置规格），不转译成模糊表述
- 同一事物前后用词一致

## 七、参考资源

- 模板文件：[reference/templates.md](reference/templates.md)

[View on SkillFed](https://skillfed.io/xstongxue/best-skills/md-report-summary) · [View on GitHub](https://github.com/xstongxue/best-skills)