docs: 补齐 issue 评论最短入口

2026-07-16 06:06:47 +02:00
parent 8298c5ce74
commit 5c573dbd94
3 changed files with 30 additions and 0 deletions
@@ -47,6 +47,7 @@ trans gh:/pikasTech/unidesk/issue/<number> cat
 trans gh:/pikasTech/unidesk/issue/<number> rg <pattern>
 bun scripts/cli.ts gh issue comments <number> --repo pikasTech/unidesk --limit 8
 bun scripts/cli.ts gh issue create --repo pikasTech/unidesk --title "标题" --body-stdin
+bun scripts/cli.ts gh issue comment create <number> --repo pikasTech/unidesk --body-stdin
 bun scripts/cli.ts gh pr list --repo pikasTech/unidesk --state all --limit 10
 trans gh:/pikasTech/unidesk/pr/<number> cat
 trans gh:/pikasTech/unidesk/pr/<number> rg <pattern>
@@ -146,3 +146,7 @@
 ## R11 [completed]

 解决 [UniDesk #2104](https://github.com/pikasTech/unidesk/issues/2104)：把 CLI-SPEC 的只读观测等待规则和 `unidesk-cicd` 受控观测入口统一为默认 `120s` 长轮询，目标完成或状态满足时立即返回，未完成等待至超时并明确返回当前状态、timedOut 与稳定继续入口；禁止 CLI 本地高频短轮询、忙轮询和无输出，mutation 与交付 authority 保持 fire-and-forget，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R11_Task_Report.md)。
+
+## R12 [completed]
+
+解决 [UniDesk #2268](https://github.com/pikasTech/unidesk/issues/2268)：在 `unidesk-gh` 高频入口直接给出 issue 普通评论的 quoted-heredoc 命令，避免同类收口任务额外调用 scoped help；只改 skill 和任务报告，不修改 CLI 实现、业务仓库、身份/RBAC、安全、部署或 CI/CD，完成任务后将详细报告写入[任务报告](./details/cli-output-progressive-disclosure/R12_Task_Report.md)。
@@ -0,0 +1,25 @@
+# R12 任务报告
+
+## 结论
+
+在 `unidesk-gh` 高频命令表增加参数化入口：
+
+`bun scripts/cli.ts gh issue comment create <number> --repo pikasTech/unidesk --body-stdin`
+
+适用任务是完成开发、验证或运维后向既有 GitHub issue 写普通进展评论。可变输入为仓库、issue 编号和 stdin 正文；不适用于 issue 生命周期 close/reopen 评论、评论读取或正文更新。
+
+## 调用数改进
+
+- 改进前：skill 中缺少精确入口，同类任务需要先调用一次 scoped help，再调用一次 comment create，共 2 次。
+- 改进后：从已加载 skill 直接执行 comment create，共 1 次。
+- 每次同类任务减少 1 次不必要的语法试探调用。
+
+## 验证
+
+- `quick_validate.py .agents/skills/unidesk-gh`：通过。
+- `bun scripts/cli.ts gh issue comment create --help`：显示的 usage 与新增入口一致。
+- `git diff --check`：通过。
+
+## 边界
+
+未修改 CLI 实现、业务仓库、身份/RBAC、安全、部署或 CI/CD，也未触碰 PikaOA PR #51。