mcpField
H
handshake-acknowledgement

handshake-acknowledgement

github.com/somnio-software文档处理839 次安装1 周前更新
代码仓库

关于 handshake-acknowledgement

该技能根据 EM 提供的访谈记录和反馈，为 Somnio Software 的开发人员生成绩效回顾确认 PDF。支持单人或批量处理，并在生成前要求确认提取的信息。

主要功能

  1. 01读取 PDF、DOCX 或粘贴文本
  2. 02提取开发人员及评审信息
  3. 03生成符合模板的确认 PDF
  4. 04支持单人和批量生成
  5. 05生成前确认信息表

适用场景

  1. 01整理绩效回顾访谈记录
  2. 02为多名开发人员生成回顾文档
  3. 03根据上次评估补充进展对比

安装

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

$npx skills add https://github.com/somnio-software/somnio-ai-tools --skill handshake-acknowledgement

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

附带文件scripts/generate_pdf.py

详细介绍

HandShake 致谢文档生成器

根据原始 EM 访谈笔记生成 Somnio HandShake - Step 3 Acknowledgement PDF。 支持单个或批量生成（一次运行可处理 1 到 N 名开发者）。

背景

Somnio Software 每年两次（4 月和 10 月/11 月）开展名为 HandShake 的绩效评估项目。与 PM、团队中的一名开发者和技术负责人完成访谈后，EM 会综合所有内容，编写致谢文档——一份正式的 PDF，并交付给开发者。

输入

每位开发者可提供一个或多个 ficha 文件（PDF、DOCX 或粘贴的文本），内容包括：

  • PM 访谈笔记
  • 团队成员开发者访谈笔记
  • 技术负责人评审笔记
  • EM 综合意见/总体反馈
  • 可选：之前的致谢 PDF（用于比较部分）

输入始终是自由格式——Claude 必须智能地进行解读。

输出

每位开发者生成一份 PDF，符合 Somnio 致谢文档模板：

  • 右上角页眉处的 Somnio 徽标、渐变背景、透明页脚
  • 页眉表格：Somnier、领导者、日期、Somnier 角色
  • 讨论要点（标准议程——始终相同）
  • 会谈摘要：资历 · 当前表现 · 与上次评估对比（如适用）
  • 商定目标：改进机会 + 继续努力的方向
  • 说明或一般性评论（可选）

批量工作流（始终按此顺序执行）

步骤 1 — 阅读所有附件

当 EM 附上一份或多份 ficha 文件时，先阅读所有文件，再提出任何问题。 对每个文件，尽可能提取以下信息：

  • 开发者姓名（Somnier）
  • EM / 领导者姓名
  • 角色
  • 当前资历级别
  • 目标级别
  • 所有反馈内容
步骤 2 — 显示确认表格

提供一张汇总表格，每位开发者占一行。预填 Claude 可以推断出的所有字段。将 Claude 无法确定的字段标记为 [?]。

示例格式：

Encontré X fichas. Antes de generar, confirmá o corregí los datos:

| # | Somnier | Líder | Fecha | Rol |
|---|---------|-------|-------|-----|
| 1 | John Doe | Jane Smith | [?] | Sr Flutter Developer |
| 2 | Bob Johnson | [?] | [?] | Sr Backend Engineer |

Completá los [?] y avisame si hay algo para corregir. Una vez confirmado, genero todos los PDFs.

日期格式规则：Fecha 必须采用 Dec 19, 2025 格式（英文月份缩写、不带前导零、4 位年份）。接受 EM 提供的任何格式并自动规范化。

在 EM 明确确认表格之前，不要生成任何 PDF。

步骤 3 — 生成所有 PDF

EM 确认后（即使只是部分确认，例如“其余部分都没问题”），也要依次生成所有 PDF。 针对每位开发者：

  1. 根据 ficha 笔记构建内容 JSON
  2. 运行生成脚本
  3. 报告进度：“✅ 1/3 — John Doe.pdf 已生成”

最后一起交付所有文件。

步骤 4 — 交付

使用 present_files 一次性提供所有生成的 PDF。

每个文件命名为：Handshake_Acknowledgement_Firstname_Lastname.pdf

内容综合指南

根据原始笔记，为每位开发者综合以下内容：

当前表现

列出 4–7 条要点，突出优势和成就。从 PM/开发者/技术负责人反馈中提取。清晰地重新表述，不要逐字照抄原始笔记。

与上次会议对比

仅当提供了之前的致谢 PDF 时才填写。针对每个先前目标，指定：

  • 已完成 — 明确已达成
  • 已完成，但仍需继续努力 — 部分达成
  • 进行中 — 已开始，但尚未达成
  • 待处理 — 尚未着手

如果没有之前的评估：完全省略此部分。

改进机会

列出 3–6 个具体、可执行的改进领域。从技术负责人/PM 的批评意见中提取，并以积极、专业的方式表述。

继续努力的方向

按类别分组。对于 Flutter 开发者，常见类别包括：

  • 技术知识
  • 高级知识与专业化
  • 持续改进与架构
  • 领导力与沟通
  • 创新与人工智能应用

根据实际角色和技术栈调整类别。

运行生成脚本

python3 /path/to/handshake-acknowledgement/scripts/generate_pdf.py \
  --somnier "FULL NAME" \
  --lider "LEADER NAME" \
  --fecha "Dec 19, 2025" \
  --rol "Role Title" \
  --output /mnt/user-data/outputs/Handshake_Acknowledgement_Firstname_Lastname.pdf \
  --content /tmp/handshake_content_firstname.json

脚本会自动规范化日期格式。完整的内容 JSON 结构请参见 scripts/generate_pdf.py。

重要说明

  • 语言：全文使用西班牙语。
  • 语气：专业、建设性且富有同理心——文档由开发者阅读。
  • Somnio 的资历级别：Junior → Semi-Senior → Senior Medium → Senior Advance → Tech Lead
  • Puntos abordados 始终使用相同的标准议程——不得更改。
  • 如果某个部分没有内容（没有之前的评估，也没有开发者评论），请完全省略该部分。
  • 字体：正文使用 Nunito 11pt，页脚使用 Plus Jakarta Sans 9pt。如果 assets/fonts/ 中没有 TTF 文件，则使用 Liberation Sans 作为备用字体。若要安装合适的字体，请将 TTF 文件放在那里（参见脚本文档字符串）。

评论

支持 Markdown