用途：在 Kata 会话进行中，把突然出现的想法、任务或问题快速记录为结构化 issue，避免丢失上下文或打断当前工作，形成“思考→捕获→继续”的流程。
主要能力：无参数时分析近期对话，提取问题、相关文件路径与技术细节，生成标题、问题描述、解决思路（可为 TBD）、相关文件与来源（provenance）等字段；按路径推断 area（如 api、ui、auth、database、testing、docs、planning、tooling、general）；检测潜在重复 issue 并让用户选择跳过、替换或仍新建；将 issue 写入 .planning/issues/open/ 下的 markdown 文件；可选同步到 GitHub（需 github.enabled=true），创建带 backlog 标签的 issue 并回写 provenance；更新 .planning/STATE.md；按 commit_docs 配置提交到 git。
使用方式：通过 /kata-add-issue 调用。旧版 todos 会迁移到 issues 结构（迁移幂等，存在 _archived/ 即表示已迁移）。GitHub 同步使用 gh 命令，如 gh label create "backlog" --description "Kata backlog issues" --force 与 gh issue create --title "$TITLE" --body-file /tmp/issue-body.md --label "backlog"。
适用场景：Kata 会话中临时冒出、不属于当前计划范围的待办事项。
限制：不要为当前计划内的工作创建 issue；解决思路部分应保持简短，只捕获想法而非完整计划；信息缺失时可用 TBD；GitHub 操作失败不阻塞本地文件创建；未认证 gh 时跳过同步。