docs(skills): add safe batch issue maintenance workflow #13

Closed
wangyue111 wants to merge 1 commits from wangyue111/gitlink-cli:docs/agent-safe-batch-issue-workflow into master
Contributor

背景

本 PR 补充 Agent 安全批量 Issue 维护工作流,指导 AI Agent 如何安全使用 issue +batch-close 这类批量写操作。

依赖 PR:#12 feat(issue): add batch close shortcut with dry-run support。本 PR 建议在 #12 合并后再合并。

新增内容

  • 新增 skills/gitlink-workflow/references/safe-batch-issue-maintenance.md
  • 新增 examples/workflows/safe-batch-issue-maintenance/README.md
  • 新增 examples/workflows/safe-batch-issue-maintenance/issues.csv
  • 更新 skills/gitlink-workflow/SKILL.md
  • 更新 skills/README.md

工作流规则

Agent 执行批量关闭 Issue 时必须遵守:

  1. 确认目标仓库 owner/repo。
  2. 确认 Issue 编号来源:--numbers--from
  3. 先执行 --dry-run --format json
  4. 展示 dry-run 结果。
  5. 等待用户明确确认。
  6. 去掉 --dry-run 执行真实关闭。
  7. 输出最终成功/失败报告。

示例

gitlink-cli issue +batch-close \
  --owner Gitlink \
  --repo forgeplus \
  --from issues.csv \
  --dry-run \
  --format json

用户确认后:

gitlink-cli issue +batch-close \
  --owner Gitlink \
  --repo forgeplus \
  --from issues.csv \
  --format json

价值

  • 给 Agent 批量写操作增加安全边界。
  • 提供可复现示例和 CSV 输入样例。
  • #12 的 CLI 能力组成“CLI 功能 + Agent 工作流”闭环。
## 背景 本 PR 补充 Agent 安全批量 Issue 维护工作流,指导 AI Agent 如何安全使用 `issue +batch-close` 这类批量写操作。 > 依赖 PR:#12 `feat(issue): add batch close shortcut with dry-run support`。本 PR 建议在 #12 合并后再合并。 ## 新增内容 - 新增 `skills/gitlink-workflow/references/safe-batch-issue-maintenance.md` - 新增 `examples/workflows/safe-batch-issue-maintenance/README.md` - 新增 `examples/workflows/safe-batch-issue-maintenance/issues.csv` - 更新 `skills/gitlink-workflow/SKILL.md` - 更新 `skills/README.md` ## 工作流规则 Agent 执行批量关闭 Issue 时必须遵守: 1. 确认目标仓库 owner/repo。 2. 确认 Issue 编号来源:`--numbers` 或 `--from`。 3. 先执行 `--dry-run --format json`。 4. 展示 dry-run 结果。 5. 等待用户明确确认。 6. 去掉 `--dry-run` 执行真实关闭。 7. 输出最终成功/失败报告。 ## 示例 ```bash gitlink-cli issue +batch-close \ --owner Gitlink \ --repo forgeplus \ --from issues.csv \ --dry-run \ --format json ``` 用户确认后: ```bash gitlink-cli issue +batch-close \ --owner Gitlink \ --repo forgeplus \ --from issues.csv \ --format json ``` ## 价值 - 给 Agent 批量写操作增加安全边界。 - 提供可复现示例和 CSV 输入样例。 - 与 #12 的 CLI 能力组成“CLI 功能 + Agent 工作流”闭环。
wangyue111 added 1 commit 2026-05-13 18:32:35 +08:00
wbtiger closed this pull request 2026-05-14 14:47:10 +08:00

Pull request closed

Sign in to join this conversation.
No reviewers
No Label
No Milestone
No project
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Gitlink/gitlink-cli#13
No description provided.