Back to Details

ln-401-task-executor

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Implementation Task Executor

实现任务执行器

Executes a single implementation (or refactor) task from Todo to To Review using the task description and linked guides.
基于任务描述及关联指南，将单个实现（或重构）任务从“待办（Todo）”状态推进至“待审核（To Review）”状态。

Purpose & Scope

目标与范围

  • Handle one selected task only; never touch other tasks.
  • Follow task Technical Approach/plan/AC; apply KISS/YAGNI and guide patterns.
  • Update Linear/kanban for this task: Todo -> In Progress -> To Review.
  • Run typecheck/lint; update docs/tests/config per task instructions.
  • Not for test tasks (label "tests" goes to ln-404-test-executor).
  • 仅处理选中的单个任务；不得操作其他任务。
  • 遵循任务的技术方案/计划/验收标准（AC）；应用KISS/YAGNI原则及指南中的模式。
  • 更新该任务在Linear/看板中的状态：待办（Todo）→ 进行中（In Progress）→ 待审核（To Review）。
  • 运行类型检查/代码扫描（lint）；根据任务说明更新文档/测试/配置。
  • 不适用于测试类任务（带有“tests”标签的任务请交由ln-404-test-executor处理）。

Task Storage Mode

任务存储模式

AspectLinear ModeFile Mode
Load task
get_issue(task_id)
Read("docs/tasks/epics/.../tasks/T{NNN}-*.md")
Update status
update_issue(id, state)
Edit
the 
**Status:**
line in file
KanbanUpdated by Linear syncMust update 
kanban_board.md
manually
File Mode status format:
markdown
undefined
维度Linear模式文件模式
加载任务
get_issue(task_id)
Read("docs/tasks/epics/.../tasks/T{NNN}-*.md")
更新状态
update_issue(id, state)
编辑文件中的
**Status:**
行
看板由Linear同步更新需手动更新
kanban_board.md
文件模式状态格式：
markdown
undefined

Status

Status

Status: In Progress | Priority: High | Estimate: 4h
undefined
Status: In Progress | Priority: High | Estimate: 4h
undefined

Workflow (concise)

工作流（精简版）

  1. Load context: Fetch full task description (Linear: get_issue; File: Read task file); read linked guides/manuals/ADRs/research; auto-discover team/config if needed.
  2. Receive task: Get task ID from orchestrator (ln-400); load full task description.
  3. Start work: Update this task to In Progress (Linear: update_issue; File: Edit status line); move it in kanban (keep Epic/Story indent).
  4. Implement: Follow checkboxes/plan; keep it simple; avoid hardcoded values; reuse existing components; add Task ID comment (
    // See PROJ-123
    ) to new code blocks; update docs noted in Affected Components; update existing tests if impacted (no new tests here).
  5. Quality: Run typecheck and lint (or project equivalents); ensure instructions in Existing Code Impact are addressed.
  6. Finish: Mark task To Review (Linear: update_issue; File: Edit status line); update kanban to To Review; add summary comment (what changed, tests run, docs touched).
  1. 加载上下文： 获取完整任务描述（Linear：调用
    get_issue
    ；文件：读取任务文件）；阅读关联的指南/手册/架构决策记录（ADRs）/研究资料；必要时自动识别团队/配置信息。
  2. 接收任务： 从编排器（ln-400）获取任务ID；加载完整任务描述。
  3. 启动工作： 将任务状态更新为“进行中（In Progress）”（Linear：调用
    update_issue
    ；文件：编辑状态行）；在看板中移动任务位置（保留史诗/故事的缩进层级）。
  4. 执行实现： 遵循任务中的复选框/计划；保持实现简洁；避免硬编码值；复用现有组件；在新增代码块中添加任务ID注释（
    // See PROJ-123
    ）；更新“受影响组件”中提及的文档；若现有测试受影响则进行更新（此处不新增测试）。
  5. 质量检查： 运行类型检查和代码扫描（或项目等效的质量检查命令）；确保“现有代码影响”中的要求已被满足。
  6. 完成工作： 将任务标记为“待审核（To Review）”（Linear：调用
    update_issue
    ；文件：编辑状态行）；在看板中移动至“待审核”区域；添加总结注释（说明变更内容、运行的测试、修改的文档）。

Critical Rules

核心规则

  • Single-task updates only; no bulk status changes.
  • Keep language of the task (EN/RU) in edits/comments.
  • No code snippets in the description; code lives in repo, not in Linear.
  • No new test creation; only update existing tests if required.
  • Preserve Foundation-First ordering from orchestrator; do not reorder tasks.
  • Add Task ID comments to new code blocks for traceability (
    // See PROJ-123
    or 
    # See PROJ-123
    ).
  • Do NOT commit. Leave all changes uncommitted — ln-402 reviews and commits with task ID reference.
  • 仅更新单个任务；不得批量修改状态。
  • 编辑/注释时需保持任务原有的语言（英文/俄文）。
  • 描述中不得包含代码片段；代码需存储在代码仓库中，而非Linear中。
  • 不得创建新测试；仅在必要时更新现有测试。
  • 保留编排器指定的“基础优先”任务顺序；不得重新排序任务。
  • 为新增代码块添加任务ID注释以确保可追溯性（
    // See PROJ-123
    或 
    # See PROJ-123
    ）。
  • 请勿提交代码。所有变更需保持未提交状态——由ln-402进行审核并关联任务ID提交。

Definition of Done

完成定义

  • Task selected and set to In Progress; kanban updated accordingly.
  • Guides/manuals/ADRs/research read; approach aligned with task Technical Approach.
  • Implementation completed per plan/AC; docs and impacted tests updated.
  • Typecheck and lint passed (or project quality commands) with evidence in comment.
  • Task set to To Review; kanban moved to To Review; summary comment added.
  • 已选中任务并将其状态设置为“进行中”；看板已相应更新。
  • 已阅读指南/手册/架构决策记录（ADRs）/研究资料；实现方案与任务技术方案一致。
  • 已按计划/验收标准完成实现；已更新相关文档及受影响的测试。
  • 已通过类型检查和代码扫描（或项目质量检查命令），并在注释中提供证据。
  • 已将任务设置为“待审核”；已在看板中移动至“待审核”区域；已添加总结注释。

Reference Files

参考文件

  • Guides/manuals/ADRs/research: 
    docs/guides/
    , 
    docs/manuals/
    , 
    docs/adrs/
    , 
    docs/research/
  • Kanban format: 
    docs/tasks/kanban_board.md
Version: 3.0.0 Last Updated: 2025-12-23
  • 指南/手册/架构决策记录（ADRs）/研究资料：
    docs/guides/
    , 
    docs/manuals/
    , 
    docs/adrs/
    , 
    docs/research/
  • 看板格式：
    docs/tasks/kanban_board.md
版本： 3.0.0 最后更新日期： 2025-12-23