用途:kata-check-issues 用于审查已记录的待办想法并决定接下来做什么。它把本地 .planning/issues 下的 open 与 in-progress 事项列出,并可选合并 GitHub 上带 backlog 标签的 issue,供用户选择处理。
主要能力:
- 迁移:若存在 .planning/todos/pending 且无 _archived,则创建 .planning/issues/open、in-progress、closed,把 pending 复制到 open、done 复制到 closed,并归档原目录。迁移是幂等的。
- 列表:先显示 in-progress(带 [IN PROGRESS]),再显示 open;本地 issue 显示其 area,仅存在于 GitHub 的 issue 显示 [GH]。
- 去重:从本地文件的 provenance 字段提取已跟踪的 GitHub issue 编号,避免重复显示。
- 过滤:可用 /kata-check-issues [area] 按领域过滤。
- 详情与操作:选择编号后查看详情;对 in-progress 可标记完成、继续工作、放回 open、查看详情;对 [GH] 可拉取到本地、立即处理、在 GitHub 打开、返回。
- 拉取:用 gh issue view 获取详情,生成带 provenance 的本地文件,便于后续去重。
- 路线图关联:可将 issue 关联到已有阶段,写入 linked_phase 与 STATE.md 的 Pending Issues 段。
使用方式:通过 /kata-check-issues 触发;GitHub 相关操作需 github.enabled 为 true 且已安装 gh CLI。
限制:GitHub 功能依赖 gh CLI 与配置;部分命令在特定 gh 版本上行为不同;资料未提供收费、平台与效果信息。