用途:按 Agenta 团队的规范撰写并提交 Linear 议题(bug 与功能请求),也可用于起草 GitHub 议题。目标是把问题写到队友无需追问即可动手复现或理解的程度。
主要规则与能力:标题以括号标注类型前缀,如 (bug)、(feat),必要时 (chore)、(docs),用平实语言描述症状或需求,而不是根因;bug 正文以用户口吻的复现描述开头,再给出编号复现步骤、真实请求与响应、错误或日志、截图、复现环境与版本;正文不写根因或“为什么发生”,那部分属于修复 PR;功能请求先讲用户视角的问题或目标,再描述期望行为,除非用户要求否则不写实现设计;仅当交付拆分为多个有序 PR 时才加复选框待办。
Linear 字段:文件在 Agenta 团队(key AGE),按需选择 Project、标签(类型、区域、UX、可见性)、优先级(0 None 到 1 Urgent 等)和状态流转(Todo → In Progress → In Review → In QA → Done,另有 Backlog、Canceled、Duplicate)。可见性标签 Public 会触发 Linear ↔ GitHub 同步,生成关联的 GitHub 议题。
使用方式:先用 mcp__linear-server__list_projects 列出项目匹配区域,创建时调用 mcp__linear-server__save_issue 传入 team、title、description(Markdown、真实换行)、project、labels、priority,可用 relatedTo 关联议题、用 links 附上 PR。创建后可用 gh issue list --repo Agenta-AI/agenta --search "<keywords>" 找到自动生成的 GitHub 议题,并在 PR 正文加 Closes #<n>(或 Refs #<n>)。自行改状态则再次调用 save_issue 并传 issue id 与 state。创建前需按清单自查标题、正文、待办、字段与 Public 标签,创建后确认 GitHub 议题已找到并完成链接与状态设置。
限制:资料未说明该技能的安装方式、运行环境依赖、费用或适用范围之外的其他平台支持,这些暂未提供。