DevDocs 工作流编排器
【定位与用途】 它是 DevDocs 工作流的顶层编排器，提供 5 个流程入口，降低用户面对 13 个原子 skill 的认知负担。用户只需说「我要做什么」，pipeline 负责「用哪些 skill、按什么顺序」。其链路为：用户 → /devdocs-pipeline → 自动路由到合适的 skill 组合，取代手动选择 13 个原子 skill。
【运行模式】 /devdocs-pipeline → 提问式调度（自动判断） /devdocs-pipeline init → 新项目全流程 /devdocs-pipeline feature → 新功能开发 /devdocs-pipeline bugfix → Bug 修复 /devdocs-pipeline verify → 质量检查 /devdocs-pipeline close → 周期收尾
【提问式调度】 无参数调用时，通过阶段感知 + 智能引导收敛到合适的入口。
阶段检测：先扫描 docs/devdocs/ 已有文件判断当前阶段：无文件则进入新项目判断；有文件则分析阶段，并给出建议（如仅 01-requirements.md 时建议 /devdocs-system-design；有 01 + 02 时建议 /devdocs-test-cases；有 01~03 时建议 /devdocs-dev-tasks；有 01~04 + readiness-report 时建议 /devdocs-dev-workflow；有 01~04 无 readiness-report 时建议 /devdocs-verify --readiness；有代码提交且任务进行中时建议继续 /devdocs-dev-workflow；有 verify-report 时建议 /devdocs-sync 或 /devdocs-compound）。
轻量分轨提示：按变更规模给出路径建议——小改动（bugfix、单文件修复、配置变更）建议 /devdocs-pipeline bugfix；标准功能（新功能、需求变更、多文件改动）建议 /devdocs-pipeline feature；大功能（跨模块、新架构、全新项目）建议 /devdocs-pipeline init 完整路径。
兜底问答：阶段检测无法判断时，用 2-3 个问题收敛。Q1 问项目是否已有 DevDocs 文档；没有则 Q1a 问已有代码还是全新项目（全新项目 → init；已有代码 → /devdocs-retrofit，非 pipeline 管辖）；有则 Q2 问要做什么（新功能 → feature；修 Bug → bugfix；检查质量 → verify；收尾/沉淀 → close）。Q3（feature/bugfix 追加，可选）问改动是否涉及 UI（是则 verify 阶段包含 --ui 维度，否则仅 --docs/--impl）。
【入口详解】 init — 新项目全流程：devdocs-requirements → devdocs-system-design → devdocs-test-cases → devdocs-dev-tasks → devdocs-verify --readiness（就绪关卡，P1 阻塞则修复后重试）→ devdocs-dev-workflow（批量模式）→ devdocs-verify（全量验证）→ devdocs-sync（全量补充同步，幂等）。就绪关卡检查项包括 AC↔测试用例对齐、任务文件路径具体性、依赖无环、设计↔任务一致性。dev-workflow 批量模式内部已执行逐任务 sync 和 compound，pipeline 此处的 verify → sync 为全量验证+补充同步，不再额外执行 compound。pipeline 启动时优先检查 docs/devdocs/00-context.md，如存在且未过期（< 24h）则读取作为快速上下文。
feature — 新功能开发：/devdocs-feature（含 requirements/design/tests/tasks + readiness 关卡 + 自动衔接 dev-workflow）→ devdocs-verify（全量验证）→ devdocs-sync（全量补充同步，幂等）。feature 已内置 Step 4.5 readiness 关卡和 Step 6 自动衔接 dev-workflow，pipeline 只需在其完成后补充 verify 和 sync。
bugfix — Bug 修复：先评估复杂度。简单 Bug → /devdocs-bugfix（直接修复）→ /devdocs-verify --impl → /devdocs-sync；复杂 Bug → /devdocs-dev-tasks（拆分任务）→ /devdocs-dev-workflow → /devdocs-verify --impl → /devdocs-sync。
verify — 质量检查：自动判断维度——有代码变更 → verify --impl；有文档变更 → verify --docs；有 UI 设计稿 → verify --ui；不确定则询问用户。随后生成修复建议并路由到对应 skill 执行修复。
close — 周期收尾：/devdocs-sync（trace + audit）→ /devdocs-compound（知识沉淀）→ /devdocs-onboard --update（更新上下文摘要）。
【阶段间衔接】 pipeline 在每个阶段完成后进行：状态检查（确认阶段产出文件存在）、简要摘要（向用户展示本阶段结果概要）、衔接提示（询问用户是否继续下一阶段，默认是）。
【编排规范（子 Agent 调度）】 pipeline 调用其他技能时必须通过 Task tool 启动子 Agent。阶段间只传递 YAML 摘要 + 文件路径，编排 Agent 不读取子技能的完整输出文档。子 Agent 返回 status: failed + blockers 时，展示阻塞项给用户并询问处理方式（修复/跳过/终止），不自行读取文档排障。每个子 Agent 自行读取所需前置文档（从 docs/devdocs/ 文件系统），不依赖编排 Agent 传递全文。
【约束】 阶段边界约束：DevDocs 工作流严格区分文档阶段和编码阶段。需求、设计、测试设计、任务拆分、项目改造阶段产出文档，不允许编码；开发执行与 Bug 修复阶段产出代码。文档阶段技能严禁产出实现代码，仅写入 docs/devdocs/ 下的 Markdown 文档；编排器不得在文档阶段启动编码操作。
编排约束：pipeline 仅负责路由和衔接，不复制任何原子 skill 逻辑；每个阶段必须委托给对应原子 skill 执行；阶段间传递信息仅限新增编号列表、状态摘要、文件路径；用户可在任意阶段退出 pipeline。
提问式调度约束：优先阶段检测自动判断，无法判断时才提问；兜底问答最多 3 个问题收敛到入口；问题必须有明确选项；识别到 retrofit 场景时路由到 /devdocs-retrofit 并退出 pipeline；分轨提示基于变更规模，不引入额外术语。
上下文约束：优先读取 00-context.md 作为快速上下文（如存在且 < 24h）；pipeline 编排层不读取大量源代码（委托给子 skill）；每个阶段完成后展示简要摘要（< 10 行）。
编排约束（子 Agent）：调用其他技能时必须通过 Task tool 启动子 Agent；阶段间只传递 YAML 摘要 + 文件路径；子 Agent 失败时展示阻塞项询问用户，不自行排障；每个子 Agent 自行读取前置文档，编排层不传递全文。
【Skill 协作链】 init：requirements → system-design → test-cases → dev-tasks → verify --readiness → dev-workflow → verify → sync feature：feature(含 readiness + dev-workflow) → verify → sync bugfix：bugfix / (dev-tasks → dev-workflow) → verify → sync verify：verify --docs/--impl/--ui close：sync → compound → onboard --update
【子 Agent 摘要格式】 当本 Skill 作为子 Agent 运行时，返回结构化摘要，字段包括：skill（devdocs-pipeline）、entry（init | feature | bugfix | verify | close）、stages_completed（如 { skill: devdocs-requirements, status: success }）、stages_remaining（如 devdocs-test-cases）、summary（含 new_ids、status、interrupt_reason）、output_files（如 docs/devdocs/01-requirements.md）。
【下一步】 pipeline 完成后所有产出文档均已生成/更新。用户可继续下一轮 feature/bugfix；运行 /devdocs-onboard --read 传递上下文给新 AI；或直接进入编码（已有 dev-tasks 和 dev-workflow 的产出）。
【语言规则】 支持中英文提问，统一中文回复。
【限制】 资料未提供该工具的价格、收费模式、平台支持情况（如支持的 AI 客户端或运行环境）与安装命令，暂未提供。