Linear Ticket 技能用于约束在 Linear 中创建或更新单个工单的流程与规则。它依赖 Linear MCP 服务器;若不可用,应先解决该前置条件再写入。调用方工作流自行负责范围、授权、调度和执行顺序,本技能提供工单起草、元数据、变更和验证。
目的地、范围与授权
独立创建时,先列出可用团队请用户选择,再列出该团队项目请用户选择,重复两者名称并在分析与起草前获得明确确认。更新时,解析提供的 issue 标识符或 URL,核验其账户/工作区、团队和项目。缺失或有歧义时询问。保留精确的团队/项目 ID,并在复用或变更前在相关 issue 上核验两者。独立创建和 backlog 规划时,列出目的地的里程碑和所有匹配 issue(含分页、已完成/归档项),比较完整描述、标准和状态,复用已覆盖工作、收窄部分重叠并披露遗漏。创建前立即刷新重叠。
阅读完整需求、评论、带需求的附件及相关仓库上下文。主来源优先级:显式来源、已确定的会话计划/规格、根目录 PLAN.md;均无或来源选择实质影响范围时询问。支持性上下文只约束语言和决策,不扩大请求工作。稳定来源若为同团队/项目 issue,用原生父级保留;否则用描述中可选的 Source 节。除非明确批准,不改来源 issue。
独立创建或实质性编辑需先展示拟议工单和预期变更以供批准,除非请求已明确授权具体编辑或调用方工作流已批准。研究、建议或审查请求保持只读。仅复用现有 issue 不授权编辑。重命名、移动或重新编号须在批准变更中明确包含。未经授权不得分配、委托、加入周期或关闭 issue。
起草工单
交付狭窄、完整、可独立验证的成果,通常对一个 PR 边界。优先跨必要层次的垂直切片。每个新工单(含 Human 和 prefactoring 工作)及经授权的描述重写使用以下格式:
<简明平实的用户故事。>
What to build
<从用户视角的端到端成果。>
Acceptance criteria
- [ ] <可观察、可验证的成果>
Context
<仅持久决策与约束;不必要时省略。>
Source
<稳定来源引用;由原生父级关系表示或无稳定引用时省略。>
开头用一两句简短、无需技术背景即可理解的话说明谁需要什么及原因,自然时用 As a <person>, I want <outcome> so that <benefit>。实现细节放在故事下方。避免脆弱路径和片段。未授权编辑现有描述时保持不动,缺失或不明确的故事应提请批准而非静默重写。
展示标题、现有/新状态、开头故事、交付成果、标准、执行者(Agent 或 Human)、标签、来源、原生关系、估算和简短规模理由。标明变更的估算和暂定规模假设。更新时区分每个预期变更与需保留字段。
元数据与关系
命名或创建工单前,阅读 Linear 里程碑和 issue 编号规则。每个新工单恰好归属一个按其成果选择的原生项目里程碑(含单工单变更和后续)。复用匹配里程碑或提议新的。遵循引用的编号分配、插入批准和回读规则;例行状态、估算和周期变更保留名称和里程碑位置。按 ID 解析团队明确的原生工作流状态;新工单通常从 Backlog 开始,调用方可指定其他授权状态。复用持久的类型/领域标签,仅在有用时创建缺失的持久标签。有用时用两到三个标签:agent 工单通常有 Agent、一个类型、可选一个领域。Human 工单绝不加 Agent。
可用时用原生父级、相关 issue 和 blockedBy 字段而非文字替代。从实际前置条件推导阻塞,用最少的直接边表示。每个阻塞者须在里程碑/issue 总顺序中更早;仅编号不产生依赖。独立 issue 保持无阻塞。关系不决定里程碑。批准移动或重编号前暴露顺序冲突;较早里程碑从不作为笼统门槛。
后续工作应在提供的实现目标之外建立具体、可独立行动的工作,先检查范围内重叠。支持时用原生方式关联到其来源目标。阻止完成的先决条件仍作为已报告阻塞。仅在仓库证据确立过时内容、关系或状态时编辑现有相关 issue。处理为满足前阅读并核验每个验收标准;部分或仅标题重叠不足。
估算
在起草估算或写入工单前阅读并应用 Native estimates 技能,它负责规模发现、估算、保存原生值和估算错误恢复。除非调用方限制重新评估,评估每个新建或编辑的工单(含状态和关系变更);未授权编辑的复用 issue 保持不动。
写入与验证
写入前立即刷新 issue 或创建重叠、目的地、相关元数据和已分配编号。对照授权提案协调并发变更。按批准名称和顺序在工单前创建已批准的缺失里程碑。只写批准字段;现有 issue 上保留其他字段。实现期间的状态转换保留已完成、已取消、已归档和更靠后状态;除非明确指示,合并后关闭交给配置的自动化。
应用批准的 native 估算和引用的组合写入恢复流程。显式报告操作失败和部分结果。发布多个工单时,先按调用方批准顺序创建所有 issue,再在所有引用标识符存在后应用关系。单个工单则写入前解析所有关系标识符。核验每个已批准依赖边,不虚构阻塞者。
重新读取保存字段。新 issue 核验标识符/URL、团队/项目、标题、里程碑和前缀、状态、标签、估算、来源和关系;确认 Agent/Human 分类与标签一致。现有 issue 核验身份、每个授权变更和保留元数据,不规范化无关字段。新建或显式编辑的描述核验批准的开头故事和格式。考虑分页和关系列表截断:部分视图不能确立空阻塞集。记录服务端变更(如周期分配时 Backlog 变为 Todo)。报告成功前纠正在范围内的不匹配。
返回标识符、URL、已验证变更和状态、保存的估算及理由、暂定假设,以及任何禁用估算结果、未解决错误或部分写入。调用方可将其纳入自身的有序报告。