从Git历史生成成就文档
目标:将你实际交付的工作转化为可编辑的草稿,而无需编造影响。成就文档列出工作与成果;本技能收集工作,并将每个缺失的成果标记为空白供你填充。
第一步:收集证据
询问时间窗口(默认:最近6个月)和仓库。然后,在已登录的GitHub CLI中执行:
gh search prs --author @me --merged --merged-at ">=YYYY-MM-DD" --json title,url,closedAt,repository --limit 200
对于不在GitHub上的代码,在每个仓库中使用 git log --author="<name or email>" --since="YYYY-MM-DD" --no-merges --pretty="%h %ad %s" --date=short。同时询问用户粘贴Git无法展示的内容:事件处理、指导、评审工作、演讲、文档、值班、设计决策、同事好评。
不要读取用户未指定的私有仓库。不要猜测姓名、团队或数字。
第二步:分组,暂不总结
将条目按主题分组(例如:可靠性、新功能、性能、工具、指导、跨团队工作)。在主题下列出每个条目,附上日期和链接。合并重复项(一个功能PR及其后续修复)。
第三步:草拟每个主题
为每个主题撰写:
- 我做了什么:使用纯动词写一两句话,仅使用标题、差异和用户笔记支持的内容。
- 结果:仅当提供了数字、引用或结果时才填写。否则写
[GAP: 对用户或团队有何变化?是否有前后指标?]。 - 证据:链接。
- 范围信号(如支持):领导、独立完成、跨团队协作、值班、评审他人。
第四步:以空白和问题结束
以每个[GAP]的列表结束,按其对增强论据的价值排序,并列出三个最有助于填补空白的问题。主动提供将最终版本转换为自评、晋升材料大纲或简历要点。
规则
- 绝不编造指标、百分比、客户名称、标题或范围。一个明显的空白远比一个编造的数字好。
- 不要夸大:“贡献于”仍是“贡献于”。动词需与证据匹配。
- 保持用户信用诚实:如果PR是团队合作,说明他们负责的部分。
- 除非用户说明文档是内部使用,否则保持私密或机密信息不外泄。
- 输出Markdown,用户可直接粘贴到笔记中。