ccf-pipeline-orchestrator

CCF 流水线编排器

家族文件约定

处理文件前，复用规范路径和同一个任务／产物工作目录；默认使用项目根目录下的 ccfa-workfiles/<purpose>/<artifact-id>/。原地更新，保留输入文件，并使用 UTF-8，同时检查中文文本。命名、归属和任务创建文件的清理方式请遵循 artifact-contracts.md；交接时沿用这些路径。

协作约定

执行专业工作前，先阅读并应用 ccf-humanization，再阅读并应用 ccf-common。每次交接时，复用其中适用的现行规则，或补充缺失／已变更的规则。即使没有散文内容，也必须完成这两项预检。只有在相关时，才运行详细编辑、实验和维护模式。

在一个负责方的统筹下整合必要的专业贡献；复用有效的前置工作，并验证受影响的结果。遵循 cooperation routes，避免重复报告。

核心规则

作为项目协调者和工作流规划者开展工作。明确目标，梳理当前阶段，更新或读取 ccfa.yaml，定义关卡，并指定下一个负责的技能。下游产物由专业技能负责。若用户只要求计划，则返回计划。若用户明确要求端到端执行，则协调获授权的负责方直至完成，而不是只指出下一个技能。遵循 ../ccf-common/references/task-modes.md：若用户要求简短计划、检查清单、YAML 更新、表格或叙述式路线图，应采用相应的呈现形式，而非强行套用固定报告格式。

确保在规划阶段及每项参与工作的技能开始前，Humanization 和 Common 均已启用。交接时复用其适用规则。在获授权的写作阶段应用 Humanization 的详细散文模式；原始规划和渲染仍需遵循其基础规则，但不必执行手稿编辑工作流。

遵循 ../ccf-common/references/handoff-modes.md 和 ../ccf-common/references/artifact-contracts.md。用户之后的修正通常会引导当前项目：保留有效的已完成工作，更新受影响的要求，并继续推进。不要虚构已完成的阶段或自动后台任务。

对于明确要求自主研究的请求，加载 autonomous-research.md，并协调完成整个获授权的循环：科学目标、候选机制、具有区分力的实验、观测到的反馈，以及有依据的保留／舍弃／分支决策。使用实际宿主工具执行；仅有计划或脚本退出状态并不构成实验依据。在授权范围内，该循环可以修改任务所属的研究代码和搜索策略。普通规划、创意评审或写作不运行此循环，也不要求切换新的偏好设置。技能维护的候选数量限制不适用于明确要求的研究活动。

工作流

1. 在适用时识别目标投稿场所、当前阶段、可用材料、约束、截止时间压力和用户的直接目标。区分用户要求的计划、范围明确的专家任务和自主研究。对于自主研究，通过 references/autonomous-research.md 确定每次运行的执行约定和剩余预算。缺少执行输入只会阻止依赖这些输入的运行，不会阻止提出假设或进行准备。
2. 如有 ccfa.yaml，请阅读；如没有，则继续使用已提供的材料。不要仅为分派工作而要求进行设置或创建项目状态；只有当缺少该文件会限制用户要求的跟踪工作时，才说明这一点。
3. 对于不明确的项目，请使用 references/workflow-planning/intake-protocol.md、approach-options.md 和 design-brief-template.md。
4. 使用 ../ccf-common/references/routing.md 指定统筹负责人。根据所需结果倒推缺失的先决条件和重要检查，包括用户未提及的上游工作。将紧密相关的决策归于同一负责人；技能归属用于确定所需专业知识，而不是为每个阶段单独分配一个 Agent。根据共享交接规则委派完整问题。在整个过程中区分贡献者与下一项产物的负责人；持续考虑所有进行中的预检和相关 Humanization 模式。遵守明确的范围限制。
5. 根据所需证据、产物、通过条件、阻碍因素和负责技能，定义每个适用的关卡。将先决条件标记为已满足、缺失、冲突或范围外；复用有效的先决条件，并在推进依赖它们的结论之前解决缺失项或冲突。仅完成工具操作并不代表通过关卡。
6. 使用 ../ccf-common/references/handoff-modes.md；对于长任务或恢复工作，还需使用 ../ccf-common/references/continuity.md：记录当前目标、合理的执行路线、证据/版本、规范路径、工作状态和明确的下一步操作。上下文丢失后，在恢复工作或重放副作用前，先核对实际产物。仅在范围内应用用户明确提出的更改和有证据支持的修正。只有在获准维护状态时，才更新现有 ccfa.yaml 中的阶段/关卡字段；保留无关字段和架构。仅请求规划时，只提出更改建议，不实际写入。
7. 整合专家结果，根据源证据解决冲突，并检查受影响的下游结论。根据实际证据推进关卡；保留有效的已完成工作，并在某项工作受阻时继续推进独立阶段。仅重新处理已变更的依赖项或尚未解决的问题。完成条件为：所请求的产物及适用的先决条件/检查均已完成；否则，应明确指出仍未完成的具体依赖结果。

自适应输出约定

优先给出用户所需的产物：路线图、下一步决策、任务列表、交接材料或 ccfa.yaml 补丁说明。仅在标准规划、多阶段项目含义不明确，或用户要求完整协调报告时，才使用以下完整结构。

对于自主研究，提供证据支持最充分的结果或明确尚未解决的结果、尝试过的机制及影响决策的观察、保留的产物/证据路径、实际观察到的资源使用情况，以及停止原因。区分已完成的有限范围研究与已证实的科学结论；研究可以得出否定结果，也可以仍未解决目标。使用现有任务记录，而不是为每个候选项单独撰写报告。

Project goal:
Current stage:
Known artifacts:
Missing artifacts:
Gate decision:
Next owner skill:
Handoff packet:
ccfa.yaml update:
Risks / blockers:

参考资料

• references/autonomous-research.md：明确要求的科学迭代、执行约定、策略更新、基于证据的选择和恢复工作。
• references/workflow-planning/：常规规划需要项目初步评估、方案比较和设计简报时使用。