luminae-helper 1.2.2 → 1.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (25) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +48 -43
  3. package/codex-plugins/.agents/plugins/marketplace.json +20 -0
  4. package/codex-plugins/.claude-plugin/marketplace.json +13 -0
  5. package/codex-plugins/plugins/ai-development-workflow/.claude-plugin/plugin.json +8 -0
  6. package/codex-plugins/plugins/ai-development-workflow/.codex-plugin/plugin.json +15 -0
  7. package/codex-plugins/plugins/ai-development-workflow/LICENSE +21 -0
  8. package/codex-plugins/plugins/ai-development-workflow/hooks/codex.json +30 -0
  9. package/codex-plugins/plugins/ai-development-workflow/hooks/hooks.json +22 -0
  10. package/codex-plugins/plugins/ai-development-workflow/skills/ai-development-workflow/SKILL.md +38 -0
  11. package/codex-plugins/plugins/ai-development-workflow/skills/ai-development-workflow/agents/openai.yaml +3 -0
  12. package/codex-plugins/plugins/ai-development-workflow/skills/ai-development-workflow/references/codex-coordinator.md +55 -0
  13. package/codex-plugins/plugins/ai-development-workflow/skills/ai-development-workflow/references/coordination.md +292 -0
  14. package/codex-plugins/plugins/ai-development-workflow/skills/ai-development-workflow/references/direct-handoff.md +17 -0
  15. package/codex-plugins/plugins/ai-development-workflow/skills/ai-development-workflow/references/handoff.md +59 -0
  16. package/codex-plugins/plugins/ai-development-workflow/skills/ai-development-workflow/references/verification.md +58 -0
  17. package/codex-plugins/plugins/ai-development-workflow/skills/ai-development-workflow/scripts/codex_compact.py +112 -0
  18. package/codex-plugins/plugins/ai-development-workflow/skills/ai-development-workflow/scripts/codex_dispatch.py +102 -0
  19. package/package.json +2 -1
  20. package/src/index.js +13 -0
  21. package/src/lib/codex-plugin.js +276 -0
  22. package/src/lib/constants.js +14 -68
  23. package/src/lib/installer.js +25 -34
  24. package/src/lib/skill-command.js +40 -0
  25. package/src/lib/ui.js +78 -124
@@ -0,0 +1,292 @@
1
+ # 协作与交接
2
+
3
+ 用于多项目、多会话或跨工作区协作,也用于单会话的方案可行性判断、设计与实现同步、接口迁移、契约就绪核对和适用的文档工作。评估或执行接替、接管、归档时另读 [接管与退出](handoff.md),普通派单不必加载该引用。
4
+
5
+ 按需定位:
6
+
7
+ - [同任务直接交接](direct-handoff.md):仅在采用负责人串联时读取。
8
+ - 职责与派单:[组织方式与执行者选择](#组织方式与执行者选择)、[会话身份与职责](#执行者类别与任务匹配)、[再委派](#执行者再委派)、[文档任务](#文档任务的制作与确认)、[会话占用](#任务排序与会话占用)、[工作区定位](#执行会话的工作区定位与操作范围)、[任务包](#任务包)、[临时 Bug 排查](#临时-bug-排查)。
9
+ - 基线与接口:[基线与契约](#基线与契约)。
10
+ - 状态与变更:[状态和回报](#状态和回报),包括[局部沟通与统一收口](#局部沟通与统一收口)、基线同步、写入权移交及回报去重。
11
+ - 轮次与监控:[轮次出口与续接](#统筹的轮次出口与续接)、[监控核查](#已授权监控的核查与收口)、[交付偏差](#交付节点与偏差预警)、[超期未回报](#超期未回报)。
12
+
13
+ ## 所有权和任务包
14
+
15
+ 本引用中的协调责任方,有统筹时为本任务当前唯一的顶层统筹,用户亲自协调时为用户;再委派的原执行者不因此成为另一统筹。未设统筹时,执行者在当前聊天向用户交付结果及可转交摘要,由用户衔接依赖、收取结果和安排后续;不为满足回传要求自行新增统筹、跨会话派单或发消息。面向统筹的工具操作仅在采用统筹模式且具备相应权限时适用。执行者可为子 Agent 或独立主会话,沿用用户已选类型;下文会话复用、回传及生命周期操作按实际工具能力适用,不因缺少独立聊天功能排除子 Agent。
16
+
17
+ 同职责、同工作区、同阶段优先复用合适的未归档会话,避免每个缺陷都开新聊天。跨仓库/工作区按产物所有权拆分;同一文件或相互影响的改动明确唯一写入负责人,无冲突任务可并行,冲突先串行。按用户和项目规则使用当前 checkout、既有分支和工作树;不要由团队模式推导创建、切换或清理权限。
18
+
19
+ ### 组织方式与执行者选择
20
+
21
+ | 条件 | 选择及代价 |
22
+ |---|---|
23
+ | 单仓小改、短周期、低依赖 | 未设统筹时用单执行会话,直接实现和比例验证;用户要求统筹时仍按下述分工交执行会话产出 |
24
+ | 少量独立工作,用户选择亲自衔接 | 用户协调独立会话;上下文隔离清楚,用户承担依赖和授权转述成本 |
25
+ | 多工作区、有阶段依赖或需独立验收 | 可建议单统筹+按需执行会话;减少用户协调,增加交接成本和统筹单点风险 |
26
+
27
+ 角色按缺口启用,沿用项目已有工作流和契约机制。项目采用或要求 OpenSpec 等机制时才沿用。不设固定审查人数或分数。短时、范围明确且结果可直接回传的任务优先考虑子 Agent。长期维护、跨阶段推进或需要持久记录与独立续接的任务优先考虑独立主会话。选择须符合用户指定、实际工具能力及原授权,不由会话类型推定职责、验收资格、权限或生命周期。既有分工和在途任务继续按实际状态处理。
28
+
29
+ 预计在执行中需要多轮向用户提问或确认、再根据答复推进的任务,使用用户能直接进入和回复的独立主会话。并行事项各自需要逐步确认时,按可独立推进的事项分开。例如同时验收三个页面,若每页都要用户逐步确认,就为每页安排一个独立验收会话,由验收者在各自会话提问并回传结果;统筹汇总进度和结果,统一处理跨页共性问题。子 Agent 可承接无需持续互动的工作;一次局部澄清或能在派发前一次问齐的问题不因此另开会话。独立会话不可用或缺少授权时,在合适且已获授权的执行或验收会话中逐项推进,或交用户人工转交任务包,避免多路逐步问答集中到父会话。
30
+
31
+ 合流、冲突解决、暂存、提交、构建及作为交付或验收依据的实质测试由执行者承担。用户批准操作范围后,仍按已确认的统筹与执行分工安排。既有派单覆盖新阶段时复用,缺口按原授权规则补齐。统筹已代做时,核查后台活动,按[状态和回报](#状态和回报)保全产物和证据并确认停写,再移交唯一写入权。复用仍有效的结果和证据,只补影响判断的缺项和约定的独立复验。
32
+
33
+ ### 执行者再委派
34
+
35
+ 已指定角色之间的同任务阶段交接按[直接交接](direct-handoff.md)执行。新设子任务或新增执行者时,另核下列再委派授权。
36
+
37
+ 本节适用于受统筹管理的执行者再委派。在用户授权内可再委派,原执行者对原任务的整体交付负责,统筹保持统一调度和验收管理。本节中的下属指受再委派的执行者,不推定独立主会话具有平台父子关系;独立主会话与子 Agent 均遵守以下边界。
38
+
39
+ - **授权**:接单、开发或回传权限不自动包含再创建、再委派。核对可定位的直接用户授权是否覆盖创建或复用、派单、执行者类型、任务范围及继续向下委派,已有授权覆盖时不逐次重问。有统筹时,这些权限的缺口默认由本任务当前唯一的顶层统筹统一向用户提出,执行者沿既有获授权链路上报,不各自索权;无消息权限或统筹暂不可用时保留待授权摘要,沿用人工转交或已获授权的读取兜底,不为索权越权发送。用户可一次授权指定执行者在本任务的专业、项目工作区及有效边界内,按约定创建或复用下级会话、派发内部子任务及继续向下委派;已覆盖的内部拆分直接执行,未覆盖或范围变化时由顶层统筹只补缺失授权,不将仅覆盖特定执行者或动作的授权自行扩展。未设统筹或用户明确指定执行者处理授权时,由该执行者在当前聊天或已有获授权渠道处理;用户已直接作出的有效授权沿用,不要求统筹重批或新增统筹。统筹只能转达和分配用户已授予的权限,创建、派单、再委派、回传及其他消息权限分别核对,仍须满足实际工具许可,不因统一收口或会话层级扩大授权。
40
+ - **调度**:统筹负责整体范围、优先级、跨任务依赖和改派;原执行者仅协调获准拆出的内部子任务,不调动其他执行者或扩大专业、项目范围。按既有任务包记录子任务、实际执行者及产物负责人,沿用工作区、依赖、占用和唯一写入负责人规则,不以再委派绕过分工或制造冲突写入。
41
+ - **回传**:默认下属向原执行者返回,原执行者核对、整合后向统筹交付,保留实际作者、任务版本、证据、未结项和下一负责人;已有约定允许直接回统筹时沿用,按事件去重,不强制双重回报。原生返回与跨聊天消息仍分别按已有授权及工具能力处理;原执行者核对未回传或未完成部分,不把局部完成当原任务完成。
42
+ - **验收**:下属负责自身产物及自验,原执行者负责整合检查及原任务的完整交付,不能以已委派转移责任。统筹管理约定的验收出口;独立复验仍须由明确承担该职责且未参与制作的执行者完成,不因检查者是另一个会话就将开发自验签为独立验收,约定的用户业务接受仍由用户完成。
43
+
44
+ 原执行者暂停、接替或退出时,核对其再委派任务及相关后台操作的实际状态,沿用既有保全、停写确认和交接规则,不推定下属同步停止,也不因此取得中止或其他额外操作权限。
45
+
46
+ ### 开发执行会话的工作区边界
47
+
48
+ 本节用于已采用多执行会话分工的开发实现任务:默认每个开发执行会话负责一个专业类别、一个项目实际工作区的实现及对应自验,同专业、同工作区、同阶段优先复用合适的未归档会话。产品、设计、文档和独立验证按产物或验证范围组织,不一律逐项目拆分;开发自验不能代替约定的独立复验。
49
+
50
+ 项目和工作区以已有项目划分、实际路径、checkout、分支及产物所有权核对,路径别名不算新工作区,普通子目录不因名称不同就自动算独立项目。代码、配置、实现配套测试和技术契约明确唯一写入负责人;拆成多个会话不代表相互影响的改动可直接并行,仍须核对契约就绪和依赖顺序。
51
+
52
+ 跨项目合并实现的例外以可定位的用户明确决定为依据:在现有任务包记录合并理由、涉及项目及工作区/分支、专业和产物范围、串行顺序及验证方式、授权来源、适用任务和停止条件。已有决定覆盖本次范围时直接复用,不重复索权;一般开发授权、历史复用、交期或人手压力不能替代跨项目合并决定。获准后串行处理各项目,切换前分别核对路径、分支、适用指令和现场状态,不扩大到其他专业、项目或任务。
53
+
54
+ 执行者可在已有授权范围内跨项目读取、核对接口或参与联调,这不自动扩大其他项目的实现写入职责。生产者与消费者分别负责各自实现,契约指定维护负责人并由双方核对;各项目结果关联同一需求、契约版本及整体验收条件,不能用各自自验通过替代跨项目验证。
55
+
56
+ 缺少合适执行会话或创建、消息权限时,记录职责缺口并交人工任务包或提出组织调整建议,不自行合并、不自动创建会话,也不由统筹代做实现;会话拆分不授予分支、worktree 或其他操作权限。
57
+
58
+ 规则更新不自动中止、重派或归档在途任务。发现已有跨项目执行时先核对原授权、进度、未提交产物和后台操作;有适用例外则沿用,没有适用授权则向用户说明偏差并提出拆分或例外建议,不新增或扩大跨项目写任务,也不擅自打断正在生效的操作。获准拆分后按现有保全、停写确认和唯一写入权移交流程处理;未知状态保持未知。
59
+
60
+ ### 执行者类别与任务匹配
61
+
62
+ 身份绑定本次任务、阶段和产物。开工时确定需要哪些身份,派发或交接前落实当前阶段负责人、工作区和回传对象。核心身份也按需启用。前端、后端等是开发专业类别,负责人串联中的任务负责人是既有执行者承担的交接责任。
63
+
64
+ | 身份 | 职责与兼任边界 | 何时、向谁回传什么 |
65
+ |---|---|---|
66
+ | 核心 · 统筹 | 同一任务只有一个当前统筹。负责协作安排、派发、核收、验收管理和偏差纠正。不得兼做本任务的业务交付、独立验收或自己的独立监督。 | 在派发交还、约定检查点、阶段收口或出现实质影响时,向用户报告已证实范围、待办、风险和下一动作。 |
67
+ | 核心 · 开发执行者 | 负责对应技术方案、实现、修复和自验,按专业、工作区及唯一写入负责人规则执行。不得独立验收自己参与实现或修复的候选。 | 自验达到通过条件时,向任务包接收人交付候选版本、改动、自验证据和未测项。 |
68
+ | 核心 · 独立验证者 | 在独立上下文根据需求、设计及契约设计用例、实测、取证和复验,可复用有效证据并独立判断。不得参与被验产物的制作或代做业务修复。 | 每次验收或复验形成结论后,向任务包接收人回传候选版本、结论、证据、缺陷和未测项。按约定路线交原负责人返修。 |
69
+ | 核心 · 独立监督者 | 在独立于统筹会话的上下文,按约定检查点只读核查执行、收取与用户告知。不得兼任所监督任务的统筹、核查自己承担的操作,或代为纠正。 | 有可核实的新偏差时,向当前统筹报告任务版本、证据和影响。确认统筹漏报时按授权直接通知用户。到约定阶段停止,详见[监控核查](#已授权监控的核查与收口)。 |
70
+ | 按需 · 产品执行者 | 负责需求、产品方案、业务规则和验收标准。未决业务规则及约定的业务接受由用户确认。不得以该职责代做视觉设计、开发或独立技术验证。 | 形成需求或规则的阶段结论时,向任务包接收人交付版本、决定出处、待确认项和影响。 |
71
+ | 按需 · 设计执行者 | 负责设计方案、设计稿和设计说明。不得以该职责代做开发、已实现页面的功能测试或真实接口测试。 | 交付设计或确认设计变更影响下游时,向任务包接收人回传设计入口、版本、变化、适用范围和待确认项。 |
72
+ | 按需 · 文档执行者 | 负责独立成项的资料梳理、正文起草、修订与整合,依已确认意见维护正文,核对来源、版本及一致性。产品、设计、技术判断由对应负责人作出。不得以编辑职责代做开发、独立复验或用户业务接受。 | 交付文档或完成已确认的修订时,向任务包接收人回传正文位置和版本、差异、来源、未决项及实际同步状态。 |
73
+
74
+ 执行者完成、中止、遇到新的实质阻塞或阻塞变化影响衔接时,按[状态和回报](#状态和回报)回传。逐段协调通常交当前统筹;再委派默认交原执行者;负责人串联区分阶段接收方和终报对象;用户亲自协调时在当前会话交付。统筹在当前会话或获准渠道向用户报告。其他回传使用[任务包](#任务包)中已核实的原生返回、授权消息渠道或只读收取与人工转交入口。
75
+
76
+ 会话可按明确分工复用到其他任务或阶段。先核对专业类别、产物和权限,历史兼职或工具可用不能代替本次分工。兼任以实际参与和产物归属判断,换会话或改称谓不能恢复对自己制作的产物的独立验证资格。前端与设计稿对比属于开发自验;设计基线的变更交设计执行者。后端开发维护所分配的接口契约并与消费者核对兼容。全栈职责仍须明确授权并符合工作区、依赖和唯一写入规则。缺少合适的已授权人员时,记录职责缺口和受影响环节。改派前核查原任务状态,保全产物和在途操作,再按[接替规则](handoff.md)移交。
77
+
78
+ 跨项目改动仍按实际实现层、专业范围和产物所有权归属,不仅凭仓库名称或页面名称派单;开发执行会话能否跨项目承担实现,统一按“开发执行会话的工作区边界”核对,不以专业相同替代例外授权。
79
+
80
+ 交叉产物按用途和所有权在现有任务包中指定唯一写入负责人,相关方核对,不以“共同负责”代替归属:
81
+
82
+ - 文档分别明确实际编辑者和专业内容负责人:独立文档任务优先交文档执行者,开发仍维护与本次实现直接配套的技术说明、接口说明及自验记录,不因新增角色强制移交。产品负责业务需求、规则及业务验收标准的专业判断,设计负责设计内容,开发负责技术事实、方案及契约,测试负责独立验证预期与实际证据。混合文档指定唯一编辑者汇集各方内容及意见,各专业负责人不因此并行改写同一正文;统筹继续维护协调记录及验收汇总,不因新增文档角色自动转交。专业职责内的配套文档维护仍属原角色范围;角色按缺口启用,不为每次文档小改额外创建会话。
83
+ - 用例与自动化测试:开发负责实现配套的单元、契约及自验测试;测试负责约定的独立验收与回归用例及脚本,复用已有覆盖,独立判断预期。
84
+ - Mock 与测试数据:开发联调、自验所需的适配代码和 Mock 由对应开发负责;独立验证专用的场景、夹具及测试脚本由测试负责。共用设施指定一方维护、另一方复用;仍须核对契约版本、隔离及写入授权,不因制作测试数据获得真实写权限。
85
+ - 接口契约:按生产者与消费者职责指定主责开发执行者维护,双方核对兼容及适配;产品澄清业务语义,测试提供可测性和边界反馈,不自行更改契约。文档执行者可据已确认契约整理接口说明,不因此取得契约变更职责。涉及未决业务规则或兼容取舍时按项目机制及已有授权确认。
86
+
87
+ ### 文档任务的制作与确认
88
+
89
+ 派单前明确目标文档或章节、允许的修改范围、权威来源及版本、唯一编辑者和适用的专业确认人。独立文档制作与随实现发生的配套说明按本次交付目标判断,不仅凭文件名、格式或“文档”字样归类;沿用已确认分工,不自动改派在途任务或转移写入权。跨项目文档汇总按文档产物范围组织,不因涉及多个项目就要求开发跨项目合并例外;涉及各项目实际工作区时仍按下文绑定和显式选址规则执行,也不扩大实现写入职责。
90
+
91
+ 修改前读取最新正文及后续用户决定,遵守适用的文档规则。同步外部文档前另核操作授权,并保留准确的操作前快照。重构需求或产品文档、编写或修复版本化外部文档时,保留准确操作前快照和来源链,保护最新用户修改。按已确认意见准确转写、纯结构或措辞调整可在授权内完成并自检,不重复索取同一决定;新增或改变专业含义时交对应专业负责人核对,未决业务或兼容取舍仍按原决策机制处理。来源矛盾、修改冲突或缺项列明位置、依据及待确认责任人,仅阻塞受影响内容,不编造已确认基线。写后核对实际正文与差异,交付来源说明、未决项及实际同步状态;文档整理通过不能代替软件验证,测试报告保留实际已测、未测及延期状态。文档编辑不自动授予外部发布或跨会话消息权限。
92
+
93
+ 统筹接到独立成项的文档修订时,先明确唯一编辑者和验收分工。统筹可在授权内抽查现状、界定范围、准备任务包和核对交付证据。转入为修订制作完整链接清单、逐项核验或拟定变更稿前,即按主文件的阶段切换规则确认派发。文档执行者负责这些制作工作、目录调整和批量移位改名、正文及链接写入、写后回读和交付自检。优先按授权复用合适的文档执行会话。用户明确指定新开独立文档会话时沿用该选择,分别核对创建、派单和文档操作权限。若统筹已代做,按主文件的阶段切换规则保全产物和证据,核实在途写入及其实际结果,确认停写后移交唯一写入权。接手者从最新可核实的文档状态继续,复用有效证据。
94
+
95
+ ### 任务排序与会话占用
96
+
97
+ 下发任务前核对执行者是否可用及在途状态;工具支持归档时另核对是否已归档,不将子 Agent 的完成、关闭或不可用状态直接等同于独立聊天归档。已归档会话默认不作为派单或唤醒对象,不因专业匹配、历史复用、返修需要或缺少其他执行者自行恢复。用户明确指定恢复该会话或向其继续派单时,复用该决定,在既有操作权限内核对当前职责、任务基线、工作区状态及负责人后执行;恢复会话不自动恢复已移交的职责或写入权,涉及改派仍按现有接替和唯一写入权规则处理。只读查阅已归档历史不属于恢复执行,也不因此解除归档或唤醒会话。
98
+
99
+ 复用执行会话或下发新任务前,先核查其在途任务、当前状态及执行或复验职责。文件无冲突不等于执行资源空闲;会话正在执行任务或仍有需持续关注的后台操作时,新任务默认排队,不用无关新任务覆盖或擅自打断原任务。等待用户或依赖且无持续操作时,可在记录原任务停止点、恢复条件及相关影响后承接独立且已授权的工作;等待不代表原任务完成或暂停解除。
100
+
101
+ 排队顺序复用用户最新已确认的优先级及依赖约束,不因任务新到就自动插队。用户未排定先后时,统筹在已就绪、已获授权且满足依赖和占用条件的待派任务中,优先安排有实际依据可解除下游阻塞或保护已承诺交付节点的任务。影响相当时沿用现有队列,无既定队列则按就绪先后。调整会改变用户已确认的交付顺序、交付承诺或业务优先级时,先说明影响并取得用户决定,已有明确决定不重复询问。获准插队时,记录被暂停任务的版本、实际进度、负责人、暂停原因及恢复条件,在既有授权内落实安全暂停和必要通知;未确认可安全暂停时不宣称资源已释放,也不擅自杀进程。需要另找执行者时优先核查现有空闲会话,创建新会话仍须相应授权。
102
+
103
+ ### 执行会话的工作区定位与操作范围
104
+
105
+ 工作区组织沿用用户选择,不因采用多执行会话就要求 worktree。用户判断当前只有一个需求(一般对应一个开发分支)在开发时,可直接使用主工作区及对应开发分支,不按每次派单重复确认需求数量。需要切换时先核对已有切换授权、未提交产物及在途操作,保全现场且不覆盖用户修改;单需求判断或开发批准不自动授予切换或创建分支权限。并行需求按实际冲突选择串行或使用已获准的 worktree,不自行认定必须隔离、创建或切换。多个执行者也可共享主工作区,但仍按专业和产物明确唯一写入负责人,冲突任务串行;共享目录不改变独立复验资格。
106
+
107
+ 项目登记决定聊天归属;聊天默认 cwd 提供默认操作及规则自动发现入口;实际工作区是本任务操作的 checkout;Git worktree 有对应工作目录、HEAD 和 index;托管关联提供特定产品的聊天/工作树及生命周期能力;用户授权和沙箱许可决定可执行范围。这些事实分别核对,不能互相代替;主仓项目下的既有 worktree 不因目录不同自动成为新项目,也不要求逐个登记为项目。
108
+
109
+ 独立主会话和子 Agent 均以可核实的实际工作区及操作范围判断就绪:已正确绑定目标时直接复用;也可保留主项目归属及默认 cwd,在已有权限内通过显式目录操作主工作区或既有 worktree,无需另取“免绑定”例外。用户明确要求某种绑定或组织方式时仍沿用,不擅自替换。跨项目任务分别列明目标路径;测试身份不自动构成跨项目范围,开发跨项目实现仍须原有明确例外授权。
110
+
111
+ 派单、复用、接替及目标变化时,在已有任务包中保留实际工作区、已确认的分支安排、定位方式及必要证据;复用有效核验,只补变化和会影响操作的缺项,不把每次操作升级为重做全部检查:
112
+
113
+ - **分支安排**:首次实质操作前,核对可定位且仍适用于本任务的决定及项目规则,按已确认内容核对起点、实施分支、验证后归并目标及推送限制。简短确认和轻量修复只更新本次明确改变的内容,沿用其余有效安排。历史建议先核对适用范围及确认来源。当前 checkout、干净状态或未提交改动所在分支只描述现场。现场与已确认安排不符时,保全未提交产物,只暂缓依赖该安排的实施、验证或归并,按实际需要核对创建、切换、搬移改动、归并或推送的授权,只补缺口。未安排的归并或推送不列为待办、授权缺口或交付阻塞。
114
+ - **目录与 Git**:核对目标绝对路径及实际 checkout、分支或 HEAD、对应 Git 目录/index、未提交及未跟踪产物和唯一写入负责人。使用工具 workdir、项目路径、Git 的显式目标或可核实的实际 cwd,编辑使用已核目标路径。任务包声明、父会话目录、UI关联或设置过一次 workdir 均不足以证明后续动作仍指向目标;涉及相对路径或登录 shell 时核实实际起点,目录选择失败即停止相关动作,不能回落主仓继续。
115
+ - **规则、权限与生成物**:显式加载目标工作区及操作路径适用的规则、工作流、技能和必要配置,不以主仓自动发现代替。用户授权、实际读写许可分别核对;命令、编辑、formatter、测试和生成器的作用及输出路径须在范围内,共享缓存或设施按实际影响核查,不因只运行测试而推定无写入。
116
+ - **运行与共享资源**:需要运行验证时,将实际服务/进程工作目录、端口或入口及加载源码关联到本次候选版本;二维码或页面能打开不证明加载正确。沿用服务启停及测试场景授权,不默认启动模拟器、原生构建或其他未约定环境。共享端口、服务、设备或相互影响的缓存需核对占用、负责人和顺序,不以文件无冲突判断可并行。共享测试资源交接时,先确认前一任务已结束使用,或已按授权安全暂停并保全续测所需的现场和证据,再核实相关资源已释放、可供接手。由获授权的负责人完成必要切换,核实实际入口加载了本次候选版本后再开始验收。
117
+
118
+ 某 UI、Git 或生命周期工具依赖默认项目或托管关联且不能显式选址时,不用它对其他工作区操作,优先选择已有授权内可正确选址的工具。无真实绑定只限制确实依赖它的功能;不能把登记/附加/迁移某目录这一条路线的前提说成所有执行路线的门槛,也不默认改用子 Agent 或 projectless 聊天。报告缺口时明确待证明结论、受影响操作、缺失能力或权限及可行替代,不反复要求用户添加目录来解决可避免的机制限制。
119
+
120
+ 目标、分支、规则、许可或真实加载版本无法核实时,仅阻塞依赖该条件的操作,其余独立且已授权工作继续。任务包记录实际偏差及恢复条件,不虚报已绑定、迁移、加载或具备默认 UI 差异能力;不得为满足选址要求擅自创建、迁移、导入、删除或附加工作树、迁移聊天、切换/创建分支,也不由此扩大访问、派单、再委派、回传或其他消息权限。
121
+
122
+ ### 多项目与工作区
123
+
124
+ 启动时从需求识别涉及的项目,复用已有记录列明各项目实际工作区的绝对路径、分支、执行负责人、产物所有权及项目间依赖。会话绑定目录只是默认操作目录,不代表全部统筹范围;不能只因绑定某个项目就遗漏其他项目。
125
+
126
+ 已获授权新建多项目统筹会话时,优先使用独立协调目录保存跨项目基线、任务包、协调记录及验收汇总;已有统筹可保留当前绑定,不为采用此结构自动迁移会话、移动文件或创建分支/worktree。单工作区执行者按上述定位与操作范围规则使用目标实际工作区;跨项目执行会话显式选择各目标工作区,不把业务交付物写入统筹目录。
127
+
128
+ 跨项目读取或验证时显式指定目标工作区(如命令的 workdir 或工具的项目路径),核对该项目适用的指令、工作流和验证要求;不把统筹目录或另一项目的规则直接套用。任务包将项目、绝对路径、分支和产物负责人对应到具体执行任务。
129
+
130
+ 按项目及受影响产物分别记录冻结、暂停、验收和访问限制,再按依赖判断整体影响,不将单个项目状态直接当成整个需求状态。某项目不可访问时,明确缺失资料、负责人及恢复条件,仅阻塞依赖该项目的工作,其他无依赖且已授权的任务继续。目录选择及项目映射不授予额外访问、会话创建、消息、分支或worktree权限。
131
+
132
+ ### 基线与契约
133
+
134
+ 本节也适用于单会话的方案可行性判断、设计与实现同步、接口迁移及兼容核对。
135
+
136
+ 推荐或下发方案前,将拟采用路径与已确认目标、已核事实及关键边界反例对照,排除明确违反约束的路径;尚缺证的路径写清成立条件和待核项,不将未知当作已证明可行或不可行。认定必须新增接口、字段或同步链路时,须有已核实的能力缺口及不能复用既有能力的依据。专业方案及其可行性依据由对应执行者产出,统筹核对其与任务基线、依赖和授权是否一致,不代做专业交付物,也不为检查默认新增角色、固定表格或审批层。
137
+
138
+ 更新基线不等于在途任务已采用最新决定;协作时按协作引用的变更同步规则核实。文档链接或 ID 只证明可定位,不能证明正文已核对或同步。同步外部文档按[文档写前核对](#文档任务的制作与确认)处理。保留来源链,避免交接摘要抹掉用户后来的纠正。设计先行或代码先行按本次决定,注明当前权威基线、同步方向和接受后待同步项,不默认设计稿始终领先。
139
+
140
+ 需求→设计→接口→代码→用例→证据应能互相定位,无需复制成多套表。复用已有组件、主题和设计依据,先核锁定版本的公开能力与实际数据来源;能力缺口明确降级或待决策,不凭设计补造接口能力。可访问性或质量检查不能自动变成新增视觉、业务或权限规则。缺少预期且会改变行为时再澄清。
141
+
142
+ 跨接口版本或迁移时,分别标明生产者契约和消费者适配版本,不编造冻结版本。对齐字段/类型/空值、错误、身份来源和资源归属、写入及顺序语义、样例与兼容差异;Mock 绑定所测路径的版本。就绪以本次依赖路径为范围:受影响的生产者与消费者已核对实施所需内容、版本及兼容取舍,阻断性分歧已关闭,或已有按项目机制及授权确认的适配安排;文档齐全或一方未回应均不代表就绪,无关接口无需冻结。就绪才并行依赖实现,未就绪可做独立准备。
143
+
144
+ ### 任务包
145
+
146
+ 下发前确认依赖、工作区核验及占用状态就绪,用已有记录组成最小任务包。首次执行者接单前按主文件要求加载适用规则;复用执行者核对已加载内容和相关变化,资料不可访问时仅阻塞依赖该资料的工作。
147
+
148
+ 范围清楚、依赖和风险较低的常规派单可用简短任务包,写清任务和可定位基线、负责人和实际操作范围、交付与通过条件、授权来源和停止点、回报与收取方式。可直接引用执行者能访问且仍适用于本次任务的现有记录,只补缺项和变化。无论任务包长短,执行者都须能从正文或引用中定位本次执行、验收和恢复所需的信息,包括适用规则入口、验收负责人、证据保存位置及适用的暂停恢复条件。下表按本次任务的适用范围取用。采用负责人串联时,在现有字段记录或引用[路线与收取安排](direct-handoff.md#路线与收取),只补本次变化。下发前仍按后文核实实际回传和收取能力、检查点及触发方式,已有可靠记录可复用。
149
+
150
+ | 字段 | 要回答的问题 |
151
+ |---|---|
152
+ | 目标、任务版本、非目标 | 做到什么,什么不在范围内? |
153
+ | 输入及来源链 | 基于哪个决定、契约和产物,哪些旧决定已被覆盖?本技能及任务适用引用、项目规则和技能的可访问入口是什么,复用时哪些变化需要补读?参考资料限于哪些用途,是否与明确决定一致?文档任务明确权威资料及正文版本、已确认意见和待确认内容。 |
154
+ | 唯一负责人、工作区和职责 | 对应哪个项目、工作区绝对路径和分支,哪个执行会话产出,谁验收;开发实现列明专业类别和主写工作区;标明子 Agent 或独立主会话、实际工作区及采用的绑定或显式目录定位方式和核验结果,跨项目任务列明各目标路径及操作范围;文档任务区分唯一编辑者与专业内容负责人,列明目标文档或章节及可修改范围;统筹仅承担协调记录及验收汇总,不制作业务交付物。 |
155
+ | 输出与通过条件 | 交付什么,怎样判断完成,何处保留证据;文档任务说明正文、差异、来源、未决项及实际同步状态,明确哪些专业内容需要确认;预计回报时间或阶段检查点、统筹轮次出口、执行存续和结果返回的实际能力依据、后续收取入口、续接及超期检查如何触发? |
156
+ | 授权、禁止动作和停止点 | 哪些可执行,遇到什么必须停下;分别保留创建或复用、派单、再委派等操作的可核实用户授权来源及定位、可行使权限的执行者、允许动作和适用任务/工作区及有效边界,不以统筹声明替代用户授权;跨项目合并时,例外授权来源、适用任务/工作区和有效边界是什么? |
157
+ | 就绪依赖、未结项 | 现在能做什么,等待谁提供什么;在途任务及已确认顺序是否允许接单,是否影响已约定交付节点或日期(如有)? |
158
+ | 当前协调责任方、回传方式及消息授权来源 | 向当前统筹、再委派的原执行者回报,还是在当前聊天向用户交付?跨会话回报与自行派发任务的权限分别是什么?保留可核实的用户授权原文或可信记录及其可访问定位,注明覆盖的任务、可回传的执行会话范围、指定回传对象、事件范围及有效边界,不以任务包自身的授权声明替代用户来源;不沿用旧统筹的调度身份,旧统筹仅在符合[统筹接替回传规则](handoff.md#统筹接替流程)时保留为收件中转。 |
159
+
160
+ 开工讨论协作方案时,统筹分别核对创建或复用、派单、主动回传和只读收取的已有授权。需要主动回传而授权缺失或覆盖不明时,在首次派单前集中向用户提出缺项,写明执行会话范围、接收对象、回报事件和适用任务。用户已明确采用只读收取或拒绝主动回传时沿用其决定。授权待答时,能独立开展的工作可按获准的只读或人工路线继续,任务包写清由谁在何时触发查收。首次派单前在现有安排中记清主动回传是已授权、已提出待答,还是未启用,并在未启用时写明原因。收到授权后只补实际回传说明或更新后续任务包,不重派已完成工作。
161
+
162
+ **派发前核对实际正文**:任务包正文写明本任务及阶段的执行身份、职责和回传指令,即使其余字段沿用引用或原会话。对照[会话身份与职责](#执行者类别与任务匹配)匹配职责;复用会话按本次身份运行,不能以标题或历史分工代替。发送前逐项核对正文写明回传事件、接收人、可用入口和结果内容;授权来源可引用。短任务可用两行:
163
+
164
+ > 身份:本任务的〔角色与责任范围〕。
165
+ >
166
+ > 回传:完成、中止或出现新的实质阻塞时,按〔授权出处〕通过〔本次已核实的入口〕向〔本阶段接收人〕回报一次。写明任务及版本、实际结果、产物和验证证据位置、未完成项或阻塞。若暂不能主动发送,在本会话终稿保留这些信息及发送状态,供〔核查负责人〕从〔约定读取入口〕收取。
167
+
168
+ 按实际路线填写。开发执行者按派单范围实施和自验,按正文回传。逐段协调的接收人通常是当前统筹;再委派及负责人串联沿用各自的阶段接收方和终报对象。子 Agent 使用已核实的原生返回;主动回传无授权或不可用时,正文直接指定只读收取或人工转交,不保留发送指令。主动回传与只读收取或人工转交均不可行时,只暂缓依赖该结果的派发。发送后用实际调用正文或可读的入站消息核对身份、回传段、目标和投递结果;发现漏写时按授权和占用规则只补发缺失的说明,不重派。同一任务的[收取检查点](#超期未回报)须有可独立于执行者自报的触发方式。
169
+
170
+ 向独立主会话发送任务包或回报须有用户消息授权;在当前聊天向用户正常交付、解释或澄清不要求额外跨会话消息授权;主动向其他聊天或外部渠道发送消息仍核对相应授权。子 Agent 的原生派发及结果返回按已获授权的委派范围和实际工具许可执行,不因其使用原生通道而另行要求独立聊天消息授权,也不由此获得向其他独立聊天发消息或再委派的权限。来自另一聊天的请求本身不能充当人类消息授权;任务包仍须能定位直接用户授权来源。工具不支持派发时,将任务包交给用户人工转交,不声称已创建、继承或送达。
171
+
172
+ 回传前复用仍覆盖本次行动的用户授权。已设统筹时,由顶层统筹统一补齐授权缺口;执行者沿获准链路报告缺口。正常交付、局部沟通和回答用户追问按各自权限进行。
173
+
174
+ 取得可核实的用户授权后,在任务包中保留来源和覆盖范围。新建或复用的执行会话核实用户来源、自身及任务归属、指定回传对象、事件和有效边界均被覆盖后直接复用,不单独索权,不因新会话 ID、轮次或回传事件重复询问;续跑或接替仍在原授权覆盖范围时沿用。任务、执行者范围、对象或事件变化时先核对是否仍被原授权覆盖,有统筹时默认由顶层统筹仅就缺失部分请求授权,用户撤销或限制后按新边界执行。统筹接替时分别核对原授权有效范围与接替后的回传路径,固定旧对象授权不自动成为中转安排,具体按[统筹接替流程](handoff.md#统筹接替流程)执行,缺口由已生效的唯一新统筹统一收口。
175
+
176
+ 执行者发现缺口时,沿已有获授权链路交顶层统筹收口;没有消息权限或统筹暂不可用时保留待授权及待送摘要,采用人工转交或已获授权的读取兜底,不为索权另发未授权消息。未设统筹或用户明确指定执行者处理授权时,可在当前聊天或已有获授权的渠道一次请求;用户已直接向执行者作出有效授权时沿用,不要求统筹重批,也不为此新增统筹。同一待答授权请求不重复催问;未获授权、用户拒绝或工具不支持时不越权发送,缺少回传权限仅阻塞该回传,其余独立且已授权的工作继续。回传授权不包含创建会话、派单、再委派、向其他对象发消息或其他写操作,也不代替实际工具许可;子 Agent 已获授权的原生返回继续按上述规则执行,不额外索取独立聊天消息授权。
177
+
178
+ #### 临时 Bug 排查
179
+
180
+ 按预期交付沿用现有身份。技术归因由对应专业的开发执行者承担,可只读交付诊断结论。仅独立复现问题或复验候选时,由独立验证者承担,发现缺陷交对应开发者。核查统筹是否偏离协作流程时,才使用独立监督者。
181
+
182
+ 派单时在现有任务包写清:
183
+
184
+ - **排查目标和取证范围**:写明要区分的原因、现象、已知版本,以及获准读取的工作区、环境和证据入口。只读取证使用已确认无副作用的操作,需运行测试时核对授权与隔离范围。按[最小补证](verification.md#最小补证)选用能区分原因的样本、日志或测试。区分实际环境证据与本地复现,读取依赖仓的权限不等于该仓的修复权限。
185
+ - **修复条件和停止点**:明确本次仅诊断,或允许在哪个项目、工作区和范围内有据修复。已有修复授权、证据确认缺陷归属且满足项目契约要求时,由开发执行者最小修复并自验。证据不足、缺陷归属其他项目,或下一步需要另获数据修复、契约变更、环境或操作授权时,暂停受影响的动作,交已证实结论、最小补证或转交需求。
186
+ - **回传方式**:按本任务写明何时、向谁、经哪个获准入口回传或留存供收取。报告包含适用版本、结论与证据、实际修复和自验或未修原因,以及未结项、下一负责人和适用的复验条件。
187
+
188
+ ## 状态和回报
189
+
190
+ 区分待就绪、已派发待接单、执行中、本阶段完成,以及阻塞、中止和延期。按实际下一步区分“待验收”(候选已交付,按约定等待首次验收)、“待复验”(缺陷修复并自验后,等待验证者复核受影响项)和“待用户接受”(已到约定的用户业务或 UI 确认节点)。普通单任务自验满足通过条件后记为本阶段完成。单任务已交付而需求尚待验收时,分别记录两个层级的状态。每个未结项附下一动作和负责人。消息确认送达仅记为“已派发待接单”,看到接单确认或可核实的实际执行证据后才记为“执行中”。直接收到完成结果时,按证据及约定的下一步更新状态,无需补发接单回执。发送失败或送达不明时如实记录,不当作执行中,也不盲目重复派发;按读取兜底和检查点核查。无需为等待接单持续占用统筹当前轮次。
191
+
192
+ 新输入先按原始来源、指向的任务、目标及已授权范围判断属于原任务补充、仅供参考、超范围请求还是独立新任务,不仅凭话题相似或出现在同一聊天认定归属。原任务内补充由原负责人承接,已送达或已处理的同一事件不向同一接收者重复转发,也不据此重复派工;仅供参考的资料或其他会话消息不自动授予新权限。执行者遇到超出原范围或属于其他任务的请求,说明已知归属和缺项,沿已核实且获授权的回传链路交当前协调责任方判断路由,不自行扩做。嵌套执行者默认先报原执行者,再由其按授权转交统筹,不因需要路由取得越级消息权限;链路消息权限不足时沿用人工转交或读取兜底。协调责任方核查现有承接状态后再安排,避免双方重复派发。独立新任务可按既有类别、工作区及占用规则复用合适会话,不默认新建。归属不明只核对会改变承接判断的缺项,无依赖且已授权的工作继续;用户停止或等待确认的要求先遵守,不因等待路由继续受影响操作。
193
+
194
+ 待决事项沿用现有记录保留问题、受影响范围、决定责任人及未决状态,不另建固定表。仅在有权决定者作出可定位的有效决定或明确撤回,或已有证据证明该问题不再适用时关闭,记录依据及对后续任务的影响;部分答复只关闭已解决部分。普通进展、会话 idle、任务完成声明或工具审批状态不能代替决定,也不自动关闭待决事项。已有有效决定覆盖时直接沿用,不重复提问;新证据或后续决定使其失效时,只重列受影响内容。问题关闭不等于实施或验证通过,也不自动解除用户暂停点、扩大授权或恢复执行。
195
+
196
+ 最新决定影响在途任务时,识别受影响的任务、依赖、产物、用例和证据,更新任务基线及已授权自动化的相关提示;范围缩减同步撤销或改派旧执行、验收及准备职责。按已有消息授权同步,以执行者回报或可核实的实际执行证据确认采用新基线,不以送达代替采用,也不要求固定回执。未核实项记录待同步内容、负责人及实际执行状态,不视为旧操作已停,不按新基线验收旧版本;后续受影响执行须核实采用新基线,无依赖且已授权的工作继续。消息权限或工具不足时交人工转交包。
197
+
198
+ 收到有效的用户暂停或撤权决定后,统筹立即停止已明确受影响的操作安排及依赖这些操作的下游放行,独立且仍获授权的工作可以继续。沿已获准链路通知受影响的执行者。涉及再委派时,由原执行者沿已获准链路通知受影响的下属,并核查实际执行状态。
199
+
200
+ 涉及写入时,依据实际证据区分已确认停写、受限写入仍在进行和状态未知。通知送达或收到回执不能单独证明已停写。已发出的外部操作另行核查是否生效。通知失败、受限操作仍在进行、无法确认停写或外部操作的生效状态时,及时在当前聊天或已获准渠道向用户报告已知状态、可能影响和待处理缺口。停写未确认时,相关冲突写入和写入权移交保持待处理。中止进程等操作仍须有相应授权,恢复按适用的用户决定及现有复工条件核对。
201
+
202
+ 同一产物改派前,确认旧执行者及相关后台操作已停止写入,核对并保全现有未提交产物,再交接写入权;撤销消息送达不等于已停止。无法确认时保持待接管,新负责人仅只读核查,不启动冲突写入,独立且已授权的工作继续。核查要求不授予中止进程或其他额外操作权限。
203
+
204
+ 候选冻结后,影响该候选或与其有资源冲突的新增需求先排队;无依赖且无冲突的其他任务可继续安排。既有复验仍绑定原候选;若需立即改动,明确替代版本及失效证据范围,再安排复验。
205
+
206
+ 收件及执行者判断是否已回传时,按任务标识、版本、回报事件及实际结果核对回执归属,续跑时核对所属运行和覆盖范围,不要求固定字段格式。目标会话相同或旧运行成功不足以证明当前结果已送达或已处理;仅忽略相同事件和结果的重复回传,新运行的新结果及同版任务从阻塞到恢复、完成等状态推进应正常接收。过期版本及迟到旧事件保留来源,不覆盖当前有效状态,也不据此重复派修;无法判断事件先后时先核查,不直接回退状态。
207
+
208
+ 业务批准与工具审批状态分开记录。工具只返回等待审批时,报告可见状态和缺失详情,不猜原因;核对实际待批动作,不重复索取同一业务批准,继续无依赖的已授权工作。
209
+
210
+ 任务包分别说明向已核实回传对象回报的权限和自行向其他会话派发任务的权限,授权声明须能定位直接人类来源,不能代替实际工具许可。已有主动回传授权时,禁止自行派发任务不得写成笼统的“禁止向其他聊天发消息”,以免误禁回报;用户明确禁止回报时仍须遵守,并采用读取兜底。
211
+
212
+ 执行者在完成、中止、每个新的实质阻塞,以及影响任务衔接的阻塞解除或变化时,按事件回报一次:任务版本及状态、产物与实际证据、未做项及原因、保全情况、下一负责人和需决策事项。有统筹时,在已有回传授权内向本次已核实的回传对象回报。再委派任务按上述回传关系执行;负责人串联的阶段回报与终报按[已约定路线](direct-handoff.md#路线与收取)分流;用户亲自协调时,在当前聊天向用户交付。不在可复用材料中写死 ID;同一阻塞持续或重复等待不发同样回报,回执不触发回执。报告阻塞解除不代表用户暂停点已解除或新增操作已获授权。
213
+
214
+ 普通跨会话主动回传前,核对接收会话的状态和实际投递渠道。接收方忙碌或状态未知时,仅通过已证实会等当前轮次结束的渠道按授权投递。此时若渠道会即时投递、行为未知或不可用,保留报告和证据,记为“待发送(未发起)”,在约定检查点重查,或由统筹通过已授权的只读路径收取。确认同一报告已被收取时,按现有去重规则收口。需要立即处理的阻塞,沿任务包明确授权的紧急路径报告。
215
+
216
+ 按证据分别记录执行完成、回传送达、统筹收取处理、已向用户报告四种状态。任务已下发或结果仅保存在执行会话的 final,不能据此记为回传送达;送达不等于已唤醒或已收取,统筹收取也不等于用户已获知。部分结果不代表整项执行或验收完成,未收到缺陷也不等于通过。 子 Agent 的原生通知或最终结果实际返回到约定对象时,可作为该事件的回传证据,无需另发跨聊天消息。只有完成标记或没有实际结果时,仍记待收取。
217
+
218
+ 执行者结束本轮前,核对需要主动发送的约定回传事件及实际出站结果。使用约定的原生返回时,按上一段核对返回证据。负责人串联先按[发送与认领规则](direct-handoff.md#发送认领与恢复)核对发送权及恢复条件。其他主动回传满足上述投递条件,且有有效授权、工具可用、同一事件尚未发起、无实际送达或收取证据时,向已核实的回传对象发起一次。发起后核对可见结果,再交付终稿。尚未确认送达时,在自己的会话保留可查的交付摘要,注明任务和版本、完成或阻塞情况、产物及证据入口、未做项和发送状态。能确认没有出站调用时记“未发起”并注明已知原因;工具明确拒绝或确认未送达时记“发送失败”;调用结果或送达不明时记“送达未确认”。保留可核实的调用结果和已有原始错误,只有实际记录明确时才归因为审批拒绝。终稿、入站委派和其他事件的旧发送记录均不能代替本次出站证据。不为补报重跑业务动作、越权发送或反复重试。统筹按[回报收取与只读兜底](#超期未回报)收取,只向用户报告新发现、状态变化或需决策项;复工条件见验证引用。
219
+
220
+ 硬中断可能来不及回传,不能承诺 finally 一定执行。恢复先核查实际工具、进程、文件和外部动作状态,再决定续做或补报;不因缺少成功回执盲目重跑可能已生效的操作。工具失败只阻塞相关动作,继续独立且已授权的工作。
221
+
222
+ ### 局部沟通与统一收口
223
+
224
+ 按问题影响范围分流,提问前复用已确认决定及现有待决记录,不另设审批层:
225
+
226
+ - **局部沟通**:执行者可直接向用户解释自身产物、展示证据、回答追问;可直接澄清仅影响当前子任务,且不改变既定范围、职责、契约、依赖顺序、验收口径或暂停点的细节,无需先经统筹批准。局部问题的答复仍按已有职责和授权实施,不把交流本身当作新权限。
227
+ - **统一收口**:多个执行者共有的问题、跨任务依赖、总体方案和验收口径,以及创建或复用、派单、再委派、回传等授权缺口,默认由顶层统筹统一向用户提出。执行者沿已授权链路提供问题、依据、影响和待决定项;已由统筹收口的同一问题不分别重复询问。未设统筹或用户明确指定执行者处理时沿用已有例外,不为此新增统筹。
228
+ - **边界不明**:只核查会改变分流判断的最小信息;仍涉及整体协调或授权时交顶层统筹处理,仅暂停依赖该决定的操作,其余独立且已授权的工作继续。
229
+
230
+ 用户直接向执行者作出决定时,核实直接用户来源、适用任务、范围及与既有决定的覆盖关系,在现有记录保留依据;有效决定无需统筹重批,也不因问题原由统筹提出而再次询问。属于自身职责、授权且无依赖的部分可采用,不以等待同步为由阻塞。用户主动调整整体范围、优先级或授权时,执行者保留原文及影响,交统筹协调落实,不自行调动其他会话或扩大执行职责;依赖跨任务调整、其他授权或暂停解除的部分继续等待,已明确覆盖的授权不重复索取。普通答复或问题关闭不自动解除暂停,仍按适用的明确解除决定和复工条件核对。
231
+
232
+ 影响统筹基线、其他任务或约定出口的决定,沿已有获授权链路同步;嵌套执行者默认先报原执行者,再由其转交顶层统筹,不强制越级或双报。缺少消息权限或工具能力时保留待同步摘要,采用人工转交或已获授权的读取兜底,不为同步另发未授权消息。直接向用户交付不代替约定的结果回传及验收,采用与送达状态仍分别核实。接替时传递这些决定、待答问题及同步状态,避免丢失或重问。
233
+
234
+ 直接交流按实际渠道能力进行:在当前聊天正常交流沿用上述消息边界;子 Agent 没有直接用户交互能力时,通过原生返回或已有获授权链路转交偶发问题和结果。执行中发现需要持续多轮确认时,按[执行者选择](#组织方式与执行者选择)在已有授权内调整安排,保留已完成事项和待确认点;单次沟通不触发新建会话,也不产生其他消息权限。
235
+
236
+ ### 统筹的轮次出口与续接
237
+
238
+ 选择执行者及派发前,先匹配本次“下发后交还用户”或“持续跟进到约定阶段”的轮次出口;用户未明确要求持续跟进时默认交还,复用已有选择,不为常规派单重复询问。独立主会话和子 Agent 均核对实际工具语义或可定位运行证据:统筹结束本轮后执行是否存续、结果如何返回或保存、后续由谁通过何种入口和检查点收取。未知保持未知,不因类型、任务时长、已派发或“需要本轮收取”就推定依赖父轮次,也不保证某类执行者一定后台续跑。任务包须与已确认出口一致,不能由统筹自写“本轮等待”改变用户选择。
239
+
240
+ 采用交还出口时,执行可保全、任务已送达且没有可独立推进的统筹工作,就简要报告任务版本、负责人、等待项、实际回传或读取入口、下一检查触发及恢复步骤,然后结束当前轮次。没有自动唤醒能力时说明需要用户再次触发读取,不承诺自动推进;送达不等于执行或采用,收取后仍按约定核对证据。任务未完成、结果尚未收取、执行者仍运行或暂未收到接单回执,不单独构成等待整项结果、连续查询或反复播报进度的理由。结束本轮只交还交互,不取消执行者或宣告完成,也不解除暂停点。
241
+
242
+ 只有实际能力已证实依赖父轮次时,才在已有授权内采用工具支持的必要保全等待或续接,并明确具体技术动作、依据和结束条件;不将这一例外当作等待业务审查或整个任务完成的许可。保全若只能靠等整项任务完成,或其他安排会改变已确认出口,须说明限制及可行替代,取得用户对变更的明确决定,不能先派不匹配任务再要求用户接受持续等待。优先复用已有授权内且符合出口的执行者或续接方式;确实无可行路线时仅将受影响派发保持待安排,不自动创建独立主会话、再委派、发送消息或配置自动化,也不一律排除子 Agent。
243
+
244
+ 已经派发后发现能力或出口不匹配,先核查实际执行、产物、结果返回和后台操作状态,保留准确待收取及恢复摘要,继续按原任务及操作权限处理。不得为释放统筹而强迫执行者提前结束、停止追加原定检查或缩减交付,也不以未收到结果为由重派、重跑或擅自中止;确需暂停、改派或改变出口时仍按用户决定、实际工具能力及既有保全/交接规则处理。发现结果已返回时正常收取去重,不据此认定所有平台均可轮次结束后续跑。
245
+
246
+ 用户明确要求持续跟进时,统筹可等待并衔接到约定阶段,每次获得结果后判断变化及出口;无变化时使用工具支持的事件等待和退避,避免立即反复查询或重复播报,达到出口即交付,不自动扩到后续阶段。所有等待、续接和收取继续遵守原职责、授权、验收及暂停边界。
247
+
248
+ 在 Codex 中,独立主会话走已授权的主动回传时,在任务包写明目标会话和可用的 `send_message_to_thread` 入口;只读兜底可在授权内用 `read_thread` 查对应终稿和操作证据。子 Agent 沿用原生结果返回。使用 `wait_threads` 即时查状态时,显式设置 `timeoutMs: 0`。默认交还模式下,确需核查时取一次快照,随后按约定交还。省略超时参数或设置正值会进入等待,适用上文的阻塞等待条件。
249
+
250
+ 结束本轮前核实实际结果通知及自动续接能力,消息送达不等于自动唤醒统筹。获授权的自动化按已有恢复记录和停止条件续接;仅在用户授权后配置提醒或自动化。仅获只读周期检查授权时,使用可用的原生定时或通知机制,限定检查对象、范围、触发频率、变化通知及停止条件,无变化保持静默,到约定出口停止;不据此派工或重跑业务动作。机制不可用时如实说明,不用 sleep 循环或 shell 守护替代。
251
+
252
+ ### 插件的压缩续接
253
+
254
+ 仅在已安装本技能插件并按宿主要求启用 Hook、且当前任务已明确采用统筹时使用。统筹在首次写好可访问的协调记录后,使用宿主已确认的当前会话 ID、任务稳定 ID 和记录绝对路径登记。Codex 提供且能核实 `CODEX_THREAD_ID` 对应当前会话时可直接使用。任务 ID 使用字母、数字或 `_.:-`,以字母或数字开头。在途任务可于下一次续接时补登。沿用已确认的任务分工,不根据会话标题、工作区或是否拥有下属推断角色。
255
+
256
+ 从当前技能目录定位 `scripts/codex_compact.py` 并用 `python3` 执行。Claude Code 在子命令前加 `--host claude-code`,会话 ID 取技能入口由宿主提供的当前 ID。Codex 使用默认宿主参数。用 `register <会话ID> <任务ID> <协调记录绝对路径>` 登记或更新记录入口,用 `unregister <会话ID> <任务ID>` 撤销。统筹职责结束或接替生效时,在确认最新分工后撤销旧登记,由接手统筹登记自己的会话;暂时交还本轮但仍承担统筹的任务保留登记。只处理本次对应任务,其他角色及任务的分工按各自记录处理。
257
+
258
+ 登记只保存任务与记录入口。压缩后的提醒不能替代最新协调记录,也不产生写入、派单、重派或恢复权限。无法确认会话 ID、插件不可用或登记失败时,沿用主文件的记录与只读续接规则,不为补登记阻塞独立工作。
259
+
260
+ ### 已授权监控的核查与收口
261
+
262
+ **开工判断**:开工讨论协作方案时,统筹评估轮次出口和现有检查点是否足以发现实质偏差。短期低风险任务沿用常规检查点;长周期、多会话并行或涉及合入、部署等高影响操作,且常规检查点不足时,可在有授权和可用机制的前提下启用只读监控,优先复用已有安排。启用时,在开工记录约定监督负责人、检查对象和只读证据入口、不依赖统筹或执行者自报的检查点、谁在何时或何事件触发、用户通知授权与入口,以及阶段停止条件。可用获准的自动化触发,也可约定由用户或其他负责人到点唤起;只有结束后汇报的约定不足以触发检查。缺少授权或可用机制时,说明哪些监督无法触发,沿用原检查点。
263
+
264
+ **发现与纠正**:监督者在独立于受监督统筹会话的上下文中执行,只读检查统筹会话和约定证据;可复用合适的独立上下文。统筹自己的常规收取检查继续由统筹承担。监督者对照最新用户决定、协调记录和实际操作证据,检查统筹是否偏离确认的分工、执行顺序或验收条件。仅报告新偏差或实质变化,附任务及版本、违反的约定、证据位置、影响和建议动作;证据不足时列为待核。沿获准链路交当前唯一统筹。统筹忙碌且无法确认投递不会打断执行时,按约定入口留待收取;若偏差可能在收取前影响放行或造成冲突写入,按获准渠道报告用户。只读监控者不派单、不暂停执行、不写协调状态、不改产物。当前统筹核对最新决定、任务版本与证据,在已有授权内纠正并核实结果;需要新授权的动作保持待处理。
265
+
266
+ **统筹漏报时**:独立检查点触发后,监督者先核对当前任务及版本、谁是当前统筹,以及统筹是否完成约定的收取、处理和用户告知。执行者也未回传时,直接从获准的执行会话、产物和验证证据核对结果。确认统筹漏报时,沿已授权的用户入口直接通知一次,区分已证实结果、缺失证据、统筹未收取或未告知的事项,并按约定把待处理项交当前统筹。通知后核对实际结果。通知能力或授权不足时保留待通知摘要和缺口,供获准入口读取或人工转交;结果未知时记为送达未确认,沿原事件核查。监督通知不代替统筹核收、独立验收或放行。无新证据时仅标待核,迟到或重复报告沿用原事件去重。
267
+
268
+ 已获监控授权时,由统筹在现有协调记录中串联以下证据;已有决定覆盖的动作直接复用授权,不另建固定表、要求手工回执或为无监控任务增加出口条件。
269
+
270
+ - **配置核对**:先读取并复用适用的已有监控,核对实际目标、任务范围、频率、采用的技能/提示、通知与停止条件及权限;仅在已有授权内补齐或调整,避免重复创建。保留可定位的监控及配置结果;已创建或 ACTIVE 只证明配置状态,不代表已经运行或有效。
271
+ - **实际运行**:依据实际运行记录核对触发时间、本次检查对象及事件、读取来源、结果或原始错误,区分定时触发与手动检查,不用配置时间或计划时间冒充运行时间。启动检查按实际证据归类。仅核对配置时,记为配置核对。有可核实运行记录时,仅证明该次检查的执行及其结果。约定时点的定时运行须依据该次定时触发的实际运行记录核实。无实际运行证据记“运行待验证”,运行失败或状态未知如实记录;不能因未通知推定无变化,也不承诺故障期间必定唤醒或自报。每次成功检查后由统筹按既有去重和读取兜底规则收取结果,仅通知有意义变化。
272
+ - **协调状态更新**:本条适用于另有写授权的统筹续接流程。已有授权包含协调文件更新时,依据当前事件与实际证据更新对应任务状态、收取/处理情况、未做项、负责人及下一检查或恢复条件;写前读取最新记录,保留其他任务和后来的决定,写后核对实际落盘内容。定时检查与人工续接等运行可能并发写同一记录时,优先由已获授权的指定入口串行更新。工具支持基于记录版本的原子条件写入时,也可使用该机制。发生版本冲突时,重读最新记录,按当前任务及候选版本、决定和事件重新判断更新是否适用,再合并。迟到的旧版结果仅保留为对应版本的证据,不覆盖当前状态。当前运行无法安全串行写入且不具备原子条件写入时,保留待更新摘要,交指定入口补写。仅获只读检查授权时只报告待更新内容,不把检查权限推定为文件写权限。写入失败保留已读取结果、错误及待更新摘要,不能声称已更新,也不为补记录重复业务动作;没有新变化不机械重写。
273
+ - **停止确认**:达到监控所覆盖的约定阶段出口时,监控者结束该范围的检查,后续误触发时核实出口已达后直接结束。仍有启用的定时器或通知时,由有生命周期授权的负责人仅停用对应监控,用工具返回的实际状态或后续读取确认停止,保留最终收取结果和延期事项;不能以任务 idle、发出停用调用或口头结论代替确认。停止失败或状态未知时记录原错、待处理项及恢复方式,报告“停止未确认”,不盲目重试、不影响其他监控,也不回退已证明的阶段结论。缺少生命周期授权只阻塞该停止动作,不重复索取已覆盖的授权。
274
+
275
+ ### 交付节点与偏差预警
276
+
277
+ 用户已有明确交付节点或日期时,在现有任务记录中关联前置依赖、负责人、实际进度及剩余实施和验证工作;预计回报时间或检查点不等于交付承诺。核查进展、调整任务顺序或依赖发生变化时,同时评估是否影响该节点及下游,不等到超期或实质阻塞才判断交付风险。
278
+
279
+ 根据可核实的进展预计无法达到约定节点或日期时,及时向用户报告依据、受影响任务和后续节点、可选处理方式及建议,注明不确定性和需要决策的事项;不擅自缩减范围、降低质量、跳过验收或修改交期,也不因进度压力解除用户暂停点。只报告新风险或影响变化,不重复播报同一风险。用户未给定交付节点或日期时,沿用阶段出口和检查点,不强制编造排期或精确完成时间。
280
+
281
+ ### 超期未回报
282
+
283
+ 下发前落实收取安排:在任务包中写明执行会话及适用的回传对象、约定回传事件、可定位的授权来源、实际返回能力、预计回报时间或阶段检查点、检查触发者、触发方式、只读核查负责人、已获准且可用的查询方式和入口,以及停止条件(默认收齐约定结果,已有明确决定时沿用)。可取得会话标识时关联到本次任务及版本,供检查点定位。同一任务追加返修时沿用原收取记录,补记本次版本、回传事件和适用检查点,保留旧结果的收取状态。检查点只用于核查和收取,不设统一时限或自动中止;触发方式须独立于执行者的回报,预计回报时间或“完成后回传”不构成检查安排。已获授权且机制可用时按约定定时或通知触发;无法自动触发时,明确由谁在何时手动唤起统筹、先查什么,并告知用户实际安排。只有回传能力但无可靠收取路径时,先落实获准的只读查询或人工转交;缺口仅影响依赖该路径的下发。复用有效授权,遵守原轮次出口。
284
+
285
+ 到约定检查点且统筹已被唤起时,实际核对本次回传是否送达、结果是否已收取处理、结论是否已向用户报告。本轮已触发的检查点须完成获准核查或报告实际缺口后再结束。若尚未收取,且已到检查点或统筹运行时发现发送未确认或执行已结束,先用已知会话标识在获准范围内取得只读状态快照,再按需读取本任务的 final、阻塞信息、产物及证据。核对任务、版本、事件及实际结果后按原验收条件收取;已处理的同一事件与结果只收取一次,迟到的主动回传沿用同一去重规则。已收取但尚未报告的结论,在当前用户交互或已有获准的通知渠道补报,不重复收取。completed/idle 仅是会话或轮次状态,未回报不能直接判定为阻塞、失败或未执行:
286
+
287
+ - 仍有实质进展:记录进展,调整下一检查点;存在已约定交付节点或日期时,同时按上述规则评估偏差及下游影响,不以持续进展或后移检查点掩盖风险。
288
+ - 已完成但未回报:按实际证据收取,分别记录收取和验收状态,向用户报告已证明范围及未结项。
289
+ - 已实质阻塞:明确原因、下一动作和负责人,在已有授权内处理。
290
+ - 状态不明或入口不可用:优先用获准的只读或人工转交路径补齐;已有消息授权时可针对实际缺项询问一次,否则报告缺口。
291
+
292
+ 达到约定停止条件后,结束本任务的收取检查;停用已配置的监控另按[停止确认](#已授权监控的核查与收口)核对授权和实际状态。仍有缺项时记录待确认事项、负责人及下一检查条件,向用户报告,不重复催报、派单、重跑或中止执行者。不为只读兜底延长“下发后交还”的轮次或持续轮询。
@@ -0,0 +1,17 @@
1
+ # 同任务直接交接
2
+
3
+ 有唯一统筹且项目或任务已明确采用负责人串联时使用。统筹首派给任务负责人,已指定的角色按授权在同一任务内交接。范围或权限变化、改派、跨任务资源冲突、业务裁决及无法自行解决的实质阻塞交统筹。新增子任务或执行者按[再委派](coordination.md#执行者再委派)核对权限。单任务自验、专项独立验证及需求级独立验收仍按[验收与证据](verification.md#验收与证据)触发。
4
+
5
+ ## 路线与收取
6
+
7
+ - 首派时复用现有任务包,记录或引用每段发送方、接收方、发送与开工条件、允许的消息与动作、退回对象、所需资源和终报节点,保留可定位的用户授权来源。每段独立核对消息与动作权限、执行存续及回传能力。任务包只记差异和实际缺项。路线或资源暂不可用时,只挂起依赖该段的动作,由统筹协调或按约定人工转交。获准的人工转交按下节核对发送与恢复条件后可启动原交接。
8
+ - 例如,开发完成自验并满足本次独立验收的准入条件后,将固定候选、基线和证据交给已指定的 QA。QA 按路线把缺陷退回原开发,开发自验后将修订候选和原问题交 QA 复验。阶段结果按路线回请求方,任务负责人在约定终点或发生需上收的实质阻塞时回报统筹。
9
+ - 审查者与 QA 各自记录结论、适用候选和证据。任务负责人维护执行记录,引用原结论并更新当前阶段、候选、下一动作和责任人。统筹维护跨任务安排及最终收取状态,按通过条件核收。记录写入沿用[授权与并发规则](coordination.md#已授权监控的核查与收口)。首派明确终报入口、触发者、检查点和读取兜底,沿用[轮次出口](coordination.md#统筹的轮次出口与续接)及[收取规则](coordination.md#超期未回报)。
10
+
11
+ ## 发送、认领与恢复
12
+
13
+ - 发送前从权威记录核对当前路线、双方职责、有效任务版本、候选、发送条件、暂停点和权限。先按任务及版本、阶段、候选、动作、接收方和可定位的本次触发事件,在权威记录中查找或登记唯一交接。各运行引用同一业务触发事件,检查轮次和发送重试沿用该事件。由指定入口串行登记,或由工具按这些信息原子创建唯一记录。各运行沿用该记录的标识,之后由串行入口或原子条件写入认领发送权。无法保证唯一登记或发送认领时,保留待处理摘要交指定入口。恢复和人工转交复用原记录。同一候选确需再次复验时,凭新的获准触发事件另建交接并关联原记录。发送认领、实际出站、送达和接手分别记证据。已送达仍待接手,取得接手证据后更新执行状态。
14
+ - 交接发送和开工前按[任务排序与会话占用](coordination.md#任务排序与会话占用)重新核对接收会话。忙碌或状态未知时,在任务记录中按现有顺序排队。只有核实投递渠道只入队且不会打断当前执行时,才可按授权投递排队项。会触发执行或行为未知的渠道,等确认接收方可接手且轮到该交接后再发。已投递的排队项沿原交接收取,接收方空闲后按队列接手。仅排队不记为已送达,送达不记为已接手。
15
+ - 发送失败、结果未知或认领后中断时,先核实际出站与接手证据。确认未发出,或已发出但确认未送达、未接手且不会迟到生效,再核实旧运行不会续发、原授权和发送条件仍有效,才继续原交接。结果仍未知时标为待核查,沿获准的读取或人工路径核查。送达未知时的人工转交沿用原交接标识和待核状态,仅供核查,接收方关联已有接手记录。改派前确认原接收方未接手且旧路线已失效,或已停止受影响操作并按[接替规则](handoff.md#执行会话接替流程)移交。不能确认时挂起依赖动作。
16
+ - 接收方在接手及执行关键动作前核对权威记录中的当前路线、双方职责、任务版本、候选、暂停点、授权、适用的开工条件、资源占用及同一交接的接手记录。同一交接只接手一次。可能并发接手时,沿用串行入口或原子条件写入认领接手,无法确认唯一接手时先核查。重复交接关联原记录。接手后中断按原接手记录核对在途动作和实际结果再续接。共享资源按[工作区规则](coordination.md#执行会话的工作区定位与操作范围)确认实际交回并核对加载版本。条件不符或无法核实时,只暂缓受影响的动作,保留已获证据并报告恢复条件。
17
+ - 工具支持在动作生效时校验受影响的路线、职责、版本、暂停、授权或占用条件时,使用该能力。仅对协调记录的原子写入不足以校验外部动作。条件校验无法覆盖时,发现路线变更、暂停、换版或占用冲突后,将可能已发出的受影响动作记为待核实,查清实际生效和停写状态,再决定续做、移交或放行。迟到的旧候选或已失效交接结果关联原版本与原交接,按[状态和回报](coordination.md#状态和回报)收取,不推进当前候选或验收状态。
@@ -0,0 +1,59 @@
1
+ # 接管与退出
2
+
3
+ 仅在评估或执行会话接替、接管、归档时读取,同时按 [协作与交接](coordination.md) 核对职责、状态、授权和轮次出口;普通协作不必加载本引用。子 Agent 与独立主会话均适用职责、来源核验、产物保全和唯一写入权要求;绑定、读取历史、通知、恢复及归档按各自工具能力适用,不要求子 Agent 具备独立聊天生命周期。工具无归档能力时,核实停止相关写入、保全产物和证据并记录交接及退出状态即可,不虚报已归档;需要主动关闭或中止时仍核对操作授权,不以缺少归档功能代替停写确认。
4
+
5
+ 以精简接管包承接长上下文:源会话/消息和继承链、最新决定覆盖关系、当前产物与有效证据、授权及限制、未结项/负责人/停止点、工作区/分支/HEAD/未提交状态、恢复步骤。包括执行者与用户直接交流形成的有效决定及来源、待答问题和实际同步状态;接替后沿用已核实决定及问题归属,不因换人重问或要求统筹重批,未送达或未采用的内容仍保留待同步。采用负责人串联时,接管包按[直接交接规则](direct-handoff.md)引用实际任务路线和执行记录,包括在途交接的实际证据、当前负责人、下一接手方、待核动作和终报收取入口。接替按现有切换规则核对这些信息。只读关键来源和受影响片段,摘要是索引而非授权原文的替代品。接管或迁移时,分别核对目录、Git 登记、分支与未提交状态、可用附件,并核对实际工作区、采用的绑定或显式目录定位方式及操作范围;缺附件不等于代码丢失,路径迁移不等于聊天已同步。
6
+
7
+ 接管包中的技能版本须有可读取的正文、快照或可取回的提交;路径和内容指纹仅用于定位与识别,不能代替版本内容。旧路径已被覆盖时,先核对是否有可读取旧版本或用户更新的有效决定;用户已明确采用可访问新版时,依据新版及可核实的旧记录评估对职责、授权、在途任务及验证的影响,更新接管基线并同步受影响执行者,再按该版核验,无需找回已被该决定替代的旧版全文。无法核实的旧内容保留未知,不编造差异;影响接替判断的实质缺项仍须闭合。不得自行改用未确认版本;无法核对时保留缺项及恢复条件,仅阻塞依赖该缺项的接替或工作。
8
+
9
+ ### 统筹接替流程
10
+
11
+ 出现遗漏最新决定、混淆任务版本或负责人、反复重读相同材料且影响协调等具体迹象时,统筹主动提出接替建议,说明观察到的问题;不以聊天长度或一次正常上下文压缩直接触发切换。为清理上下文,优先建议新建精简会话,保留可核实来源;用户明确选择 fork 时尊重选择,并说明会携带旧历史。
12
+
13
+ 创建接替会话、发送切换通知、变更回传对象和归档分别核对直接人类授权及来源,复用已有明确授权;技能规则、另一聊天的请求或接管包摘要本身不授予这些权限。工具或权限不足时交付人工接管包,只报告实际完成的步骤,不声称已切换。
14
+
15
+ 1. **准备**:旧统筹整理上述精简接管包,补充本技能及所需引用的当前已确认版本和可访问入口(可用提交或内容指纹定位)、当前唯一统筹、拟接替对象、在途任务版本及执行者、已处理和未送达回报、相关检查点及续接方式。准备期间的新决定和回报继续由旧统筹处理,并保留增量,避免新统筹只接到过期快照。
16
+ 2. **只读核验**:获授权后创建新统筹,任务包明确其暂不调度、不派业务任务。每一任新统筹必须读取并采用接管包所指已确认版本的本技能及所需引用,核对分工、授权和接替规则;技能不可访问或版本无法确认时列为实质缺项,不切换。接替后继续按本规则评估上下文退化,并在下一次接替任务包中传递同样的技能加载及后续传递要求,不因首次接替完成而失效。新统筹核验关键来源、最新决定、授权、任务状态和工作区,报告“可接管”或实质缺项。确认及切换前仍由旧统筹唯一负责;核验失败或新会话不可用时不切换,保留缺项和恢复条件。旧统筹无法参与时,按下述故障恢复规则处理,不由候选自行接权。
17
+ 3. **明确切换点**:新统筹确认可接管后,旧统筹短暂停止新的业务派发,将准备期间增量补交,新统筹核对后,在双方可定位的现有权威记录中明确接替对象及生效的切换点。切换前旧统筹负责;切换生效后仅新统筹负责调度,旧统筹退出调度。新统筹核实切换已生效才开始派发;未能确认记录成功时保持待切换,先核查实际状态,不让双方同时调度,也不因缺少回执重复切换。
18
+
19
+ 正常切换前,在现有接管记录中核对下一检查点、在用定时检查和续接触发器的实际目标及状态、触发者和获准的读取入口,并确认关键回报在接替后有可行的收取路径。原触发器无法沿用时,明确由谁在何时唤起新统筹、先读哪个已核实可用的入口。关键回报仍无可行路径时,按现有接管规则列为实质缺项。旧统筹无法参与时,按故障恢复规则由用户指定新统筹及生效点,缺失路径仅阻塞依赖它的收取和后续衔接。接替沿用原检查点,切换期间已到期且未核查的事项交新统筹接续。
20
+
21
+ 切换生效后,新统筹核实触发器的实际状态。变更或停用须分别核对授权和操作结果,无法确认时记录旧触发器仍可能运行及其影响。定时检查或续接运行在调度、管理验收或写入当前协调状态前,须核实切换状态、当前唯一统筹及操作权限,无法核实时暂停这些动作。切换前已启动的运行同样适用。旧统筹仅延续获准的收件保全职责。对切换前已发出或可能生效的操作,新统筹先核查实际结果。结果未核实时,仅暂缓可能与旧操作冲突的写入或重试,以及依赖该结果的放行。独立且已获授权的工作继续。记录未知操作、受影响范围和恢复条件,待实际结果查明并处理,或核实相关后续动作与其无冲突后,再按原授权和暂停条件处理。故障接管同样适用。按现有规则去重,并分别记录收取路径缺口和待收取结果。
22
+
23
+ 4. **更新回传**:按授权通知在用执行者当前唯一统筹及回传对象,仅更新协调关系,不重派、不打断执行中任务,不重置任务版本、业务授权或检查点。停止写入确认仅在产物执行负责人也发生变更时适用,不因统筹接替要求执行者停工。
24
+
25
+ **授权复用与路径**:原授权不因统筹接替自动失效,主体、对象、事件及有效边界仍被覆盖的部分继续复用,不重复索权。固定向旧统筹C发送的授权不自动覆盖向新统筹D发送,也不自动将C安排为接替后的收件中转;新路径尚未明确时,保留待送的新结果,由D通过已有获授权的读取或人工转交收取,不按旧对象授权自行持续向C发送新结果,不重跑业务动作。切换前已发送或切换期间迟到的在途回报仍按下一步保全和收取。
26
+
27
+ **旧统筹收件中转**:已有可核实的直接用户决定明确覆盖接替后继续向C收件、C的接收保全职责,以及D收取后续新增结果的方式和相应权限时,直接沿用该路径,无需重问或强制改成直报D。仅允许读取旧历史,不能推定允许读取切换后新增结果;C主动转发给D仍须相应消息授权。C仅承担获准的收件保全职责,不恢复调度或验收管理,也不因此获得持续监控、自动化或其他生命周期权限。工具不支持时保留摘要并采用已获准的可行兜底,不虚报送达或收取。
28
+
29
+ **缺口收口**:切换生效后,由当前唯一顶层统筹D核查并选择可行回传路径,只补缺失的路径安排、对象变更、通知、转发或读取权限,不重复索取已覆盖授权,执行者不分别索权;明确决定选择中转后,原F→C发送授权仍有效且覆盖该路径的部分直接复用,不要求重新批准。无消息权限时保留待送或待授权摘要,采用人工转交或已获授权读取兜底。缺口仅阻塞相关回传及依赖它的衔接,其余独立且已授权工作继续;原职责、独立复验、用户接受、唯一写入权和暂停点不因路径变化而改变。
30
+
31
+ 5. **失败与在途回报**:切换后的通知未送达或执行者尚未确认时,记录受影响对象,由新统筹在已有读取授权及其实际覆盖范围内读取旧会话和执行会话历史兜底;旧统筹不恢复业务派发。切换期间完成、阻塞或迟到的回报保留原任务版本、证据及已处理状态,由当前唯一统筹按既有去重规则收取,已验收结果不重复验收,待验收结果不当作已通过。缺少读取或消息能力时报告受影响的协调阻塞,保留待送达事项,不擅自恢复双统筹。
32
+ 6. **退出**:新统筹确认已承接在途任务及回报,必要通知已送达,或失败通知已明确且新统筹核实可用的读取兜底,随后完成产物与工作树保全核对。统筹切换生效后,旧统筹退出调度。归档另行核验。即使已有归档授权,也须先确认执行存续、收件中转和结果收取对旧会话的依赖均已结束,或已有获准且核实可用的替代路径。归档核验须覆盖仍依赖旧会话的定时检查和续接触发器,包括关键回报的唤醒或收取路径,以及可能影响协调状态或证据保全的在途操作。上述依赖或影响仍未解决,或相关状态无法核实时,保留旧会话可访问,由当前唯一统筹处理缺口。已有获准且核实可用的替代路径,且旧触发器没有未解决的相关影响时,可按其他既有条件判断归档。触发器变更、停用和归档分别核对授权及实际结果。旧会话继续承担已获准的收件保全职责,原验收分工和暂停点继续有效。满足归档条件后,再按授权归档旧会话。兜底不可用或尚有指导职责时保留旧会话可访问,不为清理上下文提前归档。待送达事项保留在接管记录中,不重复成功回报。
33
+
34
+ ### 旧统筹无法参与时
35
+
36
+ 旧统筹不可访问或无法参与交接时,候选不得自行接权;由用户明确指定唯一新统筹及生效点,替代正常流程中依赖旧统筹确认和移交的环节。新统筹依据用户决定及已授权可读的记录、执行会话和现场核验基线、在途任务与实际状态;缺失接管包不要求旧统筹补交,缺失内容列待核项。未知状态仍记未知,不盲目重派、重跑或推定后台操作已停止;仅阻塞依赖缺失信息的任务。
37
+
38
+ 用户指定及生效点须可定位,新统筹核实后按已确认范围调度;通知、回传和归档仍按正常流程及各自授权处理,指定接替不授权额外创建会话、停进程或其他写操作。原授权与暂停点继续有效;旧统筹恢复后不得自行恢复调度,应向当前唯一统筹交付未同步增量。
39
+
40
+ ### 执行会话接替流程
41
+
42
+ 执行会话出现遗漏要求、混淆版本、重复工作等影响执行的上下文退化迹象时,执行者沿已核实且获授权的回传链路报告,嵌套执行者默认先报原执行者,由其按授权转交当前统筹,或由统筹发现后提出接替;未设统筹时向用户报告。缺少直报统筹权限时不越级,链路不可用时沿用人工接管包或读取兜底。不单凭聊天长度轮换,也不先归档旧执行会话。创建接替会话、发送通知和归档仍分别核对直接人类授权;缺少权限或工具时交付人工任务包,不自行创建、迁移会话或扩大操作范围。
43
+
44
+ 接管包同时传递执行者专业类别、任务涉及的项目及实际工作区、执行者类型、实际工作区定位方式及核验结果、默认目录与工具限制、主写项目及工作区/分支、产物归属,以及跨项目例外的用户授权来源、适用任务和有效边界。新执行者在同一任务中核验后延续有效例外,不重复索权;既有工作区及显式目录路线的适用授权可复用,但须重新核实当前目录、Git及现场状态,不因默认 cwd 不同要求迁移,也不把单次用户例外扩展到其他任务或会话;新增项目、职责或任务超出原范围时重新核对授权,不因接替扩大写入范围。后续每任接替继续传递这些边界,原暂停点和禁止动作仍有效。文档接替还须传递目标文档及可编辑范围、权威来源、最新正文版本、适用的操作前快照、已确认意见和待确认事项、唯一编辑者与专业内容负责人,以及未同步的用户修改和执行增量。新执行者核对最新正文,不以旧摘要覆盖后来的修改;仍按下述停写确认及唯一写入权流程接替,专业内容确认责任不随编辑者更换自动转移。
45
+
46
+ 1. **保全现场**:复用精简接管包,明确任务版本、实际工作区/分支/HEAD、未提交及未跟踪产物、已有验证证据、当前进度、后台操作和未送达回报。分别记录未提交改动所在的工作区、分支及 HEAD,以及获准继续实施的目标工作区和分支、适用的归并安排及决定来源。两者不一致时,按[工作区定位](coordination.md#执行会话的工作区定位与操作范围)保全现场并核对搬移或继续实施所需的授权。移交产物和写入责任沿用已确认的分支安排。保留最新用户要求及其来源,尤其是暂停节点、禁止动作及恢复条件;不把未完成工作或待验收结果写成已完成。
47
+ 2. **只读核验**:获授权后,新执行会话先读取已确认版本的本技能、任务适用技能及目标项目规则,核对任务、产物、证据和上述限制,并按协作引用核验工作区:独立主会话与子 Agent 均核对目标实际工作区、已采用的绑定或显式目录定位方式、Git状态、适用规则、读写范围及相关运行入口;跨项目任务分别核对各目标路径。默认目录不同本身不构成接替阻塞;依赖默认目标且不能正确选址的工具只限制相关操作,不自动创建、绑定或迁移聊天/工作树。核验不符按既有权限处理,未解决前不接管相关执行;暂不修改产物。缺少关键来源、技能或现场状态时报告实质缺项,保留原负责人,不自动接权。
48
+ 3. **移交写入权**:确认旧执行者及相关后台操作已停止对交接产物写入,核对并补交最终增量、保全未提交产物后,由统筹(未设统筹时由用户)明确唯一新执行负责人及生效切换点,新执行者核实后才可继续写入。无法确认停写或切换生效时,新执行者仅只读核查,相关写任务保持待接管;独立且已授权的工作继续。此要求不授予杀进程、启停服务等额外权限。
49
+ 4. **延续任务**:沿用原任务范围、有效版本、用户要求、授权限制、检查点及已核实的回传对象,不重复下发同一任务或从头重跑。已到用户暂停节点时保持暂停,不因换人恢复;可能已经生效的外部操作先核对实际状态。切换期间完成或迟到的回报保留证据和已处理状态,由当前统筹(未设统筹时由用户)按既有规则收取,不重复派修或验收。
50
+ 5. **确认后退出**:新执行者确认接管后,统筹(未设统筹时由用户)核对产物保全、关联工作树清理及恢复影响,确认旧执行者无剩余执行或指导职责,再按工具能力和已有授权归档或记录退出。核验失败、停写无法确认或保全不足时保留旧会话可访问;旧执行者不可用也不构成其后台操作已停止的证据。
51
+ 6. **后续接替**:每任新执行者继续适用本流程,在再次交接时传递相同的技能加载、用户边界和停写确认要求;不能将接替当作新建分支或worktree的授权。
52
+
53
+ 未完成的接替步骤按既有轮次出口报告当前唯一负责人、缺项、下一动作及恢复条件;等待授权或核验不默认占用当前轮次,也不自行创建自动化。
54
+
55
+ 归档按最新已确认的阶段范围和职责判断,阶段退出不以创建接替会话或指定后继执行者为前提。当前阶段仍需闭合的执行、复验、用户接受或指导职责,不能仅因 idle 或等待而视为完成;已明确延期、可独立重新安排的后续阶段,以及未来可能返修、复审的职责,不要求原会话常驻。
56
+
57
+ 达到约定出口后,将后续未执行事项、有效证据、下一负责人或待安排状态、依赖及恢复条件保留在现有协调记录中,按工具能力及已有授权归档或记录退出;退出不表示项目全部完成、延期项通过或暂停解除。后来新增的独立任务不反向否定原阶段出口,也不默认由待归档会话承接。
58
+
59
+ 归档前核对关联工作树类型、清理机制和恢复范围,保全仍需保留的产物及本地文件。Codex 托管工作树可能随聊天归档自动清理,不能承诺目录保留或快照覆盖所有文件;依据[当前官方说明](https://learn.chatgpt.com/docs/environments/git-worktrees)及实际工具核实,不由归档授权推定额外清理权限。拆开的制作、技术复验和用户接受职责分别保留状态,不能以制作交付推定全部完成。
@@ -0,0 +1,58 @@
1
+ # 验证与阶段出口
2
+
3
+ 用于专项取证、Mock、环境受限、提前独立验证、需求级测试、多方验收或切换发布。普通小改不必建立额外阶段。
4
+
5
+ ## 最小补证
6
+
7
+ 补充取证前,在现有记录中明确待证明结论、已有证据的具体不足及受影响范围,选择能区分实际行为的最小补证。优先复用已核源码、契约、样本和有效验证;索取完整镜像、构建归档或配置前说明其必要性及为何现有资料不足。局部缺证仅阻塞依赖该证据的结论和操作,其余可证明且已授权的工作继续,不把局部补资料升级为整项任务的门槛。
8
+
9
+ 阶段结论写清:已证明范围、当前版本和证据、未闭合项及负责人、下一动作与准入条件。idle、turn 结束、代码交付或方案高分均不等于业务完成。若使用评分,只评价约定维度的方案成熟度;阻断未关闭不能靠总分放行,更不能据此声称软件正确。
10
+
11
+ ## 环境受限时
12
+
13
+ 分出本地/隔离可证明范围与需真实环境范围,分别给出通过条件;环境可用且获授权时正常验证,无需人为分两阶段。环境项延期附负责人、依赖和复工条件。涉及真机手势、跨账号交互或工具能力存疑时,正式验证前按需执行获准、无业务写入的最小检查,确认设备、账号角色、样本或操作工具能取得所需证据。能力不足时只挂起依赖它的断言,其他可验项继续。预检按实际覆盖记录。
14
+
15
+ Mock 和单测不能证明真实连通、鉴权链、配置生效、缓存/数据域或真实并发;Mock 浏览器实测仅证明已观察的 UI 和交互。前端 Mock、后端契约及适配层分别绑定所测版本,核对生产者和消费者样例;优先现有 schema、样例与测试工具,不新造框架。
16
+
17
+ ## Mock 写入先证实隔离
18
+
19
+ 运行可能写入的场景前,确认请求清单、目标、拦截范围、内存/本地消费者、未覆盖请求和导航。用可核实证据确认写动作被安全替身消费;未知动作、注入失败和配置错误应失败关闭,不能回落真实写接口。无法确认隔离时停止相关场景并报告,不靠“应该被拦截”继续。
20
+
21
+ 壳层请求和跳转到真实页面单列边界;不要为验收越过已隔离区域。复用现有注入失败、延迟、乱序能力,缺失能力先明确修正范围和授权。检查请求目标、拦截结果、本地状态变化及相关失败路径,不以 Mock 文件存在代替运行证据。
22
+
23
+ 确认实际加载版本及影响范围的未提交差异;不能仅凭 HEAD 推定运行的是当前源码,也不要为证据强迫提交。未确认版本的结论保留待补。启停服务由本次授权指定的人执行。Mock 交付附启用/退出方式、场景入口及影响复现的客户端状态(如 Cookie),并注明上述覆盖边界。
24
+
25
+ ## 验收与证据
26
+
27
+ 协作验收沿用项目已有记录并明确维护人。开发自验、专项独立验证、需求级独立验收和约定的用户业务/UI 接受分别核对,不以用户重测替代技术验证。
28
+
29
+ 技术审查依据项目规则判断方案或代码风险。固定候选时按最终差异复核原审查范围,影响变化时只补受影响的审查,记录审查结论及适用候选。独立验收按实际行为和需求基线给出结论,另行记录。
30
+
31
+ 验证按目的和责任划分,不按浏览器、接口等工具划分:
32
+
33
+ - 单个开发任务由开发者按改动范围自验,满足任务通过条件后交付候选版本、验证结果和未测项。有统筹时,由统筹核对证据及通过条件。前端包括浏览器中的展示、交互、请求及与设计稿对比;后端包括接口输入输出、错误处理及改动涉及的鉴权、归属和写入语义。按产物类型和风险选择验证方式;需浏览器实测或真实集成才能证明的行为,不能仅凭编译、静态检查或单测宣称通过。未测项说明原因及后续负责人。
34
+ - 满足项目约定的提测条件并进入需求级测试后,由未参与相关实现的验证者在独立上下文中验收,可复用合适的独立主会话或子 Agent。交接可定位的原始需求、设计或契约、已确认变更、候选版本和实际入口。验证者先据此确定预期,再参考开发自验报告,按风险验证关键业务路径、边界、真实集成和关联回归。开发仍承担自验。缺少验证者或派单授权时,保留自验及已完成的单任务交付,需求级验收记为待安排。
35
+ - 提前独立验证沿用用户、项目规则或已确认任务包中的明确要求。其他情况,只有能指出必须在需求级测试前作出的决定,以及需要独立判断的具体理由,才提出专项验证。普通覆盖缺口优先由开发补测。沿用已有授权安排,新增放行条件由用户或项目既定负责人确认。由未参与相关产物制作的验证者执行,复用任务包记录依据、范围、负责人和所影响的节点。缺少验证者或授权时,记录自验结果及专项待验证状态,仅暂缓已明确依赖该结论的动作。专项验证属于任务通过条件时,记录开发自验完成,任务待专项验证。
36
+ - 同一候选版本复用仍有效且可访问的证据。版本变化后核对原场景、入口及结论是否仍适用,保留仍适用的证据,只补受影响的验证。保留关键路径、争议项和证据缺口所需的独立实测。专项结论只覆盖该专项,需求级验收仍按完整需求范围给出结论。
37
+
38
+ 每项验收点至少关联:基线来源、场景及可判断预期、执行者/版本、证据类型和实际结果、缺陷或延期及负责人。基线明确时,验证者独立判断实现是否符合。基线含糊或冲突时,记录分歧、影响和待确认项,由用户或项目既定负责人确认预期,再据此验证。预期明确的其他验收项可继续。
39
+
40
+ 证据区分静态推断、隔离自动测试、真实浏览器/交互实测、真实集成、用户确认及未测。同一业务验收点可标部分验证,注明已证明和未证明部分;局部用例通过不能自动关闭整条。记录实际执行范围和结果,不合并不同版本或重复范围的历史测试数字。
41
+
42
+ 决定性证据绑定工作区、加载产物、契约/Mock/场景版本、时间、预期和实际结果,以及 UI 所需 URL/浏览器;适用时以分支/HEAD及相关未提交差异指纹区分本地候选与已提交/推送版本,不能只凭远端 SHA 代表本地交付。敏感信息脱敏。
43
+
44
+ 出口前核对证据可访问,将必要结论、失败/复验和截图保存在约定持久位置或可核实附件。临时目录只是暂存,不承诺长期可用;证据丢失仅补影响判断的范围。
45
+
46
+ 缺陷优先回原负责人,否则明确接手人;修复后开发先自验,验证者按影响复验,标明旧证据失效范围及复验关系,仅补受影响证据,不默认重跑全部历史用例。区分新增缺陷、回归、旧已知问题、公共问题和待核项;豁免列范围、理由和批准人,不能算新实现通过。公共问题按所有权另列,不擅自扩修。
47
+
48
+ 离线阶段按本阶段约定的覆盖与接受条件收口,隔离和证据须有效,阻断关闭,其他问题有处置,延期项有责任人与复工条件。写明“离线范围完成,集成未完成”,不以阶段完成代替整项目完成。
49
+
50
+ ## Mock 清理和真实环境准入
51
+
52
+ 满足约定的验收条件后,将本次临时 Mock 接入、注入或绕行机制的退出清理列为明确任务,先保全可恢复基线;长期回归所需的 Mock、场景和夹具按用途保留。获授权的本地清理与隔离回归可先做;移除 Mock 不授权真实写入,没有安全替身的写场景停止。真实旧接口回归、新接口接入和入口切换按环境准入执行。
53
+
54
+ 等待结束或离线通过不构成自动复工许可。复工前核对环境可用及适用的暂停解除、具体操作授权、验证/发布责任人、目标代码和配置版本、生效机制、入口/流量状态、回归范围和豁免、恢复核对、观察窗口/指标及最终结项条件。未知项列待定,不能用旧环境记录冒充当前就绪。
55
+
56
+ 配置内容吻合、实例已加载和真实连通分别取证;步骤依项目和平台确定,不硬编码技术栈或发布顺序。真实写测试事先说明目标、动作、影响、数据范围、快照及恢复/核对责任,获所需授权再执行。
57
+
58
+ 切换前验证可恢复的“代码+配置+入口”组合,明确负责人、触发条件、顺序和观察;只写“可回滚”不足。保留并核对上线期间合法新写入,不默认用旧快照覆盖。恢复数据也按写入授权执行。满足约定观察和结项条件后才报告最终完成;旧路径下线另行决策。