to-linear

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

To Linear

对接Linear

Create narrow, end-to-end Linear tickets. Every ticket belongs to the confirmed project and a native milestone. Mark only agent-suitable work with
Agent
.
创建范围明确、端到端的Linear工单。所有工单均归属已确认的项目及原生里程碑。仅将适合Agent处理的工作标记为
Agent

Process

流程

1. Confirm the destination

1. 确认目标位置

Before analysing or drafting tickets:
  1. List all available teams with the Linear MCP server and ask the user to choose one.
  2. List that team's projects and ask the user to choose one.
  3. Repeat both names and obtain explicit confirmation.
Never infer the destination. Every ticket in the run uses the confirmed team and project unless the user restarts selection.
在分析或起草工单前:
  1. 列出Linear MCP服务器上的所有可用团队,请求用户选择其一。
  2. 列出该团队的所有项目,请求用户选择其一。
  3. 重复上述团队和项目名称,获取用户的明确确认。
永远不要自行推断目标位置。除非用户重新选择,否则本次生成的所有工单都将使用已确认的团队和项目。

2. Resolve the source, context, and existing tickets

2. 确定来源、上下文及现有工单

Resolve exactly one primary source for scope, in this order:
  1. An explicit source supplied with the invocation or explicitly designated by the user for this run: a file, issue identifier or URL, or pasted plan/spec. Fetch and read the full body and comments of a referenced issue.
  2. Otherwise, the most recent settled plan or spec in the current conversation. If it points to an artifact, fetch and read that artifact fully.
  3. Otherwise, root
    PLAN.md
    , when present; read it fully.
  4. Otherwise, stop and ask the user for the source.
An explicit source wins even when
PLAN.md
exists. State which source was selected. Do not merge multiple plausible sources into new scope; ask when source selection is ambiguous or when a contradiction materially changes the intended outcome.
Treat
CONTEXT.md
, applicable
AGENTS.md
, referenced sources, relevant ADRs, designs, code, and tests as supporting context. Read them when they affect ticket accuracy.
CONTEXT.md
is authoritative for domain language, boundaries, and durable decisions, but supporting context never silently expands the primary source.
Preserve provenance when the primary source has a stable reference. If it is a Linear issue in the confirmed team and project, propose a native parent relationship. Otherwise include the reference in each new ticket's optional
Source
section. Never modify or close the source issue unless the user explicitly approves it.
For broad work, use subagents for bounded, independent, read-only exploration such as separate module investigations, prior-art searches, or overlap checks. Continue other independent analysis while they work, then reconcile every result before drafting. The primary agent owns source selection, the complete proposal, user approval, and every Linear mutation; never create or edit Linear items concurrently through subagents.
After destination confirmation and before drafting, list the project's milestones and every issue whose team and project both match the confirmed destination, following pagination and including completed or archived issues where available. Search same-team issues in other projects only to surface possible cross-project overlap; never reuse them in this run. Compare in-project milestone scope and issue titles, descriptions, acceptance criteria, and status with the primary source:
  • Reuse existing milestones that match a planned phase.
  • Reuse existing issues that already cover planned work only when their team and project both match the confirmed destination; do not duplicate them.
  • Narrow or omit proposed work that partially overlaps, and explain the overlap during review.
  • Do not modify, rename, or close existing issues unless the user explicitly approves it.
Recheck for newly created overlaps immediately before publishing.
按以下优先级确定唯一的主要来源作为范围依据:
  1. 调用时提供的明确来源,或用户为本次运行指定的明确来源:文件、议题ID或URL,或粘贴的计划/规格说明。获取并读取关联议题的完整内容及评论。
  2. 若无可选明确来源,则取当前对话中最新的已敲定计划或规格说明。若其指向某一工件,需完整获取并读取该工件。
  3. 若仍无合适来源,则当存在
    PLAN.md
    时,以其为依据;需完整读取该文件。
  4. 若以上均不满足,则停止操作并向用户请求来源。
即使存在
PLAN.md
,明确来源仍优先采用。需说明所选来源。请勿将多个可能的来源合并为新范围;当来源选择存在歧义,或矛盾内容会实质性改变预期结果时,需向用户确认。
CONTEXT.md
、适用的
AGENTS.md
、关联来源、相关ADRs、设计文档、代码及测试视为支撑上下文。当它们会影响工单准确性时需读取。
CONTEXT.md
是领域语言、边界及持久化决策的权威依据,但支撑上下文不得擅自扩展主要来源的范围。
当主要来源有稳定引用时,需保留溯源信息。若其为已确认团队和项目中的Linear议题,建议建立原生父级关系。否则需在每个新工单的可选
Source
部分添加该引用。除非用户明确批准,否则不得修改或关闭来源议题。
对于范围较广的工作,可使用子Agent进行有边界的独立只读探索,如单独模块调研、现有技术检索或重叠检查。在子Agent工作期间可继续其他独立分析,之后需在起草前协调所有结果。主Agent负责来源选择、完整提案、用户批准及所有Linear变更操作;不得通过子Agent同时创建或编辑Linear条目。
确认目标位置后、起草工单前,列出项目的所有里程碑,以及所有团队和项目均匹配已确认目标的议题(需支持分页,包含已完成或归档的议题)。仅搜索同团队其他项目的议题以发现可能的跨项目重叠;本次运行中不得复用这些议题。将项目内的里程碑范围、议题标题、描述、验收标准及状态与主要来源进行对比:
  • 复用与计划阶段匹配的现有里程碑。
  • 仅当现有议题的团队和项目均匹配已确认目标时,复用其覆盖计划工作的部分;不得重复创建。
  • 对存在部分重叠的拟议工作进行范围缩小或省略,并在评审时说明重叠情况。
  • 除非用户明确批准,否则不得修改、重命名或关闭现有议题。
发布前需再次检查是否存在新创建的重叠内容。

3. Draft milestones and tracer-bullet tickets

3. 起草里程碑与追踪工单

Each ticket must deliver a narrow, complete, independently verifiable outcome. Prefer vertical slices across necessary layers over layer-by-layer tasks. Size agent work for one fresh context window and human work as one focused action. Include human judgement, credentials, physical action, or approval as Human tickets; publish them normally without
Agent
.
Before slicing, look for prefactoring that makes the requested change easier. Create prefactoring tickets first only when they have concrete, independently verifiable outcomes needed by later slices; never invent unrelated cleanup.
Assign every ticket to exactly one native Linear project milestone. Reuse an existing milestone that matches the outcome; otherwise create one, including for a single-ticket change. Milestone names describe outcomes or phases and have no numeric prefix. Order milestones chronologically and topologically: every prerequisite milestone must appear earlier.
Within each milestone, name every issue:
text
III - Title
III
is zero-padded to three digits. Start each milestone at
000
, increment in topological display order (
001
,
002
), and reset to
000
for the next milestone. Avoid numbers already used in that milestone.
Topologically order all tickets without inventing dependencies. Every blocker must be earlier in the total milestone/task order:
  • A ticket may depend on a lower issue number in its milestone.
  • A ticket may depend on any ticket in an earlier milestone.
  • A ticket must never depend on a later issue in its milestone or any future milestone.
A lower issue number does not itself create a dependency; only a native
blockedBy
relationship does. Keep independent tickets unblocked. They form the execution frontier and may be assigned to separate agents concurrently.
If an existing milestone or issue conflicts with this order, surface it and ask before renaming, moving, or renumbering it. For wide mechanical refactors that cannot land green as vertical slices, use ordered expand–migrate–contract tickets.
每个工单必须交付范围明确、完整且可独立验证的成果。优先选择跨必要层级的垂直切片任务,而非按层级划分的任务。Agent处理的工作需适配单次上下文窗口,人工处理的工作需为单一聚焦动作。包含人工判断、凭证、物理操作或审批的任务需标记为Human工单;正常发布且无需标记
Agent
拆分任务前,寻找可简化所需变更的预重构操作。仅当预重构任务具备后续切片所需的具体、可独立验证成果时,才优先创建预重构工单;不得凭空创建无关的清理任务。
每个工单必须分配至唯一的Linear项目原生里程碑。复用与成果匹配的现有里程碑;否则创建新里程碑,即使是单一工单的变更也需如此。里程碑名称需描述成果或阶段,且无数字前缀。按时间顺序和拓扑顺序排列里程碑:所有前置里程碑必须排在前面。
在每个里程碑内,所有议题命名格式如下:
text
III - 标题
III
为三位零填充数字。每个里程碑从
000
开始,按拓扑显示顺序递增(
001
002
),下一个里程碑重置为
000
。避免使用该里程碑中已存在的编号。
按拓扑顺序排列所有工单,不得凭空创建依赖关系。所有阻塞项必须排在总里程碑/任务顺序的前面:
  • 工单可依赖同一里程碑中编号更小的议题。
  • 工单可依赖更早里程碑中的任意工单。
  • 工单不得依赖同一里程碑中编号更大的议题或任何未来里程碑中的工单。
编号更小本身不构成依赖关系;只有原生
blockedBy
关系才会形成依赖。保持独立工单无阻塞状态,它们构成执行前沿,可分配给不同Agent并行处理。
若现有里程碑或议题与该顺序冲突,需向用户说明并在重命名、移动或重新编号前请求确认。对于无法以垂直切片形式顺利完成的大规模机械重构,可使用有序的“扩展-迁移-收缩”工单。

4. Review with the user

4. 与用户评审

Present the selected primary source and the complete proposal in milestone order. For each milestone show existing/new status; for each ticket show title, existing/new status, blockers, delivered outcome, acceptance criteria, executor (
Agent
or
Human
), labels, and source provenance. Explicitly show omitted or narrowed overlaps and the initial frontier of independent agent tickets.
Ask the user to approve milestone names/order, ticket order, granularity, dependencies, overlap decisions, criteria, labels, provenance, and parallel frontier. Do not publish until explicitly approved.
按里程碑顺序展示所选主要来源及完整提案。针对每个里程碑显示其“现有/新增”状态;针对每个工单显示标题、“现有/新增”状态、阻塞项、交付成果、验收标准、执行者(
Agent
Human
)、标签及来源溯源信息。需明确展示被省略或缩小范围的重叠内容,以及初始的独立Agent工单前沿。
请求用户批准里程碑名称/顺序、工单顺序、粒度、依赖关系、重叠决策、验收标准、标签、溯源信息及并行前沿。获得明确批准前不得发布。

5. Prepare Linear metadata

5. 准备Linear元数据

Use the Linear MCP server to:
  1. Resolve the confirmed team's unambiguous
    Backlog
    state.
  2. List existing labels; reuse durable type/domain labels.
  3. Create missing durable labels only when useful.
  4. Ensure
    Agent
    exists if any ticket is agent-suitable.
Use two or three labels where useful. Agent tickets normally use
Agent
, one type, and optionally one domain label. Human tickets use type/domain labels but never
Agent
; do not invent
Human
unless asked. Avoid status, project, team, redundant, or one-off labels.
使用Linear MCP服务器执行以下操作:
  1. 确定已确认团队的明确
    Backlog
    状态。
  2. 列出现有标签;复用持久化的类型/领域标签。
  3. 仅当有用时才创建缺失的持久化标签。
  4. 若存在适合Agent处理的工单,确保
    Agent
    标签已存在。
按需使用2-3个标签。Agent工单通常使用
Agent
、一个类型标签,可选一个领域标签。人工工单使用类型/领域标签,但不得使用
Agent
;除非用户要求,否则不得创建
Human
标签。避免使用状态、项目、团队、冗余或一次性标签。

6. Publish and verify

6. 发布与验证

After the final overlap recheck, create missing milestones in approved chronological order, then create issues milestone-by-milestone and ascending by title number. Assign each newly created issue to its milestone and the confirmed
team
,
project
, resolved Backlog
state
, and approved
labels
. Preserve every reused issue's existing state, milestone, project, labels, and relations unless the reviewed proposal explicitly listed each intended mutation and the user approved it. Add approved native parent and
blockedBy
relationships using existing or already-created identifiers. Never use prose instead of available native relations.
Use Linear's native milestone/issue reordering capability when available. Otherwise creation order plus numeric titles is the source of truth; verify the returned order and clearly report any manual Linear reorder still required. Never invent milestone target dates merely to force ordering.
Do not assign, delegate, or add issues to a cycle unless asked. For newly created issues, verify milestone assignment, title, team, project, Backlog state, labels, and blockers. For reused issues, verify identity and approved mutations without normalizing unapproved metadata. Confirm new agent tickets have
Agent
, new human tickets do not, and every newly created or explicitly approved blocker is earlier. Correct in-scope mismatches before reporting identifiers and URLs.
End with plain text
Milestone order: <first> → <second> → <third>
followed by issue identifiers/URLs in that same milestone and ascending-number order. Then write
Parallel frontier: <issues>
listing unblocked
Agent
tickets that separate agents can implement concurrently, or
Parallel frontier: none
.
完成最终重叠检查后,按批准的时间顺序创建缺失的里程碑,然后按里程碑顺序、标题编号升序创建议题。将每个新创建的议题分配至其所属里程碑及已确认的
team
project
、已解析的Backlog
state
和已批准的
labels
。除非评审提案明确列出每项拟变更且获得用户批准,否则保留所有复用议题的现有状态、里程碑、项目、标签及关联关系。使用现有或已创建的ID添加已批准的原生父级和
blockedBy
关系。不得使用文本描述替代可用的原生关联关系。
若Linear提供原生里程碑/议题重排序功能,则使用该功能。否则创建顺序加标题编号为事实依据;需验证返回的顺序,并明确报告仍需手动在Linear中调整顺序的情况。不得仅为强制排序而凭空设置里程碑目标日期。
除非用户要求,否则不得将议题分配、委托或添加至周期。对于新创建的议题,验证其里程碑分配、标题、团队、项目、Backlog状态、标签及阻塞项。对于复用的议题,验证其身份及已批准的变更,不得标准化未批准的元数据。确认新Agent工单带有
Agent
标签,新人工工单无该标签,且所有新创建或明确批准的阻塞项均排在前面。报告ID和URL前需修正范围内的不匹配项。
最后以纯文本格式输出
Milestone order: <第一个> → <第二个> → <第三个>
,随后按相同里程碑顺序及编号升序列出议题ID/URL。接着输出
Parallel frontier: <议题列表>
,列出可由不同Agent并行实现的无阻塞
Agent
工单;若无则输出
Parallel frontier: none

Issue description

议题描述模板

md
undefined
md
undefined

What to build

构建内容

<End-to-end outcome from the user's perspective.>
<从用户视角出发的端到端成果。>

Acceptance criteria

验收标准

  • <Observable, verifiable outcome>
  • <可观察、可验证的成果>

Context

上下文

<Durable decisions and constraints only; omit if unnecessary.>
<仅包含持久化决策与约束;若无必要可省略。>

Source

来源

<Stable source reference; omit when represented by a native parent relation or no stable reference exists.>

Avoid brittle paths and snippets. Example: milestone `Quote flow` contains `000 - Create quote form`, then `001 - Validate requests`; milestone `Launch` starts again at `000 - Approve production wording`.
<稳定的来源引用;若通过原生父级关系体现或无稳定引用则可省略。>

避免脆弱路径和代码片段。示例:里程碑`Quote flow`包含`000 - 创建报价表单`,随后是`001 - 验证请求`;里程碑`Launch`从`000 - 批准生产文案`重新开始编号。