requirement-parallel-orchestration

name	requirement-parallel-orchestration
description	多需求并行编排 Skill — 当任务涉及多个需求/问题/优化并行推进、子会话、子 Agent、worktree 或多 active work 执行前判定时，生成 RequirementIndependenceGate、SharedSurfaceLockMap 与 ParallelLaunchCard。

Requirement Parallel Orchestration Skill

职责

本 Skill 负责在进入源码实现、修复执行、长流程 Auto 或子会话派发前，判断多个需求/任务是否可以并行推进。它补齐的是执行前编排判定层，不替代 intent、cp-gate、execution-contract、test-router、report 或 memory。

默认原则：缺少证据时返回 serial-required；只有写入面、CP 状态、共享状态和汇合协议都可验证时，才允许输出 ParallelLaunchCardV1。

触发条件

场景	是否触发
用户要求多个需求/任务“并行推进”“同时做”“开多个子任务/子 Agent”	必须
当前会话准备同时推进 ≥2 个 requirement / bug / optimization / scenario-test	必须
Auto、长流程或控制面任务计划拆分为多个可执行 work item	必须
只读搜索、Profile/记忆读取或互不写输出的验证并行	N/A，按 ConcurrencyPolicy 执行
单一需求的普通串行实现	N/A + skipReason

输入契约

ActiveWorkInventoryV1

字段	要求
activeRoot	当前绑定 active-root；不得跨项目混入
workItems[]	每个 requirement / bug / optimization / scenario-test / current task
workItems[].id	稳定任务标识
workItems[].cpState	CP1/CP2/CP3 confirmed/pending/stale
workItems[].allowedPaths	当前 work item 被允许触碰的路径
workItems[].expectedWrites	预期写入路径、surface、writeKind、owner
sourceRefs[]	sessions、memory_status、SUMMARY、CP artifact、用户消息或报告锚点
freshness	current / summary-only / stale / unknown

信息不足时不得猜测独立，返回 serial-required + insufficient-*。

判定门禁

RequirementIndependenceGate

status	判定条件	输出
independent	allowedPaths 不重叠，未共享控制面写入，CP/记忆/report/ledger 单写者不竞争，且汇合协议完整	ParallelLaunchCardV1[]
weakly-coupled-lock	主路径独立，但共享 skill-portfolio、validation-manifest、package-boundary、memory、report、ledger 或 host-deploy 等单写者面	lock map、singleWriter、checkpoint、serial merge order
serial-required	共享同一源码文件、同一 CP/task state、同一 audit session，或无法证明写入面独立	blocker reason、recommended order、needed evidence

SharedSurfaceLockMapV1

核心共享面：

• active-root
• cp-state
• memory
• report
• ledger
• audit-session
• source-mutation
• package-boundary
• validation-manifest
• skill-portfolio
• host-deploy

source-mutation 只有在路径不重叠且存在完整 merge protocol 时才可能进入 independent。其他共享控制面默认进入 weakly-coupled-lock，由主会话或指定 single writer 串行写入。

ParallelLaunchCardV1

只有 independent 判定可以输出 LaunchCard。必填字段：

字段	要求
requirementId	对应 work item id
displayName	用户可识别名称
activeRoot	绑定根
allowedPaths	非空路径数组
forbiddenSharedSurfaces	核心共享面数组
sessionPrompt	子会话可复制 prompt，必须包含 stop 条件
isolationMode	same-active-root-disjoint-paths / separate-worktree / separate-project-root
mergeProtocol	IntegrationMergeProtocolV1
validationRoute	至少一条验证命令或 selector
stopCondition	触碰禁止面、dirty 外溢、验证失败或 CP stale 时停止

缺字段返回 launch-card-invalid；缺 merge protocol 返回 integration-protocol-missing。

IntegrationMergeProtocolV1

字段	要求
mergeOrder	串行汇合顺序；不能“谁先完成谁合并”
conflictChecks	git diff --name-only、共享 manifest/portfolio/package/docs/Profile 检查
validationRoute	changed/control-plane/profile-deploy/requirement artifacts 等
reportMemoryOwner	最终 report/memory 单写者
failureAction	冲突、缺验证或 dirty 混合归属时回 serial/CP

执行步骤

1. 绑定唯一 active-root 和源码根；确认不是跨项目混读。
2. 有界读取 active work：任务目录、CP 状态、近期 memory/report 摘要、预期写入面。
3. 构建 ActiveWorkInventoryV1，记录 sourceRefs 和 freshness。
4. 执行 SharedSurfaceLockMapV1 和 RequirementIndependenceGate。
5. 对 independent 输出 ParallelLaunchCardV1；对 weakly-coupled-lock 输出锁、single writer 和检查点；对 serial-required 输出 blocker 与推荐顺序。
6. 汇合时执行 IntegrationMergeProtocolV1、TestRoute、report/memory 单写者写入和 ECR。

探针

Probe	场景	期望
PRB-01	两个需求只写各自 requirement 子目录	independent + LaunchCard valid
PRB-02	需求目录独立但共享 portfolio/manifest	weakly-coupled-lock
PRB-03	两个任务修改同一 source file	serial-required
PRB-04	LaunchCard 缺 required fields	launch-card-invalid
PRB-05	缺 merge protocol	integration-protocol-missing
PRB-06	出现 allowParallelMutations 或默认并行源码写入开关	policy-violation

生产入口：npm run test:requirement-parallel-orchestration。

与其他 Skill 的关系

• dev-default / fix-default：实现前出现多任务、并行、子 Agent 或 worktree 信号时触发本 Skill。
• execution-contract：把 LaunchCard、allowed paths、blocked scope、merge protocol 和 single-writer 约束纳入合同。
• test-router：以 requirementParallelOrchestration 领域绑定选择 static + unit-integration；控制面实现叠加 profile-deploy。
• report / memory：记录判定摘要和 LaunchCard 锚点；最终 report/memory 仍由主会话单写者写入。
• source-consumer-sync：消费者、validation manifest、portfolio、Profile、README/website 和部署副本同步由 Concept Sync Map 约束。

禁止

• 禁止把只读准备并行扩展为同 active-root 并行 source mutation。
• 禁止新增 allowParallelMutations、mode=parallel 或绕过 C07 单写者的配置。
• 禁止没有 allowedPaths、forbiddenSharedSurfaces、mergeProtocol 或 validationRoute 就启动子会话。
• 禁止子会话直接写共享 CP、memory、report、ledger、audit session、portfolio、validation manifest 或部署副本。
• 禁止把子会话完成等同于需求完成；必须串行汇合、验证和 ECR。