GitHub 发布版本分析器

使用此技能作为固定流程：

准备 -> 摘要 -> 渲染 -> 交付 -> 提交

只有 摘要 步骤为自由格式。准备、渲染 和 提交 均为确定性脚本步骤。

输入

• 仓库输入：https://github.com/<所有者>/<仓库> 或 <所有者>/<仓库>
• 默认 stateKey：{所有者}__{仓库}
• 默认模板：default
• 默认行为：

- 手动模式：仅最新正式发布版本，不读写状态

- 定时任务模式：仅正式发布版本，首次运行选择最新版本，后续运行选择未处理版本

工作流

1. 读取 references/execution-modes.md 并选择 manual 或 cron 模式。
2. 运行：

python3 skills/github-release-analyzer/scripts/run.py prepare --repo <仓库> --mode <manual|cron>

常用参数：

• --state-key <键>
• --limit <数量>
• --include-prerelease
• --output-template default
• --initial-cron-behavior latest-only

1. 若 status=has_updates，读取 references/summary-contract.md，为每个选中的发布版本生成一条摘要字符串。

保持摘要语言与调用指令的主语言一致。

1. 渲染最终消息：

python3 skills/github-release-analyzer/scripts/run.py render --repo <仓库> --mode <manual|cron> < payload.json

构建 render 的输入数据时，请保留 render 所需的发布字段，特别是 tag_name、published_at 和 html_url。

1. 在定时任务模式下，交付成功后提交状态：

python3 skills/github-release-analyzer/scripts/run.py commit \
  --repo <仓库> \
  --mode cron \
  --processed-tags <逗号分隔的标签列表> \
  --latest-release-id <ID> \
  --latest-published-at <ISO8601 格式时间>

规则

• 将 prepare 的输出视为选择、排序、首次运行行为、仓库规范化和状态路径的唯一依据。
• 输出语言必须遵循调用指令的主语言。
• 最终输出消息必须来自 render。
• 在定时任务模式下：

- 若 status=no_update 或 status=no_release，返回 NO_REPLY

- 若 status=has_updates，仅输出最终渲染的消息

• 仅在交付成功后更新已处理状态。

硬性禁止项

• 不得跳过 prepare 步骤。
• 不得绕过 render 步骤。
• 不得重新排序或静默丢弃 prepare 选定的发布版本。
• 不得在手动模式下调用 commit。
• 不得在定时任务模式中交付成功前调用 commit。
• 不得用非结构化文本替换摘要契约，必须保持 summaries[] 字符串数组格式。
• 在定时任务模式下，当 status=no_update 或 status=no_release 时，必须精确返回 NO_REPLY。
• 在定时任务模式下，不得输出进度提示、中间 JSON、步骤标签或工作流叙述。

需要读取的文件

• references/execution-modes.md
• references/summary-contract.md
• references/templates.md
• references/state-format.md