# GitHub Issue

Issue 写入使用 `bun scripts/cli.ts gh ...` 或 `trans gh:` 虚拟文件系统。

- 正文和评论默认使用中文。
- 最近评论进展优先使用 `bun scripts/cli.ts gh issue comments <number> --repo owner/name [--limit N] [--full|--raw]`；结构化输出稳定在 `.data.comments`。
- `gh issue view <number> --json comments` 只保留为 `.data.json.comments` 的兼容入口；请求评论时必须提示 bounded `gh issue comments <number>`，不得引导操作者恢复 `/tmp` dump。
- 人工完整正文使用 `trans gh:/owner/repo/issue/<number> cat`；定点查找使用同一路由的 `rg <pattern>`。
- `gh issue view <number> --json body,...`、`--full` 和 `--raw` 只用于显式机器结构化披露；正文只在 `.data.issue.body` 输出一次。
- 新 issue 必须包含 `目标合并分支`。
- 多阶段架构、API 或平台 issue 以 `P0 SPEC 先行` 开始。
- 长正文使用 `--body-stdin`。
- Issue close/reopen 生命周期评论使用 `--comment-stdin <<'EOF'`；不支持内联 `--comment` 和生命周期 `--comment-file`。
- 默认 view 只返回有界元数据、正文摘要和 Next，不创建 dump；评论进展使用 bounded `gh issue comments`。
