用途
本技能（ln-130-tasks-docs-creator）用于创建和校验任务管理文档，输出位于 docs/tasks/ 目录下：
- docs/tasks/README.md：任务管理系统规则文档
- docs/tasks/kanban_board.md：看板与跟踪器集成文档，包含 Epic Story 计数器
它既可作为 ln-100-documents-pipeline 编排器调用的 L2 Worker，也可独立使用。所属工作流为：ln-100-documents-pipeline → ln-110-project-docs-coordinator → ln-120-reference-docs-creator → ln-130-tasks-docs-creator → ln-140-test-docs-creator（可选）。
主要能力
技能遵循三阶段工作流：CREATE → VALIDATE STRUCTURE → VALIDATE CONTENT。
阶段一：创建 tasks/README.md
- 使用 Glob 检查 docs/tasks/README.md 是否已存在；存在则跳过并保留，不存在则创建 docs/tasks/ 目录并从模板生成 README.md。
- 模板包含：共享头部契约（SCOPE、DOC_KIND、DOC_ROLE、READ_WHEN、SKIP_WHEN、PRIMARY_SOURCES）、Story-Level Test Task Pattern、Kanban Board Structure（Epic Grouping Pattern）、Linear Integration（MCP 方法）、Quick Navigation、Agent Entry 和 Maintenance 章节。
- 将 {{DATE}} 替换为当前日期（YYYY-MM-DD）。
阶段二：结构校验（自动修复）
对 docs/tasks/README.md 和 docs/tasks/kanban_board.md（若存在）执行：
- 校验 SCOPE 标签：README.md 期望
<!-- SCOPE: Task tracking system workflow and rules ONLY -->，kanban_board.md 期望<!-- SCOPE: Quick navigation to active tasks in Linear -->，缺失则自动添加。 - 校验必需章节：README.md 需要 "Linear Integration" 或 "Core Concepts"、"Task Workflow" 或 "Critical Rules"、"Task Templates"；kanban_board.md 需要 "Linear Configuration"、"Work in Progress" 或 "Epic Tracking"。缺失则自动补充。
- 校验 Maintenance 章节：检查文件最后 20 行，缺失则追加 Maintenance 章节（含 Update Triggers 与 Last Updated）。
- 校验 POSIX 换行：确保文件以单个换行符结尾。
- 输出结构校验摘要，统计自动修复数量。
阶段三：内容校验
- 加载 references/questions.md 获取校验启发式规则。
- 对 kanban_board.md 的 Linear Configuration 做特殊处理：检测 [TEAM_NAME]、[TEAM_UUID]、[TEAM_KEY] 占位符。若存在占位符则进入交互式设置模式，提示用户输入 Team Name（非空字符串）、Team UUID（格式 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx，正则 /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/）、Team Key（2-4 个大写字母，正则 /^[A-Z]{2,4}$/），并替换占位符、初始化计数器（Next Epic Number 与 Next Story Number 设为 1）、更新 Last Updated 日期。若无占位符则进入校验模式，校验已有 UUID 与 Team Key 格式，格式错误时标记为无效但不阻断流程。
- 对 tasks/README.md 的三个问题做参数化循环校验：Linear 如何集成、任务状态转换与评审标准、可用任务模板及用法。任一启发式通过即视为有效，否则记录警告。
- 对 kanban_board.md 的 Epic Tracking 做校验：检查是否有 Epic 章节、Epic/Name/Status/Progress 表格或 "No active epics" 占位符。
- 输出内容校验摘要。
使用方式
- 作为 L2 Worker 由 ln-100-documents-pipeline 编排器调用，或独立运行。
- 强制读取 references/docs_quality_contract.md 与 references/markdown_read_protocol.md；仅在需要精确规则 ID、路径矩阵或允许的占位符例外时加载 references/docs_quality_rules.json。
- 阶段二需读取 references/questions.md 获取校验规格。
- 阶段一需读取 references/templates/tasks_readme_template.md。
- 支持可选的 summaryArtifactPath，输出 docs-generation 类型的运行时摘要，包含 worker="ln-130"、status、created_files、skipped_files、quality_inputs、validation_status、warnings。
- 返回规范化摘要（created_files、skipped_files、quality_inputs、validation_status），供 ln-100 运行集中式文档质量门禁。
适用场景
- 为项目创建任务管理文档（docs/tasks/）。
- 设置跟踪器集成与看板。
- 校验已有任务文档的结构与内容。
- 配置提供方特定的跟踪器设置：linear（Team Name/UUID/Key）、github（repository/project_number）、file（无需配置）。
限制与规则
- 幂等：创建前检查文件是否存在，保留已有文件，可安全重复运行。
- 原始占位符仅允许在设置阶段出现于 docs/tasks/README.md 和 docs/tasks/kanban_board.md；发布输出不得将未解析标记泄漏到其他文档。
- README.md 与 kanban_board.md 都必须包含 SCOPE、元数据标记、Quick Navigation、Agent Entry 和 Maintenance。
- Story-Level Test Task Pattern：测试集中在最终 Story 任务中，不分散到各实现任务。
- 看板由 ln-301-task-creator、ln-302-task-replanner、ln-400-story-executor（Epic Grouping 逻辑）更新。
- 版本 7.1.0，最后更新 2025-01-12。
参考文件
- references/templates/tasks_readme_template.md
- references/templates/kanban_board_template.md
- references/questions.md
- references/docs_quality_contract.md
- references/docs_quality_rules.json
- references/docs_generation_summary_contract.md