# Issue tracker：GitHub

此仓库的 issue 和 PRD 存放在 `liu-qingyuan/pi-video-tui` 的 GitHub Issues 中。使用 `gh` CLI 操作。

## 惯例

- 创建：`gh issue create --title "..." --body "..."`
- 阅读：`gh issue view <number> --comments`
- 列出：`gh issue list --state open --json number,title,body,labels,comments`
- 评论：`gh issue comment <number> --body "..."`
- 标签：`gh issue edit <number> --add-label "..."` 或 `--remove-label "..."`
- 关闭：`gh issue close <number> --comment "..."`
- 从当前仓库的 `git remote` 推断目标仓库。

issue 标题、正文、评论和完成摘要默认使用中文。标签、命令、路径、代码标识符、配置键和错误原文保留原 token。

## Triage 表面

外部 PR 不作为请求入口。`triage-lqy` 只处理 GitHub Issues，不把 PR 拉入同一队列。

## Skill 约定

“发布到 issue tracker”表示创建 GitHub issue；“获取相关 ticket”表示运行 `gh issue view <number> --comments`。

## Wayfinding

map 使用带 `wayfinder:map` 标签的 GitHub issue，child Ticket 使用 sub-issue；不可用时回退到 map 正文 task list。阻塞关系优先使用 GitHub issue dependencies，不可用时使用 `Blocked by: #<n>`。claim 时 assign 给当前用户，resolve 时评论结论并关闭 issue。