一、Agent Skill 周报生成方案概述
在日常工作中，重复撰写周报不仅耗时费力，还容易出现格式不统一、内容遗漏等问题。Agent Skill 作为 AI 的“技能包”，能将周报撰写的标准流程、格式要求、风格规范等封装成可复用的技能，让 AI 像熟悉业务的老员工一样，只需简单触发就能生成符合要求的周报，彻底解决反复输入提示词的痛点。
二、周报生成 Skill 核心结构搭建
（一）创建技能文件夹
新建一个名为 weekly-report 的文件夹，作为技能的载体，文件夹名称建议使用小写字母、数字和连字符组合，方便 AI 识别加载。
（二）编写核心配置文件 SKILL.md
这是技能的灵魂文件，采用 YAML 元数据 + Markdown 正文的格式编写：
---
name: weekly-report
description: 根据用户提供的工作内容，按照公司标准格式生成规范的工作周报，包含本周完成、进行中工作、下周计划、问题与需求等模块。
---
# 周报生成技能执行手册
## 触发条件
当用户提及“写周报”“本周工作总结”“工作汇报”等关键词，或直接提供工作内容要求整理成周报时，自动触发该技能。
## 周报标准格式
### 标题
【周报】[姓名]-[日期范围]（示例：【周报】张三-2026.04.01-2026.04.07）
### 正文结构
#### 一、本周完成工作
1. 按项目或任务类型分类罗列，每项需明确成果产出，尽量用数据量化（如“完成用户管理模块3个功能开发，代码覆盖率达95%”）。
2. 重要任务需标注协作人员及完成节点。
#### 二、进行中工作
列出当前未完成的任务，说明进展状态（如“完成70%”）、预计完成时间及当前卡点。
#### 三、下周计划
1. 明确下周核心工作任务，标注优先级（高/中/低）。
2. 说明任务目标及预期产出。
#### 四、问题与需求
1. 阐述本周工作中遇到的技术难题、资源缺口等问题。
2. 提出需要团队或其他部门协作的具体需求。
### 输出要求
1. 语言风格正式、简洁，避免口语化表达。
2. 整体排版清晰，使用层级列表区分不同模块。
3. 若用户未提供部分信息，需主动询问补充（如“请提供本周遇到的问题及需求”）。
（三）补充参考资源（可选）
在 weekly-report 文件夹下创建 reference 子文件夹，放入公司过往优秀周报案例、统一的周报模板文件、业务数据指标说明等资料，AI 会在生成周报时自动参考这些内容，进一步提升内容的贴合度。
三、Skill 加载与使用流程
（一）技能加载
以 Claude Code 为例，将 weekly-report 文件夹放入 .claude/skills/ 目录下，重启 AI 助手后，系统会自动扫描并加载该技能。AI 启动时仅会加载技能的名称和描述信息，不会占用过多上下文资源。
（二）触发使用
直接触发：输入触发关键词，如“帮我写周报”，AI 会自动调用
weekly-report技能，引导你提供工作内容。快捷指令触发：输入
/weekly-report并附上工作内容，如/weekly-report 本周完成用户登录接口开发，修复5个线上bug；进行中工作为支付模块联调，完成60%；下周计划优化商品搜索功能，AI 会直接按照标准格式生成完整周报。
四、技能优化与迭代
（一）内容更新
若公司周报格式调整或业务需求变化，只需修改 SKILL.md 中的对应规则，AI 下次触发时就会按照新要求生成周报，实现全局同步更新。
（二）个性化适配
根据不同岗位需求，可在技能中添加分支规则。例如针对技术岗，增加“技术难点复盘”模块；针对运营岗，强化“数据指标分析”部分，让周报更贴合岗位特性。