GitHub Release Analyzer

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

prepare -> summarize -> render -> deliver -> commit

其中仅 summarize 为自由格式；prepare、render 和 commit 均为确定性脚本步骤。

输入

• 仓库输入：https://github.com// 或 /
• 默认 stateKey：{owner}__{repo}
• 默认模板：default
• 默认行为：
  • manual 模式：仅处理最新正式发布版本（formal release），不读写状态
  • cron 模式：仅处理正式发布版本；首次运行时仅选取最新版本，后续运行仅选取尚未处理的版本

工作流

1. 阅读 references/execution-modes.md，选择 manual 或 cron 模式。
2. 执行：

python3 skills/github-release-analyzer/scripts/run.py prepare --repo  --mode 

常用参数标志：

• --state-key
• --limit
• --include-prerelease
• --output-template default
• --initial-cron-behavior latest-only

3. 若 status=has_updates，请阅读 references/summary-contract.md，并为每个选中的发布版本生成一条摘要字符串。
   摘要语言须与调用指令的主语言保持一致。

4. 渲染最终消息：

python3 skills/github-release-analyzer/scripts/run.py render --repo  --mode  < payload.json

构建 render 的输入载荷（payload）时，需保留 render 所需的发布字段，尤其是 tag_name、published_at 和 html_url。

5. 在 cron 模式下，成功完成交付（deliver）后，提交状态：

python3 skills/github-release-analyzer/scripts/run.py commit 
  --repo  
  --mode cron 
  --processed-tags  
  --latest-release-id  
  --latest-published-at 

规则

• prepare 的输出是以下事项的唯一可信来源：版本选取逻辑、排序方式、首次运行行为、仓库路径标准化及状态存储路径。
• 输出语言必须与调用指令的主语言一致。
• 最终对外发送的消息必须由 render 生成。
• 在 cron 模式下：
  • 若 status=no_update 或 status=no_release，应严格回复 NO_REPLY
  • 若 status=has_updates，仅输出最终渲染后的消息，不得附加其他内容
• 仅当交付成功后，方可更新已处理状态（processed state）。

严格禁止项

• 不得跳过 prepare 步骤。
• 不得绕过 render 步骤。
• 不得对 prepare 所选取的发布版本进行重排序或静默丢弃。
• 不得在 manual 模式下调用 commit。
• 在 cron 模式下，不得在交付成功前调用 commit。
• 不得以任意即兴文本替代摘要契约（summary contract），摘要内容必须严格遵循 summaries[] 字符串数组结构。
• 在 cron 模式下，当 status=no_update 或 status=no_release 时，必须精确返回 NO_REPLY（不可增删空格、换行或额外字符）。
• 在 cron 模式下，不得输出任何进度提示、中间 JSON、步骤标签或工作流说明性文字。

需阅读的文件

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