核对基线:2026-10-10,main / v0.7.4 1b9de43514ff4f0588b06fdd4cff930fe74ce5f0。当前官方 OpenAPI 已提供以下能力,但 CLI 尚无对应专用命令;不据此推断接口的具体上线日期。
1b9de43514ff4f0588b06fdd4cff930fe74ce5f0
pkg/cmd/org/org.go 与当前 Discussion API 层尚无组织讨论写操作。#162 的仓库编辑接口不能替代组织端点。
pkg/cmd/org/org.go
基于组织 Discussion 读取能力,增加组织讨论 create/edit/delete,以及评论创建、回复、编辑、删除入口。组织路径显式传入,命令命名、正文文件/stdin 和删除确认与仓库 Discussion 保持一致。
使用 /api/v5/orgs/:org/discuss 及其 /:number、/:number/comment、/:number/comment/:id、/:number/comment/:id/reply 文档化写端点;创建/编辑讨论字段按官方 JSON 契约,评论正文为 md_content。不将文档 URL 中的单数 org 误用为 API 路径。只包含这些写操作,不包含锁定、关闭、点赞或采纳。
/api/v5/orgs/:org/discuss
/:number
/:number/comment
/:number/comment/:id
/:number/comment/:id/reply
md_content
实现讨论与评论的各个写操作,路径、方法、JSON Content-Type 和成功状态与官方文档一致;写请求不自动重试。
编辑讨论保留未指定字段,读取失败不写入;body/body-file 互斥并支持 stdin,明确空值规则。
评论 ID 保留字符串;编辑/删除校验组织、讨论和评论归属;删除使用共享确认与 --yes。
mock 覆盖每个端点、部分字段编辑、读取失败、正文输入、取消删除及 200 空删除响应。
参数在请求前校验;复用 Factory、现有 API 客户端和安全输出,错误包含操作上下文且不泄露凭据。
mock HTTP 测试覆盖方法、路径编码、请求/响应契约、权限不足、资源不存在及异常响应,不使用真实账号验证写操作。
更新 docs/usage.md、docs/openapi-coverage.md 及相关覆盖清单,按仓库流程同步生成命令参考;新命令进入 schema/manpage 命令树,并补充适用的能力元数据。
docs/usage.md
docs/openapi-coverage.md
通过仓库要求的格式检查、Go 测试、构建及对应命令 --help 冒烟检查。
--help
背景与代码证据
核对基线:2026-10-10,main / v0.7.4
1b9de43514ff4f0588b06fdd4cff930fe74ce5f0。当前官方 OpenAPI 已提供以下能力,但 CLI 尚无对应专用命令;不据此推断接口的具体上线日期。pkg/cmd/org/org.go与当前 Discussion API 层尚无组织讨论写操作。#162 的仓库编辑接口不能替代组织端点。目标与范围
基于组织 Discussion 读取能力,增加组织讨论 create/edit/delete,以及评论创建、回复、编辑、删除入口。组织路径显式传入,命令命名、正文文件/stdin 和删除确认与仓库 Discussion 保持一致。
使用
/api/v5/orgs/:org/discuss及其/:number、/:number/comment、/:number/comment/:id、/:number/comment/:id/reply文档化写端点;创建/编辑讨论字段按官方 JSON 契约,评论正文为md_content。不将文档 URL 中的单数 org 误用为 API 路径。只包含这些写操作,不包含锁定、关闭、点赞或采纳。验收标准
官方接口文档