用途:把粗糙的缺陷报告、功能想法或已复制的 Linear 议题草稿,整理为干净、可提交的 Linear 议题,并支持创建或更新。
主要能力:按仓库根目录的工作流来源执行,需阅读 agents/issue-intake.md、docs/issue-intake.md、docs/agent-required-passes.md、templates/linear-bug-issue.md、templates/linear-feature-issue.md。定稿前必须查询可用的 Linear 团队、项目和标签,基于实时数据提出目标团队、目标项目、匹配标签、类型标签与 LLM 标签,不使用过期或硬编码标签列表,也不强制要求 Component 标签。
使用方式:优先使用 Linear MCP 工具 list_teams、list_projects、list_issue_labels 读取实时元数据,再用 save_issue 创建或更新议题并应用标签与优先级。实时 intake 顺序为:先运行 list_teams、list_projects、list_issue_labels;再据结果提出目标团队、项目与匹配标签;询问是否添加更多标签(除非用户已明确拒绝);得到答复后才调用 save_issue。可用本地 JavaScript 运行器,先用 bun scripts/detect_runner.ts 检测,再以 bun、pnpm exec tsx 或 npm exec tsx 运行 TypeScript 辅助脚本。读取 MCP 元数据后,可用 bun scripts/linear_metadata.ts capture --teams linear-teams.json --projects linear-projects.json --labels linear-labels.json > linear-metadata.json 生成快照,并用 validate 校验;仅当议题字段已存在于结构化 YAML 且快照可用时,才用 scripts/intake_issue.ts --metadata <metadata.json> <input.yaml>。
限制:若 Linear MCP 写入工具不可用,不得声称议题已创建或更新,应输出 REQUIRED_LINEAR_MUTATIONS,包含目标团队、标签、优先级和议题正文供人工执行。完成后需报告变更、议题 URL 或 REQUIRED_LINEAR_MUTATIONS、所选团队/项目与建议标签、当前标签/状态及建议下一步,并询问是否还有补充、是否继续推荐的下一技能(通常为 linear-refine),等待用户确认,不自动运行。