mcpField
L
ln-301-task-creator

ln-301-task-creator

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

关于 ln-301-task-creator

该技能根据已批准的计划生成任务文档,并通过配置的任务跟踪提供方创建任务、更新看板和输出结构化摘要。适用于独立运行或由协调流程调用的任务创建。

主要功能

  1. 01按计划生成任务文档
  2. 02支持 ADD 和 CREATE 模式
  3. 03验证任务内容与规则
  4. 04创建任务并更新看板
  5. 05写入结构化运行摘要

适用场景

  1. 01将已批准计划转为跟踪任务
  2. 02仅创建协调方指定的任务增量
  3. 03为任务补充技术方案与验收标准
  4. 04汇总任务创建和看板更新结果

安装

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

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

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

包含的文件

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

references/
agent_skill_roots_contract.md
coordinator_summary_contract.md
creation_quality_checklist.md
destructive_operation_safety.md
environment_state_contract.md
storage_mode_detection.md
task_plan_worker_runtime_contract.md
template_loading_pattern.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/task-plan-worker-runtime/
cli.mjs
references/scripts/task-plan-worker-runtime/lib/
guards.mjs
phases.mjs
store.mjs

详细介绍

路径: 文件路径(references/、../ln-*)均相对于此技能目录。

任务创建器

类型: L3 Worker 类别: 3XX 规划

以独立运行为先的任务创建 Worker。它根据已批准的计划创建任务,并返回稳定的摘要契约。

必须阅读: 加载 references/coordinator_summary_contract.md 和 references/task_plan_worker_runtime_contract.md 必须阅读: 加载 references/environment_state_contract.md、references/storage_mode_detection.md、references/template_loading_pattern.md、references/creation_quality_checklist.md 和 references/destructive_operation_safety.md

输入

核心输入:

  • taskType
  • storyData
  • idealPlan — 包含范围、AC 映射、依赖关系和层级分类的任务列表
  • teamId
  • guideLinks

Coordinator 上下文(在 ADD/CREATE 模式下传入):

  • traceabilityTablePath — Coordinator 第 2 阶段生成的可追溯性表
  • discoveryContext — Coordinator 第 1 阶段提供的架构、技术栈、关键文件和集成点
  • tasksToCreate — 要创建的具体任务(ADD 模式)。Worker 编写 7 个部分的文档,不负责判断是否需要这些任务。

传输输入:

  • 独立运行:省略 runId 和 summaryArtifactPath
  • 托管运行:同时传入 runId 和 summaryArtifactPath

运行时

运行时系列:task-plan-worker-runtime

阶段配置:

  1. PHASE_0_CONFIG
  2. PHASE_1_LOAD_INPUTS
  3. PHASE_2_LOAD_CONTEXT
  4. PHASE_3_GENERATE_TASK_DOCS
  5. PHASE_4_VALIDATE_TASKS
  6. PHASE_5_CONFIRM_OR_AUTOAPPROVE
  7. PHASE_6_APPLY_CREATE
  8. PHASE_7_UPDATE_KANBAN
  9. PHASE_8_WRITE_SUMMARY
  10. PHASE_9_SELF_CHECK

摘要产物规则:

  • 输出 summary_kind=task-plan
  • 独立运行时生成自己的 run_id,并写入 Worker 系列的默认产物路径
  • 托管运行必须同时提供 runId 和 summaryArtifactPath,并将摘要写入指定的确切路径
  • 始终在终止结果前写入经过验证的摘要产物

输出契约

始终按照以下文件构建结构化的 task-plan 摘要封装:

  • references/coordinator_summary_contract.md
  • references/task_plan_worker_runtime_contract.md

负载字段:

  • mode
  • story_id
  • task_type
  • tasks_created
  • tasks_updated
  • tasks_canceled
  • task_urls
  • kanban_updated
  • dry_warnings_count
  • warnings

始终在终止结果前写入经过验证的摘要。

工作流

  1. 确定任务提供方和模板集。
  2. 在适用时执行 DRY 和破坏性操作检查。
  3. 使用 Coordinator 上下文(discoveryContext、traceabilityTablePath)了解架构。研究代码库以掌握实现细节(现有模式、相关文件、集成点),从而编写优质的 Technical Approach 部分。
  4. 选择范围:
    • ADD:仅使用 tasksToCreate
    • CREATE:扩展完整的 idealPlan
  5. 根据选定范围生成任务文档。
  6. 验证特定类型的规则。
  7. 显示预览,并在需要时获取确认。
  8. 通过已配置的跟踪工具提供方创建任务。
  9. 更新看板。
  10. 返回结构化摘要。

关键规则

  • 保持独立运行能力。
  • 不得依赖 Coordinator 运行时状态。
  • 根据 taskType 分别处理实现、重构和测试规则。
  • 每次都写入机器可读的摘要输出。
  • 理想计划具有约束力。 创建已批准计划中的每个任务。不得重新评估是否应该存在这些任务。
  • ADD 的快速路径: tasksToCreate 即执行范围。如果 Coordinator 已选定增量,则不要重新扩展完整的理想计划。
  • 在跟踪工具的 createTask 之前停止: 确认正文中包含全部 7 个部分:Context、Implementation Plan、Technical Approach、Acceptance Criteria、Affected Components、Existing Code Impact、Definition of Done。若缺少这些部分,PreToolUse hook 将阻止创建。

完成定义

  • 已加载模板
  • 已生成任务文档
  • 已通过类型专属验证
  • 已在特定于提供方的存储中创建任务
  • 已更新 kanban
  • 已返回结构化摘要
  • 已将摘要产物写入托管或独立运行时路径

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

评论

支持 Markdown