ln-400-story-executor
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseStory Execution Orchestrator
Story执行编排器
Executes a Story end-to-end by looping through its tasks in priority order and delegating quality gates to ln-500-story-quality-gate.
通过按优先级顺序循环处理Story的所有任务,并将质量管控门委派给ln-500-story-quality-gate,端到端执行Story。
Purpose & Scope
目标与范围
- Load Story + task metadata (no descriptions) and drive execution
- Process tasks in order: To Review → To Rework → Todo (foundation-first within each status)
- Delegate per task type to appropriate workers (see Worker Invocation table)
- Mandatory immediate review: Every execution/rework → ln-402 immediately. No batching
- 加载Story及任务元数据(不含描述信息)并驱动执行
- 按以下顺序处理任务:待审核→待返工→待办(同一状态下优先处理基础任务)
- 根据任务类型将工作委派给对应的处理单元(见处理单元调用表)
- 强制即时审核: 每次执行/返工后→立即调用ln-402。不允许批量操作
Task Storage Mode
任务存储模式
MANDATORY READ: Load for Linear vs File mode detection and operations.
shared/references/storage_mode_detection.md必读: 加载文档,了解Linear模式与File模式的检测及操作方式。
shared/references/storage_mode_detection.mdWhen to Use
使用场景
- Story is Todo or In Progress and has implementation/refactor/test tasks to finish
- Need automated orchestration through To Review and quality gates
- Story处于待办或进行中状态,且包含需要完成的实现/重构/测试任务
- 需要通过待审核环节和质量管控门实现自动化编排
Workflow
工作流程
Phase 1: Discovery & Branch Setup
阶段1:发现与分支设置
- Auto-discover Team ID/config from kanban_board.md + CLAUDE.md
- Get Story identifier (e.g., PROJ-42) and title
- Generate branch name: (lowercase, spaces→dashes, no special chars)
feature/{identifier}-{story-title-slug} - Check current branch:
git branch --show-current - If not matching:
- If branch exists:
git checkout feature/{identifier}-{slug} - If not:
git checkout -b feature/{identifier}-{slug}
- If branch exists:
- 从kanban_board.md + CLAUDE.md中自动识别团队ID/配置
- 获取Story标识符(例如:PROJ-42)和标题
- 生成分支名称:(小写,空格替换为连字符,无特殊字符)
feature/{identifier}-{story-title-slug} - 检查当前分支:
git branch --show-current - 如果分支不匹配:
- 若分支已存在:
git checkout feature/{identifier}-{slug} - 若分支不存在:
git checkout -b feature/{identifier}-{slug}
- 若分支已存在:
Phase 2: Load Metadata
阶段2:加载元数据
Fetch Story metadata and all child task metadata (ID/title/status/labels only):
- Linear Mode:
list_issues(parentId=Story.id) - File Mode: + parse
Glob("docs/tasks/epics/*/stories/{story-slug}/tasks/*.md")**Status:**
Summarize counts (e.g., "2 To Review, 1 To Rework, 3 Todo"). NO analysis — proceed immediately.
获取Story元数据及所有子任务元数据(仅包含ID/标题/状态/标签):
- Linear模式:
list_issues(parentId=Story.id) - File模式: + 解析
Glob("docs/tasks/epics/*/stories/{story-slug}/tasks/*.md")字段**Status:**
汇总任务数量(例如:“2个待审核,1个待返工,3个待办”)。禁止分析 —— 立即继续执行。
Phase 3: Context Review (before Todo tasks)
阶段3:上下文检查(待办任务前)
Before delegating a Todo task, verify its plan against current codebase:
- Load task description (get_issue or Read task file)
- Extract referenced files from task plan
- Check: Do files exist? Have related files changed? Are patterns still valid?
- Decision: No conflicts → proceed | Minor changes → update task, proceed | Major conflicts → ask user
Skip Context Review for: To Review tasks, To Rework tasks, test tasks when impl freshly Done, tasks created <24h ago.
在委派待办任务前,验证其计划与当前代码库是否匹配:
- 加载任务描述(通过get_issue或读取任务文件)
- 从任务计划中提取引用的文件
- 检查:文件是否存在?相关文件是否有变更?模式是否仍然有效?
- 决策:无冲突→继续执行 | 微小变更→更新任务后继续 | 重大冲突→询问用户
可跳过上下文检查的场景: 待审核任务、待返工任务、刚完成实现后的测试任务、创建时间不足24小时的任务。
Phase 4: Task Loop
阶段4:任务循环
For each task by priority (To Review > To Rework > Todo):
- Delegate to worker via Task tool (see Worker Invocation table)
- Reload metadata after subagent completes (task count may increase — ln-402 creates [BUG] tasks)
- If worker sets status != To Review → STOP and report
- After ln-401/ln-403/ln-404: Immediately invoke ln-402 on same task
Execute → Review → Next. Never skip review. Never batch reviews.
按优先级依次处理每个任务(待审核 > 待返工 > 待办):
- 通过Task工具将任务委派给处理单元(见处理单元调用表)
- 子Agent完成任务后重新加载元数据(任务数量可能增加——ln-402会创建[BUG]任务)
- 如果处理单元设置的状态≠待审核→停止并报告
- 调用ln-401/ln-403/ln-404后: 立即对同一任务调用ln-402
执行→审核→下一步。 绝不跳过审核,绝不批量审核。
Phase 5: Quality Gate
阶段5:质量管控门
When all implementation tasks Done:
- Invoke ln-500-story-quality-gate Pass 1 via Task tool
- If creates tasks → return to Phase 4
- When test task Done → invoke Pass 2
- If Pass 2 fails and creates tasks → return to Phase 4
- If Pass 2 passes → Story Done
当所有实现任务完成后:
- 通过Task工具调用ln-500-story-quality-gate的第一轮检查
- 如果创建了新任务→返回阶段4
- 当测试任务完成后→调用第二轮检查
- 如果第二轮检查失败并创建了新任务→返回阶段4
- 如果第二轮检查通过→Story完成
Worker Invocation
处理单元调用
CRITICAL: All delegations use Task tool with subagent_type: "general-purpose" for context isolation.
| Status | Worker | Notes |
|---|---|---|
| To Review | ln-402-task-reviewer | Pass task ID only. Add: "CRITICAL: Load ALL context independently via get_issue(). Fresh eyes review." Note: ln-402 runs parallel agent review (codex+gemini) which may escalate verdict. Re-check status after return. |
| To Rework | ln-403-task-rework | Then immediate ln-402 on same task |
| Todo (tests) | ln-404-test-executor | Then immediate ln-402 on same task |
| Todo (impl) | ln-401-task-executor | Then immediate ln-402 on same task |
| Quality Gate | ln-500-story-quality-gate | "Pass 1" or "Pass 2" in prompt |
Prompt template:
Task(description: "[Action] task {ID}",
prompt: "Execute {skill-name} for task {ID}. Read skill from {skill-name}/SKILL.md.",
subagent_type: "general-purpose")关键注意事项: 所有委派操作均使用Task工具,并设置subagent_type: "general-purpose"以实现上下文隔离。
| 状态 | 处理单元 | 说明 |
|---|---|---|
| 待审核 | ln-402-task-reviewer | 仅传递任务ID。添加:“关键:通过get_issue()独立加载所有上下文。以全新视角进行审核。” 注意:ln-402会运行并行Agent审核(codex+gemini),可能会升级审核结论。返回后重新检查状态。 |
| 待返工 | ln-403-task-rework | 之后立即对同一任务调用ln-402 |
| 待办(测试) | ln-404-test-executor | 之后立即对同一任务调用ln-402 |
| 待办(实现) | ln-401-task-executor | 之后立即对同一任务调用ln-402 |
| 质量管控门 | ln-500-story-quality-gate | 在提示中注明“第一轮检查”或“第二轮检查” |
提示模板:
Task(description: "[Action] task {ID}",
prompt: "Execute {skill-name} for task {ID}. Read skill from {skill-name}/SKILL.md.",
subagent_type: "general-purpose")Formats
格式要求
TodoWrite (mandatory)
TodoWrite(强制)
Before each task, add BOTH steps:
- — mark in_progress when starting
Execute [Task-ID]: [Title] - — mark in_progress after executor, completed after ln-402
Review [Task-ID]: [Title]
在处理每个任务前,添加以下两个步骤:
- —— 开始执行时标记为in_progress
Execute [Task-ID]: [Title] - —— 执行单元完成后标记为in_progress,ln-402完成后标记为completed
Review [Task-ID]: [Title]
Critical Rules
核心规则
- Branch isolation: All work in . Never commit to main/master
feature/{story-id}-{slug} - Metadata first: Never load task descriptions in Phase 2; workers load full text
- One task at a time: Pick → delegate → review → next. No bulk operations
- Only ln-402 sets Done: Stop and report if any worker leaves task Done or In Progress
- Source of truth: Trust Linear metadata (Linear Mode) or task files (File Mode)
- Story status: ln-400 handles Todo→In Progress→To Review; ln-500 handles To Review→Done
- Commit policy: Only ln-402 commits code. Workers (ln-401/ln-403/ln-404) leave changes uncommitted for ln-402 to review and commit with task ID reference.
- [BUG] tasks: ln-402 may create new [BUG] tasks mid-review. After metadata reload, reprioritize — new tasks processed in next loop iteration.
- 分支隔离: 所有工作均在分支中进行。绝不提交到main/master分支
feature/{story-id}-{slug} - 元数据优先: 阶段2绝不加载任务描述;处理单元会加载完整文本
- 一次处理一个任务: 选取→委派→审核→下一个。不允许批量操作
- 仅ln-402可设置完成状态: 如果任何处理单元将任务标记为完成或进行中,需停止并报告
- 事实来源: 信任Linear元数据(Linear模式)或任务文件(File模式)
- Story状态: ln-402负责处理待办→进行中→待审核的状态转换;ln-500负责处理待审核→完成的状态转换
- 提交策略: 仅ln-402可提交代码。处理单元(ln-401/ln-403/ln-404)需保留未提交的变更,由ln-402审核后携带任务ID引用提交
- [BUG]任务: ln-402可能在审核过程中创建新的[BUG]任务。重新加载元数据后,重新排序优先级——新任务将在下一次循环迭代中处理
Anti-Patterns
反模式
- ❌ Running /
mypy/ruffdirectly instead of skill invocationpytest - ❌ "Minimal quality check" then asking "Want me to run full skill?"
- ❌ Skipping/batching reviews
- ❌ Self-setting Done status without ln-402
- ❌ Any execution bypassing Task tool subagent
ZERO TOLERANCE: If running commands directly instead of invoking skills via Task tool, STOP and correct.
- ❌ 直接运行/
mypy/ruff而非调用对应的Skillpytest - ❌ 先进行“最小化质量检查”然后询问“是否需要我运行完整Skill?”
- ❌ 跳过/批量审核
- ❌ 未通过ln-402自行设置完成状态
- ❌ 绕过Task工具子Agent执行任何操作
零容忍: 如果直接运行命令而非通过Task工具调用Skill,请立即停止并纠正。
Plan Mode Support
计划模式支持
When invoked in Plan Mode (agent cannot execute), generate execution plan instead:
- Build task execution sequence by priority
- For each task show: ID, Title, Status, Worker, expected status after
- Include Quality Gate phases
- Write plan to plan file, call ExitPlanMode
Plan Output Format:
undefined当在计划模式下调用(Agent无法执行操作)时,生成执行计划而非执行任务:
- 按优先级构建任务执行序列
- 为每个任务显示:ID、标题、状态、处理单元、预期后的状态
- 包含质量管控门阶段
- 将计划写入计划文件,调用ExitPlanMode
计划输出格式:
undefinedExecution Plan for Story {STORY-ID}: {Title}
Execution Plan for Story {STORY-ID}: {Title}
| # | Task ID | Title | Status | Executor | Reviewer |
|---|---|---|---|---|---|
| 1 | {ID} | {Title} | {Status} | ln-40X | ln-402 |
| # | Task ID | Title | Status | Executor | Reviewer |
|---|---|---|---|---|---|
| 1 | {ID} | {Title} | {Status} | ln-40X | ln-402 |
Sequence
Sequence
- [Execute] {Task-1} via ln-401-task-executor
- [Review] {Task-1} via ln-402-task-reviewer ... N. [Quality Gate Pass 1/2] via ln-500-story-quality-gate
undefined- [Execute] {Task-1} via ln-401-task-executor
- [Review] {Task-1} via ln-402-task-reviewer ... N. [Quality Gate Pass 1/2] via ln-500-story-quality-gate
undefinedDefinition of Done
完成定义
- Working in correct feature branch (verified in Phase 1)
- Story and task metadata loaded; counts shown
- Context Review performed for Todo tasks (or skipped with justification)
- Loop executed: all tasks delegated with immediate review after each
- ln-500 Pass 1/Pass 2 invoked; result handled
- Story status transitions applied; kanban updated by workers
- Final report with task counts
- 在正确的功能分支中工作(已在阶段1验证)
- 已加载Story及任务元数据;已显示任务数量
- 对待办任务执行了上下文检查(或有合理理由跳过)
- 已执行循环:所有任务均已委派,且每个任务后立即进行审核
- 已调用ln-500的第一轮/第二轮检查;已处理检查结果
- 已应用Story状态转换;处理单元已更新看板
- 已生成包含任务数量的最终报告
Reference Files
参考文件
- Orchestrator lifecycle:
shared/references/orchestrator_pattern.md - Task delegation pattern:
shared/references/task_delegation_pattern.md - Auto-discovery patterns:
shared/references/auto_discovery_pattern.md - Plan mode behavior:
shared/references/plan_mode_pattern.md - Storage mode detection:
shared/references/storage_mode_detection.md - Quality orchestration:
../ln-500-story-quality-gate/SKILL.md - Executors: ,
../ln-401-task-executor/SKILL.md,../ln-403-task-rework/SKILL.md../ln-404-test-executor/SKILL.md - Reviewer:
../ln-402-task-reviewer/SKILL.md - Auto-discovery: ,
CLAUDE.mddocs/tasks/kanban_board.md
Version: 4.0.0 (Restructured: removed duplications, consolidated sections, ~35% reduction)
Last Updated: 2026-01-29
- 编排器生命周期:
shared/references/orchestrator_pattern.md - 任务委派模式:
shared/references/task_delegation_pattern.md - 自动发现模式:
shared/references/auto_discovery_pattern.md - 计划模式行为:
shared/references/plan_mode_pattern.md - 存储模式检测:
shared/references/storage_mode_detection.md - 质量编排:
../ln-500-story-quality-gate/SKILL.md - 执行单元:,
../ln-401-task-executor/SKILL.md,../ln-403-task-rework/SKILL.md../ln-404-test-executor/SKILL.md - 审核单元:
../ln-402-task-reviewer/SKILL.md - 自动发现:,
CLAUDE.mddocs/tasks/kanban_board.md
版本: 4.0.0(重构:移除重复内容,合并章节,内容缩减约35%)
最后更新: 2026-01-29