SRC-WORK-002：Claude Skills 实战——把工程月报封装为 Skill

来源基本信息

• 来源编号：SRC-WORK-002
• 原标题：Claude skills 实战，我给自己做了第一个skill
• 作者：shiyafan
• 平台：博客园
• 原始链接：https://www.cnblogs.com/shiyafan/p/20576627
• 发布日期：2026-04-30
• 采集日期：2026-07-13
• 语种：中文
• 内容类型：个人实战复盘
• 所属方向：工作交付

内容概述

shiyafan 在博客园发布的 Claude Skills 个人实战复盘，记录其将每月工程月报任务封装为可复用 Skill 的全过程。文章以"直接提示词 → Markdown 提示文件 → Skill"三阶段演进为线索，说明为什么要把规则、脚本和模板一起打包，以及这种封装在重复性月报场景下能解决什么问题。

输入与输出

• 输入：包含约 60 个工程项目的原始表格、当月筛选条件、固定 Word 月报格式、样式参考。
• 输出：按月份筛选并按固定样式排版的 .docx 部门月报文件，作者继续做人工核对后提交。

三阶段实践

1. 直接提示词：作者把要求写进对话提示词，模型能生成内容，但月份、项目编号、表格样式、段落格式不稳定，需要反复纠正。
2. Markdown 提示文件：把规则保存为 Markdown 复用。问题在于跨会话不持久、上下文长度受限，且缺少明确可执行步骤。
3. Skill 封装：建立名为 engineering-monthly-report-generator 的 Claude Skill，包含 SKILL.md、Python 脚本、Word 模板、样式参考。Skill 负责读取源表、按时间筛选、整理字段、生成 .docx，并尽量保持表格和文档样式。

作者自报结果

• 单次月报耗时从约 2—3 小时缩短到约 10 分钟。
• 该数据为作者本人单一案例的自报值，不是独立计时实验。
• 作者仍人工核对项目编号、日期和格式，最终交付件被视为"可审核交付稿"，并非无需复核的自动成品。

来源直接表达的事实

• 月报背景、约 60 个工程项目。
• 三种做法的具体瓶颈描述。
• Skill 文件构成（SKILL.md + Python + Word 模板 + 样式参考）。
• Word 输出形态和样式要求。
• 自报的前后耗时对比。
• 仍需人工核对编号、日期和格式的边界声明。

整理者归纳（非原文）

• 把这一案例抽象为"规则、程序、模板三层固化"。
• 将最终 Word 文件描述为"可审核交付稿"。

来源未验证的内容

• 独立计时、批量历史月报对比。
• 错误率统计或组织验收记录。
• 该 Skill 在字段复杂度不同月报上的稳定性。
• Claude Skill 在任意 Excel → Word 转换任务上的通用表现。

与其他来源的关系

• 与 SRC-WORK-001：0成本 GitHub Action PDF 翻译工作流 同属工作交付方向，共享"把一次性 AI 任务封装为可重复工作流"的思想，但具体任务不同：本案例聚焦周期性结构化报告生成，SRC-WORK-001 聚焦跨语言 PDF 翻译交付。