新增 workflow Shortcut 命令，支持 Issue 分诊、PR 摘要与仓库报告 #29

muel · 2026-05-22T13:01:48+08:00

muel commented

2026-05-22 13:01:48 +08:00

合并请求描述

本次合并请求面向子赛题一“增加和完善 GitLink-CLI 能力”，基于 gitlink-cli 现有 shortcuts 架构新增一组只读型 workflow Shortcut 命令，用于辅助开源维护者完成 Issue 分诊、仓库健康度评估、PR 审阅摘要和仓库维护报告生成。

本次改动聚焦 CLI 能力增强，不引入外部 LLM 依赖，不执行远端写操作，不自动评论、打标签、关闭 Issue，也不 approve、reject 或 merge PR。所有分析均基于本地规则、测试数据或 GitLink 只读 fetch 结果完成。

变更内容

1. 新增 workflow Shortcut 命令组

新增 workflow 相关 Shortcut 能力，包含以下命令：

workflow +triage：对 Issue 进行规则型分诊，识别类型、优先级、缺失信息、风险标记和建议动作。
workflow +health：根据 Issue、PR、Release、CI、文档、License、贡献指南等指标评估仓库维护健康度。
workflow +pr-summary：根据 PR 元数据、变更文件和提交信息生成 PR 审阅摘要。
workflow +repo-report：聚合 Issue 分诊、PR 摘要和仓库健康度，生成仓库维护工作流报告。

2. 增强输入与输出能力

本次新增命令支持：

本地参数输入；
--from JSON 文件输入；
GitLink 远端只读 fetch；
json / table / markdown 三种输出格式；
en / zh-CN 语言模式。

其中 json 输出面向脚本和 AI Agent 消费，table 输出面向终端快速查看，markdown 输出面向维护者报告和 PR / Issue 场景复用。

3. 增加规则分析与响应归一化

新增 workflow 内部规则分析与评分逻辑，包括：

Issue 类型识别与优先级判断；
仓库健康度评分；
PR 变更类型与风险等级判断；
仓库维护报告聚合；
GitLink API 常见响应结构归一化；
partial failure 容错处理。

4. 补充测试与测试数据

新增 workflow 相关单元测试、fetch 测试、renderer 测试、命令 wiring 测试和 testdata 示例数据，覆盖：

triage 规则分析；
health 评分逻辑；
pr-summary 风险分析；
repo-report 聚合报告；
json / table / markdown 输出；
--from JSON 输入；
远端只读 fetch 的响应归一化与部分失败处理。

5. 更新说明文档

同步更新 README、workflow 设计说明、测试报告、PR 草稿和 Skill 使用说明，补充命令用途、参数示例、输出格式和安全边界说明。

安全边界

本次改动新增了 Issue 分诊、仓库健康度评估、PR 审阅摘要和仓库维护报告生成能力，并支持本地 JSON 输入、GitLink 远端只读 fetch、json/table/markdown 输出和中英文文案。

考虑到这些命令主要用于辅助维护者判断仓库状态和生成分析结果，本 PR 将 workflow 命令设计为“只读分析型”能力，避免在未确认的情况下对远端仓库产生副作用：

不执行远端写操作；
不自动评论；
不自动打标签；
不关闭 Issue；
不 approve / reject / merge PR；
不修改 internal/output；
不修改 cmd/；
不引入新的第三方依赖。

此外，本 PR 不依赖 LLM，而是采用规则型、可解释的分析逻辑，便于在 CLI 场景下稳定运行、测试和维护。后续如需增加写操作，可在单独 PR 中通过显式参数、dry-run 和确认机制进行设计。

测试结果

已在本地执行：

go test ./shortcuts/workflow
go test ./...
测试结果均通过。

其中：

go test ./shortcuts/workflow 用于验证本次新增 workflow 命令相关的规则分析、fetch、render、testdata 和命令 wiring。
go test ./... 用于验证本次改动未破坏仓库中其他 Go 包。

如需进行格式化检查，可执行：

gofmt -w shortcuts/workflow/*.go shortcuts/register.go

## 合并请求描述本次合并请求面向子赛题一“增加和完善 GitLink-CLI 能力”，基于 gitlink-cli 现有 shortcuts 架构新增一组只读型 workflow Shortcut 命令，用于辅助开源维护者完成 Issue 分诊、仓库健康度评估、PR 审阅摘要和仓库维护报告生成。本次改动聚焦 CLI 能力增强，不引入外部 LLM 依赖，不执行远端写操作，不自动评论、打标签、关闭 Issue，也不 approve、reject 或 merge PR。所有分析均基于本地规则、测试数据或 GitLink 只读 fetch 结果完成。 ## 相关 Issue 暂无关联 Issue。 ## 变更内容 ### 1. 新增 workflow Shortcut 命令组新增 `workflow` 相关 Shortcut 能力，包含以下命令： - `workflow +triage`：对 Issue 进行规则型分诊，识别类型、优先级、缺失信息、风险标记和建议动作。 - `workflow +health`：根据 Issue、PR、Release、CI、文档、License、贡献指南等指标评估仓库维护健康度。 - `workflow +pr-summary`：根据 PR 元数据、变更文件和提交信息生成 PR 审阅摘要。 - `workflow +repo-report`：聚合 Issue 分诊、PR 摘要和仓库健康度，生成仓库维护工作流报告。 ### 2. 增强输入与输出能力本次新增命令支持： - 本地参数输入； - `--from` JSON 文件输入； - GitLink 远端只读 fetch； - `json / table / markdown` 三种输出格式； - `en / zh-CN` 语言模式。其中 `json` 输出面向脚本和 AI Agent 消费，`table` 输出面向终端快速查看，`markdown` 输出面向维护者报告和 PR / Issue 场景复用。 ### 3. 增加规则分析与响应归一化新增 workflow 内部规则分析与评分逻辑，包括： - Issue 类型识别与优先级判断； - 仓库健康度评分； - PR 变更类型与风险等级判断； - 仓库维护报告聚合； - GitLink API 常见响应结构归一化； - partial failure 容错处理。 ### 4. 补充测试与测试数据新增 workflow 相关单元测试、fetch 测试、renderer 测试、命令 wiring 测试和 testdata 示例数据，覆盖： - `triage` 规则分析； - `health` 评分逻辑； - `pr-summary` 风险分析； - `repo-report` 聚合报告； - `json / table / markdown` 输出； - `--from` JSON 输入； - 远端只读 fetch 的响应归一化与部分失败处理。 ### 5. 更新说明文档同步更新 README、workflow 设计说明、测试报告、PR 草稿和 Skill 使用说明，补充命令用途、参数示例、输出格式和安全边界说明。 ## 安全边界本次改动新增了 Issue 分诊、仓库健康度评估、PR 审阅摘要和仓库维护报告生成能力，并支持本地 JSON 输入、GitLink 远端只读 fetch、`json/table/markdown` 输出和中英文文案。考虑到这些命令主要用于辅助维护者判断仓库状态和生成分析结果，本 PR 将 workflow 命令设计为“只读分析型”能力，避免在未确认的情况下对远端仓库产生副作用： - 不执行远端写操作； - 不自动评论； - 不自动打标签； - 不关闭 Issue； - 不 approve / reject / merge PR； - 不修改 `internal/output`； - 不修改 `cmd/`； - 不引入新的第三方依赖。此外，本 PR 不依赖 LLM，而是采用规则型、可解释的分析逻辑，便于在 CLI 场景下稳定运行、测试和维护。后续如需增加写操作，可在单独 PR 中通过显式参数、dry-run 和确认机制进行设计。 ## 测试结果已在本地执行： ```bash go test ./shortcuts/workflow go test ./... 测试结果均通过。其中： go test ./shortcuts/workflow 用于验证本次新增 workflow 命令相关的规则分析、fetch、render、testdata 和命令 wiring。 go test ./... 用于验证本次改动未破坏仓库中其他 Go 包。如需进行格式化检查，可执行： gofmt -w shortcuts/workflow/*.go shortcuts/register.go

muel added 9 commits 2026-05-22 13:01:49 +08:00

0ab9961070 Add workflow agent triage and health commands

0341db53c7 Add workflow pr-summary command

e7383efaf1 Add workflow repo-report command

19c76b7046 docs: add competition submission materials

c4db480f6a docs: align workflow agent competition materials

fcc99b1b07 docs: update final submission checklist placeholders

166d3162a8 docs: remove continuation file from PR draft

b596199d50 chore: ignore local gitlink-cli binary

33b5a00415 docs: trim materials for official PR

wbtiger force-pushed workflow-agent-suite from 4ed9497d6b to 6b355e19e2

2026-05-26 16:28:17 +08:00