mcpField
T
training-report

training-report

github.com/samber文档处理2414.5k 次安装4 周前更新
代码仓库

关于 training-report

用于访谈培训师并编写培训报告的引导式 Skill,以 Markdown 作为标准草稿,仅在内容获批后生成 DOCX。适用于不同领域,涵盖课程情况、反馈、建议和附件。

主要功能

  1. 01开展结构化培训师访谈
  2. 02收集课程信息与学员反馈
  3. 03汇总调查结果并供确认
  4. 04迭代维护标准 Markdown 草稿
  5. 05最终批准后生成 DOCX
  6. 06处理附件与结尾信息

适用场景

  1. 01记录编程工作坊或研讨会
  2. 02根据培训师访谈撰写报告
  3. 03总结培训调查反馈
  4. 04将定稿报告制作为 DOCX

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/samber/cc-skills --skill training-report

安装后在 Claude Code 中输入/training-report确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

evals/
evals.json
references/
docx-generation.md
markdown-draft.md
tone-of-voice.md

详细介绍

培训报告

先以 Markdown 格式迭代完整报告。内容定稿后,最后再生成一次 .docx。.md 是权威版本;.docx 是最终衍生文件。

不受领域限制:编程工作坊、领导力研讨会、安全培训、入职培训、创意工作坊——均适用。

**语音模式:**本次对话可能通过语音进行。语音转写可能会导致同音词、缺失标点或专有名词(姓名、公司名称、工具名称)含糊不清。如果转写后答案仍不明确,请先简短提问澄清,再继续——不要猜测。

参考文件

在指定步骤加载这些文件。不要提前一次性加载全部文件。

文件加载时间
references/tone-of-voice.md步骤 1(确认语言和读者后)
references/markdown-draft.md步骤 5(撰写草稿前)
references/docx-generation.md步骤 6(生成 .docx 前)

步骤 0 — 检查依赖项

在向用户提问之前,确认所需技能是否可用。

docx 技能(步骤 6 必需)

  • 如果已找到:记录下来;在步骤 6 加载
  • 如果未找到:告知用户——生成最终 Word 文档需要此技能,可从 Anthropic 的官方技能库安装。提供先撰写 Markdown 草稿的选项。

Humanizer 技能(推荐)

  • 步骤 1 后,查找与所选语言匹配的 humanizer 技能
  • 如果已找到:加载该技能,并在步骤 5 的自然化润色中应用
  • 如果未找到:告知用户一次,然后采用内联自然化规则(步骤 5b)。建议为所选语言安装 humanizer 技能。

步骤 1 — 语言和读者

询问:

  1. “报告应使用哪种语言?(法语 / 英语 / 其他)”
  2. “主要读者是谁?(高管 / 人力资源 / 直接管理层 / 外部客户 / 内部存档)”

然后加载 references/tone-of-voice.md,并在全文中遵循其中的指导。

步骤 2 — 模板

询问:

“您是否有用于这份报告的 Word(.docx)模板?(公司页眉/页脚、徽标、品牌字体、配色方案)”

  • 有 → 请对方上传;在步骤 6 将其用作基础(解包/注入/重新打包)
  • 没有 → 使用简洁文档;默认采用蓝色 #2E75B6 前,先询问品牌色

步骤 3 — 访谈

分批开展结构化访谈。等待对方回答后再继续。提问前,先从对话中提取用户已经提供的信息。

批次 A — 培训元数据
  • 培训师姓名和职务
  • 日期、地点、公司/团队名称
  • 时长
  • 参与者总人数
  • 确认或进一步明确:文档面向谁?
批次 B — 培训背景
  • 培训的既定目标
  • 主题、话题、工具或用作实践辅助的材料
  • 开始时设定的规则或限制
  • 提供给参与者的材料、账户、许可证或设备
批次 C — 起始水平
  • 小组的熟悉程度分布(是否有初学者?是否有专家?)
  • 两端是否有值得注意的个例
批次 D — 培训流程回顾

按步骤回顾培训过程。每个步骤都询问:

  • 目标
  • 参与者实际做了什么
  • 涉及的材料、工具或练习
  • 是否是首次接触这个概念
  • 参与者的反应如何;是否遇到困难

持续追问,直到信息完整:“接下来发生了什么?”,“有没有什么与计划不同?”,“过程中是否做过调整?”

批次 E — 交付成果

询问:“参与者在培训期间有产出什么吗?”

进一步了解:

  • 练习期间创建的文档、文件、图表、原型或任何产出
  • 小组协作完成的成果
  • 独立完成的个人成果
  • 未完成或开始后未完成的内容

这些内容可以放在附录中,也可以在培训流程回顾中提及。

批次 F — 总体观察
  • 整个团队的整体状态和参与度
  • 任何突发事件、意外情况或值得注意的时刻
  • 日程安排:是否按计划进行,还是有些环节被缩短或延长?
  • 后勤问题(场地、材料、设备准备)

“总体观察”为可选内容。如果培训师除了 walkthrough 没有其他值得补充的内容,可以完全跳过本节。

批次 G — 个人反馈

询问:“您对个别参与者有什么具体观察吗?”

对于每位具名参与者,提取以下信息:

  • 角色或背景
  • 起始水平
  • 行为/参与度(正面和负面)
  • 值得注意的进步、突破或抵触
  • 他们结束本次课程时的状态

个人反馈为可选内容。 仅当培训师明确提供了有意义的观察时才记录。不要逐一询问每位参与者的反馈。

措辞应保持得体。描述行为,而非性格。客观陈述问题,不加评判。为不了解的团队撰写外部客户报告时,请考虑是否适合点名个人。

参见 references/tone-of-voice.md — 外交措辞部分。

批次 H — 建议与后续步骤

询问:“您建议管理层/客户采取哪些措施来巩固本次课程的成果?”

进一步了解:

  • 可提供的资源和访问权限(许可证、书籍、平台、社群)
  • 应融入日常工作的实践
  • 需要谨慎安排节奏的内容——先学基础,再学进阶材料
  • 后续课程(复习、辅导、几周后的问答)
  • 评估和验证方式(测验、实践挑战、同伴评审、检查清单)
  • 知识分享惯例(Slack/Teams 频道、定期会议、Loom 演示、伙伴制度、每月成果分享会)
  • 管理层的参与(保障练习时间、进行一对一沟通、庆祝成果)
  • 供主动学习的参与者使用的外部资源(书籍、课程、认证)
  • 给管理层的具体警告或注意事项
批次 I — 附录

询问:“您有要附在报告中的附录吗?”

附录可以包括:

  • 课程期间的照片
  • 满意度调查结果(NPS、评分、原文评论)
  • 课程期间发放的幻灯片或讲义
  • 参与者完成的作品(练习、原型、文档、图表)
  • 课程期间使用的参考文档
  • 任何其他支持材料

对于每份附录:

  • 图片 → 在步骤 6 尝试自动嵌入
  • 文件(PDF、幻灯片、电子表格)→ 在“附录”部分中引用;不要嵌入
  • 调查数据 → 在步骤 4 中综合分析,然后在文档中作为独立部分列出
  • 参与者成果 → 在相关的 Walkthrough 步骤和“附录”中引用
批次 J — 结束语与联系方式

询问:“我可以在结束语中感谢团队的邀请,并附上您的联系方式以便未来合作吗?(电子邮件 + 电话)”

如果可以,请收集姓名、电子邮件和电话号码。结束语应使用文档语言,语气亲切,篇幅简短。参见 references/markdown-draft.md — 结束段落部分。

步骤 4 — 综合反馈(如提供调查数据)

在起草前,先在对话中整理出以下综合分析:

  • 总体评分/NPS
  • 评分分布
  • 排名前 3 的正面主题
  • 排名前 3 的改进领域
  • 任何异常反馈

询问用户是否确认,再将其写入文档。

步骤 4b — 确认大纲

Here's what I'll draft:
1. Context
2. Starting Levels
3. Session Walkthrough (N steps)
4. General Observations         [optional — include if trainer provided content]
5. Participant Satisfaction     [only if survey data provided]
6. Individual Feedback          [optional — include if trainer provided feedback]
7. Recommendations & Next Steps
8. Annexes                      [only if annexes provided]
[Closing + contact]

Language: [language] | Audience: [target] | Template: [yes/no]

询问:“开始起草前,有什么需要调整的吗?”

步骤 5 — Markdown 草稿

写作前请先读取 references/markdown-draft.md。 其中包含完整的分节写作指南、Markdown 限制、HTML 表格变通方案以及结束段落指南。

人性化处理

提交初稿前,先应用 humanizer 技能(在步骤 0 中加载)。如果没有可用的 humanizer 技能,请直接按照以下规则处理:

  • 删除所有 AI 式的铺垫开场和句首套话
  • 删除成对出现的形容词,只保留更精准的那个
  • 在自然的情况下,将被动语态改为主动语态
  • 用具体行为或事实替换含糊的赞扬或批评
  • 句子宜短不宜长
  • 根据文档语言调整表达方式(参见 references/tone-of-voice.md)

不要提交未经人性化处理的初稿。

迭代循环

在对话中直接展示初稿。由用户主导后续流程。每次修改都要更新 .md 文件。只保留一个权威文件,不要创建多个版本。只有在用户明确确认内容定稿后,才能进入步骤 6。

步骤 6 — 生成最终 .docx

开始前,加载 references/docx-generation.md 和 docx 技能。

此步骤只执行一次,且为终止步骤:生成 .docx 后,如果用户要求修改,请更新 .md 并从头重新生成。

交付这两个文件。如果环境支持直接交付文件(例如 Claude.ai 上的 present_files),请使用该功能。否则,打印两个文件的绝对路径。

注意事项

  • 不要编造细节,只记录培训师明确提供的信息
  • “总体观察”中不要加入主观评论,只写事实
  • 除非明确提供,否则不要撰写个人反馈;措辞要得体
  • 不要凑数写建议;6 条精炼建议胜过 12 条空泛建议
  • 后续步骤中务必包含一条关于节奏安排的建议
  • 此技能并非仅适用于开发者,应根据所属领域调整用词
  • 不要在对话中途生成 .docx;Markdown 才是初稿阶段
  • 不要遗漏任何附录或图片;请嵌入、引用或添加占位符

评论

支持 Markdown