diff --git a/.agents/skills/unidesk-gh/SKILL.md b/.agents/skills/unidesk-gh/SKILL.md index 1dbb694e..f00aaaa7 100644 --- a/.agents/skills/unidesk-gh/SKILL.md +++ b/.agents/skills/unidesk-gh/SKILL.md @@ -47,6 +47,7 @@ trans gh:/pikasTech/unidesk/issue/ cat trans gh:/pikasTech/unidesk/issue/ rg bun scripts/cli.ts gh issue comments --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 --repo pikasTech/unidesk --body-stdin bun scripts/cli.ts gh pr list --repo pikasTech/unidesk --state all --limit 10 trans gh:/pikasTech/unidesk/pr/ cat trans gh:/pikasTech/unidesk/pr/ rg diff --git a/docs/MDTODO/cli-output-progressive-disclosure.md b/docs/MDTODO/cli-output-progressive-disclosure.md index a1fb649c..7e3bd584 100644 --- a/docs/MDTODO/cli-output-progressive-disclosure.md +++ b/docs/MDTODO/cli-output-progressive-disclosure.md @@ -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)。 diff --git a/docs/MDTODO/details/cli-output-progressive-disclosure/R12_Task_Report.md b/docs/MDTODO/details/cli-output-progressive-disclosure/R12_Task_Report.md new file mode 100644 index 00000000..9800744f --- /dev/null +++ b/docs/MDTODO/details/cli-output-progressive-disclosure/R12_Task_Report.md @@ -0,0 +1,25 @@ +# R12 任务报告 + +## 结论 + +在 `unidesk-gh` 高频命令表增加参数化入口: + +`bun scripts/cli.ts gh issue comment create --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。