feat(pm): add project management shortcuts #316

ohanabi · 2026-07-02T13:15:05+08:00

ohanabi commented

2026-07-02 13:15:05 +08:00

合并请求描述

本次合并请求新增 GitLink CLI 项目管理（PM）快捷命令，覆盖看板、Sprint Issue、周报 Issue、PM 标签、PM 流水线和 Action 运行记录
等只读查询场景，减少 gitlink-pm Skill 对 Raw API 的依赖，并补齐测试、文档、i18n 与变更说明。

变更内容

1. 增强了 PM 看板查询能力

新增 pm +dashboards，支持通过 --project-id 查询指定 GitLink 项目的 PM 看板数据。

2. 增强了 Sprint Issue 查询能力

新增 pm +sprint-issues，支持查询指定项目的 Sprint Issue 列表，并支持 --page、--limit 分页参数。

3. 增强了周报 Issue 查询能力

新增 pm +weekly-issues，用于查询项目管理模块中的周报相关 Issue 数据。

4. 增强了 PM 标签查询能力

新增 pm +issue-tags，用于查询 PM 模块中的 Issue 标签数据。

5. 增强了 PM 流水线与运行记录查询能力

新增 pm +pipelines 和 pm +action-runs，用于查询 PM 视角下的流水线列表和 Action 运行记录。

6. 补齐了配套文档和测试

新增 shortcuts/pm 实现和单元测试，更新命令注册、README、README.zh-CN、i18n 文案、gitlink-pm Skill、Skills 总览和变更说明
文档。

问题描述

此前 gitlink-pm Skill 已经描述了 GitLink PM 模块的看板、Sprint、周报、标签、流水线和 Action 运行记录等使用场景，但 CLI 没有
对应的 pm Shortcut。
用户或 AI Agent 只能手动调用 Raw API，例如 /pm/dashboards、/pm/sprint_issues、/pm/weekly_issues 等路径。
这会增加路径拼接和参数传递成本，也降低 PM 场景在 CLI 中的可发现性。

问题复现步骤

使用 GitLink CLI 尝试查看某项目的 PM 看板。
尝试查看 Sprint Issue 或周报 Issue。
尝试查看 PM Issue 标签、流水线或 Action 运行记录。
发现缺少 pm 命令组，只能通过 gitlink-cli api GET /pm/... --query 'project_id=123' 手动访问。

根本原因

CLI 的 Shortcut 层此前未覆盖 GitLink PM 模块。
虽然 gitlink-pm Skill 已经列出 PM 能力，但命令实现仍停留在 Raw API 调用层，导致 PM 工作流没有一等 CLI 命令支持。

修复方案

新增 pm Shortcut 组，对 GitLink PM 只读接口进行封装：

pm +dashboards
pm +sprint-issues
pm +weekly-issues
pm +issue-tags
pm +pipelines
pm +action-runs

所有命令统一支持：

--project-id, -P：GitLink 数字项目 ID，必填
--page, -p：页码，默认 1
--limit, -l：每页数量，默认 20

本次变更同时更新 gitlink-pm Skill，使其优先使用 pm +... 命令，不再直接拼接 /pm/... Raw API；并补充 README 示例、i18n 文
案、注册测试、单元测试和变更说明。

测试验证

gofmt
git diff --check
go run ./internal/i18n/cmd/check
go test ./shortcuts/pm ./shortcuts
go test ./...

## 合并请求描述本次合并请求新增 GitLink CLI 项目管理（PM）快捷命令，覆盖看板、Sprint Issue、周报 Issue、PM 标签、PM 流水线和 Action 运行记录等只读查询场景，减少 `gitlink-pm` Skill 对 Raw API 的依赖，并补齐测试、文档、i18n 与变更说明。 ## 相关Issue 关联Issue编号：暂无 ## 变更内容 ### 1. 增强了 PM 看板查询能力新增 `pm +dashboards`，支持通过 `--project-id` 查询指定 GitLink 项目的 PM 看板数据。 ### 2. 增强了 Sprint Issue 查询能力新增 `pm +sprint-issues`，支持查询指定项目的 Sprint Issue 列表，并支持 `--page`、`--limit` 分页参数。 ### 3. 增强了周报 Issue 查询能力新增 `pm +weekly-issues`，用于查询项目管理模块中的周报相关 Issue 数据。 ### 4. 增强了 PM 标签查询能力新增 `pm +issue-tags`，用于查询 PM 模块中的 Issue 标签数据。 ### 5. 增强了 PM 流水线与运行记录查询能力新增 `pm +pipelines` 和 `pm +action-runs`，用于查询 PM 视角下的流水线列表和 Action 运行记录。 ### 6. 补齐了配套文档和测试新增 `shortcuts/pm` 实现和单元测试，更新命令注册、README、README.zh-CN、i18n 文案、`gitlink-pm` Skill、Skills 总览和变更说明文档。 ## 问题描述此前 `gitlink-pm` Skill 已经描述了 GitLink PM 模块的看板、Sprint、周报、标签、流水线和 Action 运行记录等使用场景，但 CLI 没有对应的 `pm` Shortcut。用户或 AI Agent 只能手动调用 Raw API，例如 `/pm/dashboards`、`/pm/sprint_issues`、`/pm/weekly_issues` 等路径。这会增加路径拼接和参数传递成本，也降低 PM 场景在 CLI 中的可发现性。 ## 问题复现步骤 1. 使用 GitLink CLI 尝试查看某项目的 PM 看板。 2. 尝试查看 Sprint Issue 或周报 Issue。 3. 尝试查看 PM Issue 标签、流水线或 Action 运行记录。 4. 发现缺少 `pm` 命令组，只能通过 `gitlink-cli api GET /pm/... --query 'project_id=123'` 手动访问。 ## 根本原因 CLI 的 Shortcut 层此前未覆盖 GitLink PM 模块。虽然 `gitlink-pm` Skill 已经列出 PM 能力，但命令实现仍停留在 Raw API 调用层，导致 PM 工作流没有一等 CLI 命令支持。 ## 修复方案新增 `pm` Shortcut 组，对 GitLink PM 只读接口进行封装： - `pm +dashboards` - `pm +sprint-issues` - `pm +weekly-issues` - `pm +issue-tags` - `pm +pipelines` - `pm +action-runs` 所有命令统一支持： - `--project-id, -P`：GitLink 数字项目 ID，必填 - `--page, -p`：页码，默认 `1` - `--limit, -l`：每页数量，默认 `20` 本次变更同时更新 `gitlink-pm` Skill，使其优先使用 `pm +...` 命令，不再直接拼接 `/pm/...` Raw API；并补充 README 示例、i18n 文案、注册测试、单元测试和变更说明。 ## 测试验证 - `gofmt` - `git diff --check` - `go run ./internal/i18n/cmd/check` - `go test ./shortcuts/pm ./shortcuts` - `go test ./...`

ohanabi added 1 commit 2026-07-02 13:15:06 +08:00

132151d68e feat(pm): add project management shortcuts

wbtiger referenced this issue from a commit

2026-07-14 22:54:53 +08:00

Merge PR #316: feat(pm): add project management shortcuts

wbtiger closed this pull request

2026-07-14 22:57:05 +08:00

wbtiger reopened this pull request

2026-07-14 23:02:18 +08:00

wbtiger closed this pull request

2026-07-14 23:05:45 +08:00