用途:在 Kata 会话进行中,把临时出现的想法、任务或问题快速捕获为结构化 issue,避免丢失上下文或打断当前工作。
主要能力:无参数时分析近期对话,提取问题、相关文件路径与技术细节,生成标题、问题描述、解决思路提示、涉及文件与来源(provenance)等字段;按路径自动归类 area(如 api、ui、auth、database、testing、docs、planning、tooling、general);检测潜在重复 issue 并询问跳过、替换或仍新建;生成 slug 后写入 .planning/issues/open/日期-slug.md。
GitHub 集成:读取 github.enabled 配置,启用时创建 backlog 标签并调用 gh issue create 同步为 GitHub Issue,再把本地 provenance 更新为 github:owner/repo#N;所有 GitHub 操作失败仅警告,不阻塞本地文件创建。
迁移与提交:若存在旧 .planning/todos/pending 且无 _archived,则把 todos 迁移为 issues 结构,迁移幂等。根据 commit_docs 配置决定是否 git add 并提交 issue 文件与 STATE.md。
限制:不用于当前计划内的工作(属偏差规则范畴);不写详细方案,只捕获想法;信息缺失可用 TBD;GitHub 同步需 gh 已认证。