关于 summarizing-shipped-work
用于根据已合并的 Pull Request 编写简洁交付报告的技能。它规定仓库筛选、时间范围解析、按产品领域归并变更及报告格式规则。
主要功能
- 01解析指定报告周期
- 02获取已合并的 Pull Request
- 03按产品或系统归并变更
- 04筛选并排序报告条目
- 05遵循报告格式与链接规则
适用场景
- 01汇总某个周期内合并的工作
- 02归并跨仓库的相关变更
- 03编写面向用户的发布或进度报告
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ bostonaholic/ skills --skill summarizing-shipped-work安装后在 Claude Code 中输入/summarizing-shipped-work确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/report-format.mdscripts/fetch-shipped-prs.shresolve-timeframe.mjs详细介绍
总结已交付的工作
范围
一开始不要提问。只搜索用户指定的所有者(如果有)。当用户只询问工作内容时,省略个人和琐碎的仓库,并在报告末尾用一行列出它们。
时间范围
将 <skill-dir> 解析为此技能的绝对目录。将请求映射为 scripts/resolve-timeframe.mjs 文件头中的一个 PERIOD 标记(用户未指定时使用 this-week),然后运行:
node "<skill-dir>/scripts/resolve-timeframe.mjs" PERIOD
该命令会打印 START END。如果退出码为 64,请修正标记并重新运行。
获取已合并的 PR
将 <out> 设为临时目录,然后运行:
"<skill-dir>/scripts/fetch-shipped-prs.sh" START END [OWNER...] > <out>/shipped.jsonl; echo "rc=$?"
如果退出码非 0:
- 报告脚本错误并停止:文件不完整。
- 不要总结、列出或分组其中的任何 PR,也不要提出这样做,即使标注为部分结果也不行。
- 退出码为 64 表示日期或参数错误:修正调用并重新运行。
- 对于其他错误,例如 HTTP 5xx,告知用户等问题消除后再重新运行一次。
分组和总结
按产品或系统分组,而不是按仓库分组:服务变更、其 UI 屏幕和文档属于同一项。在每个领域内添加加粗的主题子标题,并将重构、测试基础设施、CI 和 lint 修复放在该领域最后的 Engineering health 子标题下。
每项变更用一句话,用普通用户能理解的语言描述系统变更。将交付同一项变更的 PR 合并为一行;将一系列相似的 PR 合并为一行,并注明数量。
排除版本升级、同一时间段内已合并工作的回滚,以及内容仅为修复前一个 PR 的 PR。
每行末尾都要附上链接,用括号括起,以逗号分隔:先列 PR,再列 issue。
- PR 标签:
pr_label。 - Issue 标签:工单键(
OPS-123),或 GitHub issue 的repo#number。 - Issue 来源,按以下顺序:
title_ticket_links中的 URL;否则使用 PR 正文中引用为该 PR 所属工单的issue_links。跳过正文中仅作为相关背景或后续工作的工单。 title_ticket_links中 URL 为 null 的键保持未链接状态,除非会话中的 issue 跟踪工具提供了其 URL。
报告
撰写报告时阅读 references/report-format.md:其中包含 Markdown 模板、章节顺序和排序规则。
成就文档
- 报告之后,如果用户指定了成就文档,或其
AGENTS.md或记忆中记录了成就文档,则提出将亮点添加到该文档;否则以报告结束。 - 遵循文档现有结构,展示确切的拟议差异,并且只在获得批准后写入。
- 只添加文本;绝不覆盖或删除现有文本。
评论
支持 Markdown