用途:当一个问题或想法已在对话(如 Superpowers 的 brainstorming 或其他 AI 会话)中讨论完,用户希望先记录追踪而非立即开发时使用。它在用户明确表示“记录下来/转成 issue”后运行。
主要能力:从对话中提取标题、问题、预期结果、受影响用户与系统、约束(硬性限制及用户明确做出的决定,视为约束)、未决问题,按 assets/intent-issue.md 模板同标题同顺序填写;记录的是意图而非规格,不写入仅被考虑过的方案、边界分析或未确定的设计细节。空章节写“None identified”。创建前先展示草稿并确认。
使用方式:先检查 docs/agents/issue-tracker.md,不存在则提示先运行 setup-issue-tracker 并停止。GitHub 后端用其中记录的 owner/repo,确认 gh 已认证(gh auth status),未认证则提示运行 gh auth login 并停止;本地 markdown 后端写入 .scratch/<feature>/,以 slug 化标题为文件名。确认后的创建命令:gh issue create --repo <owner>/<repo> --title "<title>" --body-file <tmp-file> --label <label>(默认 intent,标签不存在先用 gh label create <label> 创建)。完成后返回 issue 的 URL 或文件路径。
适用场景与限制:适用于已有意图问题之前的工作,作为“先追踪”路径,superpowers-issue-bridge 会据此启动 brainstorming 并回链成果。不要在半途运行;不为空章节编造内容;不把仅被考虑的选项记入约束;不静默创建;不猜测目标仓库;创建后不继续进入规格、计划或代码,除非用户此时要求开发。非 Claude Code 环境可按资料给出的纯提示词模板手动执行。