mcpField
L
ln-403-task-rework

ln-403-task-rework

github.com/levnikolaevich开发584371 次安装2 天前更新
代码仓库

关于 ln-403-task-rework

用于处理单个待返工任务的技能，会根据审查反馈修改内容并将任务交回审查。它使用已配置的跟踪器提供方，只修改指定任务，并保留未提交的变更。

主要功能

  1. 01读取任务、评论和父级 Story
  2. 02将审查反馈映射为针对性修复
  3. 03运行项目质量检查
  4. 04更新任务状态和看板
  5. 05添加交接摘要及根因分类

适用场景

  1. 01修复标记为 To Rework 的任务
  2. 02在不扩大范围的前提下处理审查意见
  3. 03将修复完成的任务交回审查

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-403-task-rework

安装后在 Claude Code 中输入/ln-403-task-rework确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
agent_skill_roots_contract.md
audit_scoring.md
audit_summary_contract.md
audit_worker_core_contract.md
code_efficiency_criterion.md
coordinator_summary_contract.md
environment_state_contract.md
goal_articulation_gate.md
input_resolution_pattern.md
mcp_tool_preferences.md
problem_solving.md
provider_file.md
provider_github.md
provider_linear.md
references/scripts/coordinator-runtime/lib/
artifacts.mjs
cli-helpers.mjs
core.mjs
loop-health.mjs
runtime-constants.mjs
schemas.mjs
validate.mjs
worker-guards.mjs
worker-runtime.mjs
references/scripts/planning-worker-runtime/
cli.mjs
references/scripts/planning-worker-runtime/lib/
guards.mjs
phases.mjs
store.mjs
references/scripts/task-plan-worker-runtime/
cli.mjs
references/scripts/task-plan-worker-runtime/lib/
guards.mjs
phases.mjs

详细介绍

**路径：**文件路径（references/、../ln-*）均相对于此技能目录。

任务返工执行器

**类型：**L3 Worker

对单个标记为 To Rework 的任务执行返工，并交回审核。

目的与范围

  • 加载完整任务、审核者评论和父级 Story；理解所需更改。
  • 根据反馈修复，遵循 KISS/YAGNI，并与指南/技术方案保持一致。
  • 仅更新此任务：To Rework → In Progress → To Review；不触及其他任务。

**Hex-line 加速（如可用）：**读取大型代码文件前，使用 outline(file_path)。使用 read_file() 进行发现；任何需要 revision 和校验和的编辑前，使用 read_file(edit_ready=true, verbosity="full")。编辑后：edit_file(base_revision=rev) → verify(checksums)。使用 changes() 展示已修复的内容。

输入

返工期间，对代码/配置/脚本/测试文件，主要使用 read_file() 和 edit_file()。默认让 read_file() 先进行发现；只有即将复用其 revision/校验和协议时，才请求 edit_ready=true, verbosity="full"。仅当 hex-line 不可用时，才将内置 Read/Edit 作为后备方案。

输入必需来源描述
taskId是args、父级 Story、kanban、用户要返工的任务

**解析：**Task Resolution Chain。 **状态筛选：**To Rework

任务存储模式

**必须读取：**加载 references/environment_state_contract.md、references/storage_mode_detection.md、references/tracker_provider_contract.md 和 references/input_resolution_pattern.md

提取：task_provider = Task Management → Provider（linear | github | file）。此技能中的操作与提供方无关——规范操作集请参阅 references/tracker_provider_contract.md，传输绑定请参阅 provider_*.md。

此技能使用的跟踪器操作：getTask、getStory、listComments、updateStatus（To Rework → In Progress → To Review）、addComment。各提供方的传输方式位于 references/provider_file.md, references/provider_github.md, references/provider_linear.md。

**必须读取：**加载 references/mcp_tool_preferences.md——只要 hex-line MCP 可用，代码文件就始终使用它。除非 hex-line 不可用，否则不得回退到标准 Read/Edit。

工作流（简要）

  1. **解析 taskId：**根据指南运行 Task Resolution Chain（状态筛选：[To Rework]）。
  2. **加载任务：**通过已配置的跟踪器提供方（getTask、listComments）读取任务和审核备注；通过 getStory 获取父级 Story。 2b) **目标关卡：****必须读取：**加载 references/goal_articulation_gate.md——陈述此次返工的真实目标（实际出了什么问题，而不是“应用反馈”）。结合 5 Whys（references/problem_solving.md），确保在阐明返工目标的同时也说明根本原因。目标不是：只修补表象、未解决根本原因。
  3. **规划修复：**将每条评论对应到一项操作；确认没有增加新范围。
  4. **实施：****必须读取：**加载 references/code_efficiency_criterion.md——遵循任务计划/复选框；处理配置/硬编码问题；更新「受影响组件」和「现有代码影响」中提及的文档/测试。交接前，完成 3 项效率自检。
  5. **质量：**运行类型检查/lint（或项目对应检查）；确保修复符合指南/手册/ADR/研究结论。
  6. **根本原因分析：**询问“为什么 Agent 会产出错误代码？”分类为：上下文缺失 | 模式错误 | AC 不明确 | 文档/模板缺漏。如果发现文档/模板缺漏 → 更新相关文件（指南、模板、CLAUDE.md），以防问题重现。
  7. **交接：**通过已配置的跟踪器提供方（updateStatus）将任务设为 To Review；在 kanban 中移动任务；添加总结评论，引用已解决的反馈和根本原因分类。

关键规则

  • 仅处理单个任务；绝不批量更新。
  • 不要标记为 Done；只能标记为 To Review（由审查者决定是否标记为 Done）。
  • 任务使用哪种语言（EN/RU），就保持语言一致。
  • 不要在此处创建新测试或任务；仅在现有测试受影响时更新它们。
  • 不要提交。 保持所有更改未提交——由审查者审查并提交。

运行时摘要产物

必须阅读： 加载 references/coordinator_summary_contract.md、references/worker_runtime_contract.md、references/task_worker_runtime_contract.md

共享约定：

  • 输出 summary_kind=task-status
  • 独立模式省略 runId 和 summaryArtifactPath
  • 托管模式在工作者写入经过验证的摘要之前，同时传入 runId 和准确的 summaryArtifactPath

监控（2.1.98+）： 当预计验证命令耗时超过 30 秒时，使用 Monitor。回退方案：Bash(run_in_background=true)。

完成定义

  • 已完整阅读任务和审查反馈；已明确对应操作。
  • 已应用修复；按需更新文档/测试。
  • 质量检查已通过（类型检查/代码检查或项目标准）。
  • 已归类根本原因（缺少上下文 | 错误模式 | 验收标准不明确 | 文档缺漏）；如发现缺漏，已更新文档/模板。
  • 状态已设为 To Review；已更新看板；已添加包含修复项和根本原因的摘要评论。
  • 已将运行时摘要产物写入共享的任务状态位置。

参考文件

  • 环境状态： references/environment_state_contract.md
  • 存储模式操作： references/storage_mode_detection.md
  • [必须] 问题解决方法： references/problem_solving.md
  • 看板格式：docs/tasks/kanban_board.md

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

评论

支持 Markdown