ln-401-task-executor

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Executes a single implementation (or refactor) task from Todo to To Review using the task description and linked guides.

基于任务描述及关联指南，将单个实现（或重构）任务从“待办（Todo）”状态推进至“待审核（To Review）”状态。

Aspect	Linear Mode	File 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
Kanban	Updated by Linear sync	Must 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: In Progress | Priority: High | Estimate: 4h

undefined

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

undefined

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.
Receive task: Get task ID from orchestrator (ln-400); load full task description.
Start work: Update this task to In Progress (Linear: update_issue; File: Edit status line); move it in kanban (keep Epic/Story indent).
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).
Quality: Run typecheck and lint (or project equivalents); ensure instructions in Existing Code Impact are addressed.
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).

加载上下文： 获取完整任务描述（Linear：调用
```
get_issue
```
；文件：读取任务文件）；阅读关联的指南/手册/架构决策记录（ADRs）/研究资料；必要时自动识别团队/配置信息。
接收任务： 从编排器（ln-400）获取任务ID；加载完整任务描述。
启动工作： 将任务状态更新为“进行中（In Progress）”（Linear：调用
```
update_issue
```
；文件：编辑状态行）；在看板中移动任务位置（保留史诗/故事的缩进层级）。
执行实现： 遵循任务中的复选框/计划；保持实现简洁；避免硬编码值；复用现有组件；在新增代码块中添加任务ID注释（
```
// See PROJ-123
```
）；更新“受影响组件”中提及的文档；若现有测试受影响则进行更新（此处不新增测试）。
质量检查： 运行类型检查和代码扫描（或项目等效的质量检查命令）；确保“现有代码影响”中的要求已被满足。
完成工作： 将任务标记为“待审核（To Review）”（Linear：调用
```
update_issue
```
；文件：编辑状态行）；在看板中移动至“待审核”区域；添加总结注释（说明变更内容、运行的测试、修改的文档）。

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.

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.

Guides/manuals/ADRs/research:

docs/guides/

docs/manuals/

docs/adrs/

docs/research/

Version: 3.0.0 Last Updated: 2025-12-23

版本： 3.0.0 最后更新日期： 2025-12-23