ln-100-documents-pipeline

用途

ln-100-documents-pipeline 是一个 L1 顶层编排技能，用于在一次调用中创建完整的项目文档体系。它把文档创建拆分为多个层级：顶层编排器（本技能）协调一个 L2 协调器加 3 个 L2 工作者；协调器 ln-110 再委派 5 个 L3 工作者负责项目文档，其他 L2 工作者负责参考、任务和测试域。

适用场景包括：启动新的 IT 项目并需要一次性建立完整文档体系；希望使用自动化工作流而非手动调用多个工作者；一次性创建完整文档结构（AGENTS.md 规范文件加 CLAUDE.md 导入桩，指向 docs/）；需要自动全局清理（去重、孤立文件、合并）。

主要能力

体系结构如下：

• ln-100-documents-pipeline（L1 顶层编排器，本技能）
  • ln-110-project-docs-coordinator（L2 协调器）
    • ln-111-root-docs-creator（L3）→ 5 个文档
    • ln-112-project-core-creator（L3）→ 3 个文档
    • ln-113-backend-docs-creator（L3）→ 2 个条件文档
    • ln-114-frontend-docs-creator（L3）→ 1 个条件文档
    • ln-115-devops-docs-creator（L3）→ 1 个始终生成 + 1 个条件文档
  • ln-120-reference-docs-creator（L2 工作者）
  • ln-130-tasks-docs-creator（L2 工作者）
  • ln-140-test-docs-creator（L2 工作者，可选）

流程包含阶段：PHASE_0_CONFIG、PHASE_1_LEGACY_SCAN、PHASE_2_CONFIRMATION、PHASE_3_DELEGATE、PHASE_4_QUALITY_GATE、PHASE_5_CLEANUP、PHASE_6_SELF_CHECK。运行时家族为 docs-pipeline-runtime，标识符为 docs-pipeline。

各组件会写入或返回 docs-generation 信封，ln-100 消费这些摘要和文档质量检查点作为编排的单一事实来源（SSOT）。

使用方式

工作流为 5 个阶段：旧文档迁移（可选）→ 用户确认 → 顺序调用协调器与工作者 → 全局清理 → 摘要。

Phase 0（可选）源文档清理：检测非规范文档位置，提取有用事实并归档，然后移除重复文档路径。检测模式包括根目录 .md 文件（ARCHITECTURE.md、REQUIREMENTS.md、STACK.md、API.md、DATABASE.md、DEPLOYMENT.md）、非规范文件夹（documentation/、doc/、wiki/ 或结构错误的 docs/）、README.md 与 CONTRIBUTING.md 中的特定章节。用户可选择 NORMALIZE（推荐，提取事实→归档→移除重复源）、ARCHIVE ONLY（仅备份）或 SKIP（保留非规范文档，可能造成重复）。备份写入 .archive/source-docs-{timestamp}/ 目录，包含 original/、extracted/ 以及 README_cleanup.md 回滚说明。

Phase 1 用户确认：检查已有文件、说明工作流并获取用户批准。会扫描根文档、参考结构、任务文档、项目文档和测试文档，显示已存在与缺失文件数量，并说明流水线只会创建缺失文件，不覆盖已有文件。同时询问是否包含测试文档。

Phase 2 顺序调用协调器与工作者：

• 调用 ln-110-project-docs-coordinator，创建根文档与项目文档，并保存其返回的 context_store（含 TECH_STACK 供 ln-120 使用）。
• 调用 ln-120-reference-docs-creator，传入 context_store，创建参考结构与智能文档（仅针对非平凡技术选择创建文档）。
• 调用 ln-130-tasks-docs-creator，创建任务管理文档 docs/tasks/README.md，若用户提供 Linear 配置则可选创建 kanban_board.md。
• 若用户批准，调用 ln-140-test-docs-creator，创建 tests/README.md。
• 可选调用 ln-160-docs-skill-extractor，从文档中提取技能到 .claude/commands/*.md。

调用方式为强制委派：Claude 使用 Skill 工具调用；Codex 若无 Skill 工具，则定位命名技能、读取其 SKILL.md、将参数视为 $ARGUMENTS 并执行其工作流后返回结果。不得内联工作者逻辑，也不得在未执行目标技能的情况下标记完成。

Phase 3 全局清理与合并：仅在所有工作者完成 Phase 2/3 验证后进行。先构建文档质量清单并使用共享验证器检查，检查项包括必需文档中的 SCOPE 标签、Maintenance 章节与标记、禁止的占位符与泄漏的模板元数据、损坏的内部链接、不允许的代码围栏、过期的内联日期、非官方技术栈文档链接。若存在 HIGH/CRITICAL 问题，进入有界修复循环：第一轮确定性内联修复，第二轮由对应负责工作者进行语义修复。

限制

资料未提供该技能的收费、价格、平台支持范围或效果保证等信息。该技能依赖多个子技能（ln-110 至 ln-160）协同工作，运行时需加载 references/coordinator_runtime_contract.md、references/docs_pipeline_runtime_contract.md、references/docs_generation_summary_contract.md 和 references/docs_quality_contract.md。预计耗时 15-20 分钟，包含交互式对话。是否支持除 Claude Code 与 Codex 之外的环境暂未提供。