@givolt/i3-composer-agent 3.1.0 → 4.0.0

package/skills/i3-enterprise-sop/references/readme.md

@@ -1,167 +0,0 @@
-# 企业 SOP 四阶段资料入口
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-资源组合版本：0.17.1；指引版本：v0.17.1。资料统一随本次实际加载的SOP Skill分发，唯一资料根为该Skill的 `references/`。包含四阶段文档资料、公共技术规约及工程骨架目录规范1.0.0；可选企业应用技术规约为v0.0.4。模板、实际规约、目录规范和i3软件版本分别管理。本地候选的静态、安装、真实宿主与人工验收分别取证，暂不发布。
-
-[公共技术规约采用说明](technical-baseline/readme.md)提供通用模板v0.0.1与当前可选规约v0.0.4；规约固定引用同一根下[工程骨架1.0.0](engineering-skeleton/readme.md)，不再内置另一份旧目录规范。骨架是工程组织规则与采用说明，不是可运行代码模板。项目明确采用才生效，已有规范和项目自改副本优先。发行资料仅保留当前版本，不提供旧资源副本或兼容链接；既有业务文档、采用记录及验证事实不被改写。
-
-业务JSON顶层仅schemaVersion、scope、selected；原版25技能／9命令及既有原型能力保持，整体27技能／11命令，企业跨阶段auto不在本轮范围。
-
-文档review／recheck采用[独立只读审查合同](review-handoff.md)：外层在获准环境使用一次新的只读CodeBuddy会话，绑定准确目标、所选模板／业务来源及复查原报告和人工回应。报告保存与审查分开，业务稿不自动改写；缺隔离时整理新会话任务，不冒充独立审查，不新增业务JSON字段。
-
-原生方法的调用／报告复核与S06路径辅助校验分开，按[外层校验说明](verification/readme.md#原生方法与执行报告)显式使用；门禁对象和时点见[交接合同§11](handoff-contract.md#11-门禁对象时点和允许范围)。外层检查不自动改业务稿，不生成批准或启用企业流程。
-
-需要程序约束现稿交接时显式采用[单次受控入口](controlled-handoff.md)：先限制 CodeBuddy 只读，再核真实回执，最后仅登记用户明确采用的准确路径并回读。该入口与事后证据校验分开，不是随安装启用的通用拦截器，不代替原生方法、人审或企业auto。
-
-同主题已有选择需要替换时采用[改选预览合同](selection-handoff.md)：先核准确组合、上游原文证据与当前 Plan 影响，再经该次明确选择受限更新；新稿生成不自动选用。旧稿、其他主题、公共技术来源、工程骨架与 Plan／任务保持，新的规划输入由用户显式调用/i3-sop plan组织并复用原规划；原/i3-plan加明确任务的手动方式仍可用。
-
-本次输出目标已有稿件、中断、待补登记、重复执行及人工修改按[最小恢复规则](recovery-contract.md)处理；已有上游输入不把新目标误判为恢复。先核现稿，不重复生成解决清单问题；恢复状态及失败留在会话／外层证据中，不增加业务JSON状态字段。status与恢复保持根README、索引和三份共用合同的完整读取，安装身份按必要元数据核实。
-
-## 1. 先确定本次流程
-
-本轮明确标准流程时使用原方法，不读取或采用企业模板、提示词、清单和企业目录。只有本轮明确企业 SOP，或用户明确且适用于本任务的选择记录，才加载企业资料。安装、项目指引存在、发现 handoff.json 或出现 PRD 一词都不构成选择。资料不授予操作、写入或发布权限；当次任务不自动变成项目永久采用。
-
-CodeBuddy 可明确说：“为当前项目启用 i3 企业 SOP 资料指引，保留已有项目说明，不更改全局配置。”接入先实际读 CODEBUDDY.md，只追加[项目片段](codebuddy-project-guide.md)的完整有界标记，保留已有内容。同名片段复用，自改片段不自动替换；标记不完整、符号链接或归属不清时停止改写。更新先说明差异，按宿主要求新会话验证真实加载，不改全局规则。文件存在不证明宿主加载；其他宿主另取证。
-
-## 2. 分开定位三种来源
-
-| 来源 | 查找与采用规则 |
-| --- | --- |
-| 模板、作业提示词和资源合同 | 本轮明确指定的对应资源→项目明确采用副本→同宿主项目安装→同宿主可读全局安装；只向下查尚未选定的角色，不用低优先级源替换失效的已选源 |
-| 真实业务、公共规范、契约、骨架 | 先读项目根 README、适用项目规则、其引用的采用记录和 docs/README；以实际选择、适用范围及真实正文为准，不把资源模板当项目规范或可运行工程 |
-| 本次交接对象 | 已明确的唯一 JSON 清单或手动指定路径；只取本次主题的已选材料，候选、历史、样例和验证记录不作默认输入 |
-
-CodeBuddy项目安装由 `.codebuddy/.i3-composer-agent.json` 核name／version／scope、catalog.skills及本次SOP Skill的SKILL.md及资料子目录的readme.md两项精确assets，资料从实际Skill目录进入。可先定位键再读必要范围，不全文加载assets列表；`resources.references`继续服务原版共用资料，不能据此寻找SOP。项目确实未安装时才查同宿主全局安装；清单损坏、身份不符或资料缺失先报告，不静默兜底。已选项目副本时，安装事实不能接管采用。
-
-查找顺序也约束实际读取：先读项目根约定及其采用记录，确定对应角色尚无明确来源时，才访问下一优先级。已选定项目资料根时，不再读取低优先级的安装／全局资源README、索引或正文，除非本轮明确要求比较来源；不并行探读多套入口再事后宣称只采用其中一套。安装清单若先前已读，只保留安装事实，不顺势进入其资源。
-
-不全盘搜索、跨项目或跨宿主借安装；全局可读时不重复要求项目安装。history、验证目录、备份和样例只在本次明确指定用途时读取。目录列表、索引、聊天摘要和自动上下文只是线索，必须实际读选定根 README、索引、采用记录及本次所需正文。
-
-本轮只指定一个模板时，只覆盖该角色。提示词及共用规则先沿项目采用组合；尚未选定才按上述顺序提议固定来源，说明兼容范围。冲突不得靠“本轮优先”取消既有规范、权限或质量要求；明确本次覆盖范围后执行，持久修改采用须另有相应意图。无需因已明确选择重复提问。
-
-## 3. 按索引读完整资源
-
-review／recheck 的读取职责以[统一审查约定](review-handoff.md)为准：外层解析索引／清单／依赖并保留变化检查，模型完整读阶段README、模板、唯一动作、业务及实际约束。只对已固定覆盖组合精简；项目自改或未知规则继续完整读选定原件。以下生成／修订、status、交接与恢复读取规则保持；审查不再一律重复加载纯元数据和整套校验说明。
-
-先实际读[阶段索引](stages.json)和其中三份共用合同：[模板合同](template-contracts.md)、[交接合同](handoff-contract.md)、[生命周期合同](lifecycle-contract.md)。再按本次阶段／动作读本阶段README、manifest、完整模板和唯一对应generate、review、revise或recheck提示词；不是一次读取四份动作提示词或全部模板。
-
-本次读取清单由已读索引、局部manifest及直接任务确定：先列实际路径和用途，再逐项成功回读；未读／失败／部分读不能记“已读”。按以下检查收尾，不为了少读省掉必要依赖，也不为“完整”探读未选根。
-
-| 必读对象 | 本次适用范围 |
-| --- | --- |
-| 项目规则与采用依据 | 本项目CODEBUDDY、根README、实际引用的采用与docs约定，先于安装资源 |
-| 当前资源根与共用合同 | 选定根README、stages及三份共用合同；manifest内dependencies的适用正文也实际读 |
-| 阶段资料 | 本阶段README、manifest、完整模板、本次唯一动作提示词；索引／manifest可被项目改路径，不能按默认名猜 |
-| 公共技术规约辅助资料 | 本次要求辅助准备／模板缺口核对时：按auxiliaryResources读其manifest，再读manifest指定entry和template；三者缺一不能声称完整辅助读取 |
-| 业务与必要依赖 | 只取本次所选正文及必要直接／传递约束；骨架采用说明指向真实来源README／源码时，实际读该来源，说明完备或缺口 |
-| 已选缺项 | 读取到具体缺项后准确报告文件／目录区别及影响；不再加载其他动作或低优先级源兜底，独立工作只建议不执行 |
-
-结束前对照这份本次清单，报告已成功读取、仍缺／失败、未要求的资料和具体依赖影响。不要用搜索结果、索引列名、行数或作者摘要替代正文；长文按实际工具截断分段覆盖。维护来源、旧证据和模板中的示例链接不自动成为业务必读。本组合提供[外层只读校验](verification/readme.md)，由获准调用者对照本次适用清单和CodeBuddy原生轨迹执行；单独加载资料不会自动启用校验，也不拦截工具调用。文件存在、读取覆盖和语义正确分别判断。
-
-| 路径类别 | 相对基准与边界 |
-| --- | --- |
-| sharedContract、handoffContract、projectGuide、阶段／辅助资源 resourceRoot 和 manifest | 当前选定 stages.json 所在目录 |
-| 阶段模板 source.resourcePath、prompts、files | 对应阶段 manifest 所在目录；source.path 为维护来源，不作安装路径 |
-| 辅助资源 entry、template、files | 对应辅助 manifest 所在目录 |
-| dependencies.path | 声明该依赖的 manifest 所在目录，允许在选定资源根内引用共用文件 |
-| 业务 JSON 及手动交接相对路径 | 本次明确的业务项目根，详见[交接合同](handoff-contract.md)；不相对清单目录或临时 cwd |
-
-资源索引的路径经解析后须保持在选定 SOP 资源根内，含符号链接解析；越界、不可读、损坏或版本／主题矛盾时报告具体缺口和影响，不改用安装原件、全局新版或历史副本。真实业务文件不受资源根约束，明确提供的项目外来源可使用绝对路径并说明可移植性，不自行复制。
-
-| 阶段／辅助资料 | 输入、方法与边界 |
-| --- | --- |
-| brd | 业务描述、EBC、完整 BRD 模板；必须原Spec；按需澄清／文档方法，候选 PBC 不冒充获批 |
-| prd | 选定 BRD 或等效依据、PBC、主题、完整 PRD；原规格方法及适用认可／停轮保留 |
-| ad | 选定 PRD、真实规范／工程事实、完整 AD；必须原Spec；按需文档／接口／前端方法，原型按需并行 |
-| testcase | 直接产品依据 PRD、配套 AD、测试规范、完整 TestCase；必须原Spec；仅设计，不借原 /i3-test 生成文档或冒充执行 |
-| technical-baseline（辅助） | AD 准备时按需定位；优先复用项目已有规范。只有缺少适用规范且本次明确选择才起草最小候选；不是第五阶段 |
-
-公共技术规约的[采用说明](technical-baseline/readme.md)和模板用于核对来源与缺口。现有规范已充分时直接引用，不复制总规约、不修改原规范。技术栈与工程骨架是项目实际选择；模板不预设答案，选型、候选、采用、应用、验证分别表达。
-
-四阶段固定组合：BRD 0.2.3／模板 v0.0.3，PRD、AD各0.3.3／模板v0.0.4，TestCase 0.3.4／模板v0.0.4；公共技术规约辅助资源 0.4.0／模板 v0.0.1。四阶段模板正文原字节保留，B05仅增补说明和动作提示词，PRD 子包“未提供其他模板”仅描述该子目录；其中 AD 责任说明不是完整 AD。采用旧切片缺资料时报告差异，不默认混版。
-
-## 4. 保护项目采用与人工修改
-
-使用本次已选根及实际本地内容，记录发行来源、项目差异与适用范围。发行 manifest 的 sourceSha256／sha256 描述源码／品牌分发原件，不是要求项目副本永久不变的锁；本地修改可在现有采用说明中说明。未计算摘要如实写，不填假 SHA，不因内容已变就恢复原件；版本标签与正文矛盾先核对，不能拿摘要免除实际读取。
-
-安装升级不切换项目采用，不覆盖项目副本、已生成文档或自改指引。本次只读定位也不“修复”索引／清单。更新模板或提示词先比较差异，保留项目旧稿和修改，明确目标和相应授权后才单独合并，不批量升级实例。已选源失效只限制依赖范围，可独立继续的部分仍可继续。
-
-沿用项目命名，一能力一目录。同 PBC 多主题 PRD 各自独立版本；AD／TestCase固定直接上游，不强制同号或猜最大版本。写前整理项目根、阶段／作业、业务身份、实际资源及本地差异、输入、唯一输出、假设／Q和停点，展开“占位符→字段→值→来源”，实际写入及最终回读同一路径。现稿先读，不机械升版；权限、归属或覆盖风险未清不写。
-
-## 5. 文档、JSON与手动交接
-
-文档生成后完整回读、展示路径并交审，不自动创建或更新JSON。用户明确采用后才用init／select记录所选输入，清单顶层仅schemaVersion、scope、selected；resolve只读解析。手动路径方式继续可用，候选登记及撤回不再提供。
-
-
-第一步用企业任务、模板及原方法形成规格集合；第二步将本次选定集合交原 Plan，再按获准任务 Build／test／review／Ship。原方法不会天然读写 JSON，需要明确任务或适用的项目指引实际组织来源；S11另验证接点。Plan 保留 tasks/plan.md 和唯一 todo／tracker，不生成影子 SPEC 绕过原入口限制。
-
-review／recheck 只读会话标注，独立审查需真实新上下文；审查者不改文档、项目、JSON或报告，获准调用者另存。人工可修改、明确委托、有据不采纳或保持 Q。原型按需并行；TestCase为Plan的可选输入，验证内容、六项要求和依赖任务执行条件仍须满足。生成文档不等于采用，选用登记不等于批准、开工或测试通过，不自动进入下一阶段。
-
-## 6. 可直接说的任务
-
-- “按企业SOP，查找本项目采用资料，为巡检管理的任务编排主题生成PRD，完成后交我审阅。”
-- “按企业SOP准备本主题AD。有已采用公共规范就引用；没有则说明选已有规范或起草候选的选项，技术栈和骨架等我调整确认，不自动生成一批资料。”
-- “本次只读核对交接：读取项目选定的JSON及本主题实际来源，列缺口，不写任何文件，不生成下一阶段。”
-- “本次按路径手动传递所选PRD、AD、已有规范和骨架说明，不创建JSON；核对后只规划供我审阅，已有TestCase则引用，没有则按依赖安排补齐。”
-- “本次使用标准流程，生成原标准规格，不采用企业SOP。”
-
-以上为自然语言任务，不是已实现的新 slash 或业务 CLI。资源合同、源码分发闭包、安装、宿主加载、模型实际读取、内容质量、工程执行、人工验收和发布分别取证。
-
-## 7. 新增、修改、撤销和功能退役
-
-按[生命周期合同](lifecycle-contract.md)先核意图与候选／目标／已实现事实，选本次阶段及唯一目标。新增主题独立版本，修改保留完整目标，取消不标任务完成，已完成任务和历史报告保留；已实现功能通过新退役设计与获准工程任务移除。资料作业不顺带改Plan、任务、代码、生产或其他主题，JSON改为明确选用登记，本修订未测试；既有改选保护保留，撤销／退役引用差量及完整组合恢复仍按计划范围，本片最小恢复见上文；真实原Plan与Build交接留S11。
-
-可以说“按企业SOP，修订本主题的完整PRD，说明新增／修改／保留／撤销及配套影响，只写本次候选交我审阅”；或“只读分析撤销某FR／功能退役，核文档、JSON、任务和消费者，零项目写入”。不新增变更子命令，不因资源升级改变标准流程或项目永久选择。
-
-B05-r2收尾澄清：最后一次Write／Edit后分段完整读取最终稿；全文回读后再Edit也须再次完整覆盖，不以局部回读冒充最终全文核对。必要输入缺读先明确缺口，补读不追认为过去已读。本修订不新增读取守卫或扩大辅助资料的按需适用范围。
-
-## B05收口：适用性与外层证据
-
-先按本次目标确定必要输入，不把所有工程文件、辅助模板或Plan／todo都设为所有阶段前置；涉及已有任务、影响或不存在断言时，回读对应实际来源或明确未核。候选列表和现稿中自称的比较材料只是线索，只有本次明确指定的比较范围才读取未选版本。不得用现稿元数据自行扩大本轮任务。
-
-“未读取／部分读取”“读取失败”“已验证路径缺失”“不在本次选定集合”“内容尚未核实”分别陈述。无消费者、无需迁移、不受影响及全历史不存在等结论给出实际已核范围；没有证据时保留Q，不从未读推出否定。模板章节与业务现稿章节分开引用，Glob无匹配不证明目录存在且为空。
-
-外层校验按实际返回行核必要输入全文、唯一目标末次编辑后全文回读、未选／越界读取及只读边界。审查者每条发现和已核事实附所指文件的短原文摘录；摘录匹配及读取通过仍不代替理由和反例的人工核验。校验失败保留稿件与局部意见，明确受限范围，不声称完整交接，不自动修稿或推进。新入口、JSON登记及原Plan／Build消费仍留后续。
-
-## 审查输出契约与定向复核
-
-资源组合0.5.2补齐[审查会话契约](verification/review-output.schema.json)、外层错误分类与调用者来源角色绑定，详见[说明](verification/readme.md)。原生失败不改写；定向格式／来源复核不自动改业务稿，达到当次约定轮次仍失败交人工裁定。该工具仍由外层明确执行，不自动加载／拦截原方法。
-
-## 来源角色同源生成增量
-
-当前组合0.5.3采用[共用生成与校验工具](verification/readme.md)：同一scope角色表为模型生成role枚举，并在实际CLI参数核对；授权校订报告独立检查内容，不追认为原生通过。仅自有辅助变化，四阶段及辅助模板正文、原版技能和命令保持。新独立验证一次，失败交人工裁定，不发布。
-
-## S06最小交接切片
-
-资料根固定为本次实际加载的SOP Skill的 `references/`；源码为 `skills/i3-enterprise-sop/references/`，品牌安装为 `skills/i3-enterprise-sop/references/`。工程目录资料在其 `engineering-skeleton/` 子目录。项目已采用副本仍按真实采用记录读取，不改其位置或正文。
-
-[handoff.py](handoff.py)提供三字段清单创建、明确初次选用和只读解析，接口及限制见[交接合同§8](handoff-contract.md#8-s06最小辅助与边界)。手动路径方式不要求使用工具或创建JSON。共享JSON只存路径，不保存批准、完成率或运行结果。脚本读取不代替模型全文回读与语义核对。
-
-本片不含命令接入、既有选择替换、完整修订恢复、独立审查调度、Plan／Build自动消费或工程生成；对应S07—S11及I4／I5继续保留。模板正文和业务稿不变，先交人工审阅，暂不发布。
-
-## 7. spec/ 业务目录与原生命令
-
-新项目的BRD、同PBC多主题PRD、各自AD与TestCase默认写入spec/{能力}/，命名沿共用合同；现有项目约定优先，不搬旧稿／历史。这里的spec/是业务输出，SOP Skill的references/是安装资料，两者不混用。起草／修订必先成功调用原Spec Skill，使用其外部格式与存储能力；原/i3-spec包装及using不变。
-
-原Plan使用本次AD与其明确引用的产品／工程集合承接六项，原Build按获准任务继续；原Build auto保持其规格、Git、完整计划认可及逐任务测试／构建／提交停点。具体输入示例和上下文范围见[交接合同§10](handoff-contract.md#10-从选定-ad-到原-planbuild-的输入合同)。JSON不天然触发或被原命令读写，手动准确路径继续支持。只有当前主题和必要共享约束进入上下文，摘要不能替代真实正文。
-
-/i3-sop无参数只读引导；brd／prd／ad／testcase为单阶段文档任务，plan为一次原规划交接，review／status只读；未知动作及auto不写入、不猜阶段。直接Skill和命令规则相同。工程骨架由AD选择、Plan排任务、获准Build应用验证；本资料不提供可运行骨架生成器，I4／I5仍需真实工程验证。
-
-## 8. 短命令与原规划交接
-
-可以直接使用/i3-sop brd、prd、ad、testcase或plan；明确调用本Skill并给同一动作也适用。不新增必填参数或路径。先定位已有项目材料，只问本次缺少的业务事实／对象选择；唯一且充分就继续，不重复确认。结构化问答取决于宿主实际可用工具，否则会话提问并等待；取消／无答复不写占位文件。
-
-四阶段写作仍须成功调用原Spec并守内容与停轮；plan按[规划交接](plan-handoff.md)只读解析本主题清单或手动材料，完整读准确PRD／AD、已采用规范／必要契约、工程采用与相关代码，实际加载原规划Skill并履行原Plan命令义务。保存原tasks/plan.md与唯一任务目标，回读交审后停轮，不写业务稿／JSON、不自动Build。无清单可手动，标准原/i3-plan不强制读handoff；27技能／11命令不变。
-
-四阶段模板正文、审查提示词／Schema及原方法保持。已逐条覆盖的当前发行共用规则可使用审查辅助的固定资料指纹；未知／自改组合继续完整读取选定原件，不放宽判据或冒用旧证据。
-
-## 11. SOP Plan读取与身份停点
-
-JSON与手动输入共用[规划交接](plan-handoff.md)的首批完整读取及原方法检查点，手动不省略共用规则。文件名清单统一登记于stages.json的planHandoff.requiredResourceReads；辅助解析不代替模型阅读全文。AD能力／主题身份或直接上游路径／PRD版本矛盾时先停，不加载原规划、不写plan／todo或候选计划。PRD与AD独立版本不必同号，未知非阻断Q与身份冲突分开处理；不改业务稿、JSON或原版能力。

package/skills/i3-enterprise-sop/references/recovery-contract.md

@@ -1,65 +0,0 @@
-# S08 最小恢复规则
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-规则版本：v0.4.0；本次只做源码修改，未测试、未发布；适用于显式企业 SOP 的状态核对、中断恢复、路径补录、重复执行和人工修改保护。命令与直接 Skill 共用本规则，不增加顶级命令或修改原方法。先读[Skill](../SKILL.md)及[交接合同](handoff-contract.md)，handoff.py 仍保留init／select／resolve 三操作，业务 JSON 仍 schemaVersion 1；同主题改选采用单独的受控预览合同。
-
-本地增量采用[受控辅助](controlled-handoff.md)时，预检只读、回执校验、明确选用登记由外层程序顺序执行。缺读可在同一只读作业内补齐，仍不完整、调用拒绝、报告矛盾或文件变化则不启动登记；结果给原因、推荐与可选操作。只约束从该入口进入的单次交接，原失败与其他会话不追认。
-
-## 1. 先核当前事实
-
-确定项目根、工作范围、主题、唯一目标和本次允许写入对象。实际读项目规则、采用来源、资源根 README／stages.json／三份共用合同；使用安装清单定位时核 name、version、scope、catalog.skills及本次SOP Skill精确assets，资料取实际Skill的references/，不全文加载资产列表。此读集不因 status 或只读恢复而缩减；阶段模板及生成提示词仅在实际生成、修订或相应内容核对时加载。
-
-先区分输出目标和上游输入：已有 PRD 用来生成尚不存在的 AD，仍是新建 AD，不因输入已存在而改成现稿恢复。只有本次输出目标已有稿件，或有该目标写入／登记中断等实际依据，才进入相应恢复判断；恢复任务本身不产生新的写作委托。
-
-恢复还须完整回读当前目标、明确的直接上游、本次交接清单和相关实际失败记录。涉及已选输入、Plan 或任务保护时读它们的当前正文；不展开其他主题和历史全集。历史只在本次明确的恢复依据范围内读取。记录未读、失败、部分读及未核事实，不能从路径存在、辅助成功或旧聊天推定完成或批准。
-
-只读补核可以说明现在已经确认的安装身份和来源；旧作业在写前漏读的事实及原失败报告保留。补核不改旧结论、不重新生成文档，也不证明业务完整。
-
-## 2. 按实际状态处理
-
-| 当前事实 | 本次处理 | 保留及停点 |
-| --- | --- | --- |
-| 目标不存在、外部写入结果未知 | 说明实际核对范围与缺口；未知动作不盲重试 | 不猜成功、不登记未来路径；新生成须另有明确任务 |
-| 写入中断、只有部分稿或收尾证据不足 | 只读列出已保存内容、缺口及建议恢复范围 | 不续写、不选用部分稿、不切 selected；后续修稿需明确委托并调用原 Spec |
-| 文档已完成，但原 Spec 停轮、清单未登记或登记失败 | 回读当前文档、直接上游、失败依据及当前清单，核身份与本次登记条件 | 确认本次准确选用并允许写清单后只补该引用；条件未满足就停止，不用重新生成解决登记问题 |
-| 相同工作范围、角色、capabilityId、prdId、规范化路径已选用 | 复用现有选择，报告实际变化 | 已是三字段且无变化时不新增历史；清理旧字段则保存原始清单，不创建新业务版本 |
-| 同路径文档、模板或提示词被人工修改 | 以当前正文为准，说明差异和受影响范围 | 不恢复发行原件、不继承旧认可；无明确修稿任务时零业务写入 |
-| 旧清单锁冲突、被其他写者改变、保存失败 | 保留目标及现有清单，准确报告真实失败和待补录路径，结束本轮依赖动作 | 不自动删锁、放宽权限、旁路写 JSON 或立即反复重试；后续获准作业先回读再补录 |
-
-选用前仍要求实际任务完成和最后编辑后全文回读。本辅助只验证真实可读非空路径，不能判断非空文件是否为完整业务稿；调用者不得用select的退出码0认证部分稿已经业务完成。条件无法确认时，只报告待核，不写清单。
-
-## 3. 复用现有工具补录
-
-先完成必读，再核实际发行工具 `--help`。清单已存在则不重新 init；确实不存在且本次明确允许创建时才初始化。只有本次准确文档已明确采用并允许写清单时，才用 select 补该引用；已有不同选择先改选预览。补录后回读实际 JSON 与返回的 history，核对本次 selected 差量、其他主题和人工内容；changed=false 时不预期新历史。
-
-```text
-python3 <发行资料根>/handoff.py --help
-python3 <发行资料根>/handoff.py select --project-root <实际项目根> --manifest <本次清单> --role ad --path <已完成并重新全文回读的现稿> --capability-id <PBC> --prd-id <主题>
-```
-
-示例参数须替换为本次真实值。没有可用 Python、写入授权或稳定清单时继续手动准确路径交接，不安装依赖、不为恢复创建另一套状态库。失败和业务审阅意见留在真实会话／外层证据中，不新增 approved、passed、完成率、强制 hash 或任务状态到业务清单。
-
-## 4. 保护已有工作
-
-仅补选用引用只允许更新本次明确的 selected；不改已有 Plan／唯一任务目标、已完成勾选、业务正文或其他主题。新稿存在不构成采用，同路径已选稿被人工修改仍核计划影响。清单顶层仅 schemaVersion、scope、selected；旧字段仅在获准写入且保存原始历史后移除。
-
-同主题既有选择替换按[改选合同](selection-handoff.md)先预览准确路径、配套及 Plan 影响，取得该次明确选择后才执行；来源变化须新预览。候选登记／撤回流程已退出，未采用稿只展示路径并保留文件。主题撤销及跨主题组合仍按明确任务核对，手动方式保留；原 Spec／Plan／Build 停轮、S09 独立审查和发布授权保持。
-
-## 5. 可复制任务说明
-
-```text
-/i3-sop status 本次只读恢复核对。读取本项目采用资料及五项共用来源，核安装定位元数据、当前目标、直接上游、清单和我指定的失败记录，区分部分稿、待补登记与已登记。保留人工修改和原失败，不写任何项目文件，不生成或修订文档，不进入 Plan／Build。
-```
-
-```text
-/i3-sop ad 上次文档已保存，本次只补我已明确采用文档的 selected 路径登记，不重新生成或修订。先按本项目采用资料核对真实输入和恢复条件，完整回读我指定的现稿、直接上游及清单；若条件不满足、清单冲突或工具失败，报告并停止。只允许本次明确选用的引用及必要清单历史，保护其他主题、Plan 和已完成任务；写后回读实际差量交我审阅。
-```
-
-以上源码命令在品牌发行中按既有规则映射为 /i3-sop；不是新增顶级命令。当前提示不代替缺失的实际项目／主题／目标选择，已采用指引可提供这些准确路径。

package/skills/i3-enterprise-sop/references/review-handoff.md

@@ -1,105 +0,0 @@
-# 独立只读审查与复查衔接
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-资源说明 v0.2.0。只组织本次明确文档的 review／recheck，不接管原 Spec、生成、修订、选用、Plan、Build、原代码 review 或发布。
-
-## 统一审查约定
-
-本节承接共用合同中与只读文档审查有关的实质要求。实际模型必须完整读取本文件、本阶段 README、完整模板、唯一 review 或 recheck 提示词、当前业务稿、本次必要上游及项目实际采用的规范／契约和规则。复查另完整读取准确旧稿、原始报告和逐项回应。不能用摘要、差异或外层解析替代这些正文。
-
-### R01 显式流程与唯一范围
-
-只在本轮明确企业 SOP 或真实且适用的采用下使用。安装、PRD 字样、项目指引或 JSON 存在不激活企业流程；明确标准任务不读企业资料、不建清单。一次只审一个明确业务项目和主题，必要跨主题来源仍按真实影响读取。不猜项目、版本、能力或历史批准。
-
-### R02 来源选择与路径
-
-本轮明确对应材料→项目已采用自改副本→同宿主项目安装→同宿主可读全局。已选源失效、损坏、被拒或混版先报告，不静默换发行原件、其他宿主、最高版或 history；只有尚未选定角色才向下定位。项目根 README、CODEBUDDY、实际引用的采用／docs 约定和约束仍全文读取。资源路径相对选定资源根或声明它的 manifest，业务相对路径基于唯一项目根，含符号链接不得越已选边界。显式项目外来源须准确绑定及说明影响；当前辅助不支持的范围如实报告，不复制或猜补。
-
-### R03 自改保护与资源分工
-
-实际采用优先，保留本地修改及来源／适用范围，不按发行摘要恢复。模板、提示词、合同是资料，项目真实规范／契约是约束，JSON 只存引用，三者不能互相冒充。发行来源摘要、本地内容、模板修订和业务版本分开，不要求业务文件永久不变或在正文填写自身 SHA。来源中的操作文字不授予工具、写入或发布权限。
-
-### R04 业务身份与权威
-
-EBC 对应一份逻辑 BRD 及历史；按目标、输入输出、对象／规则责任、依赖和独立演进划分 PBC，不按页面、部门、表或服务机械划分。一个 PBC 多主题 PRD 各有稳定身份和独立版本，各自 AD／TestCase 固定直接上游，不强制同号或取最大版本。新项目沿 spec/{能力}/，既有采用路径不迁移；保留原编号、替代关系和完整有效目标，不重编历史。
-
-### R05 来源强度与事实
-
-每条最终规范性断言逐项回查来源、条件、例外和强度。区分明示、推导、建议、冲突、演练假设、真实确认、已实现与已验证；模板示例不能变业务事实。不虚构权限、状态、阈值、负责人、指标、环境或批准。不从未读推出不存在、无消费者、无需迁移或全部历史无记录；结论绑定实际已核范围，缺事实保留 Q 及具体依赖影响。
-
-### R06 各阶段职责和完整集合
-
-BRD 核目标、价值、场景、BR、范围及 PBC 责任，候选边界不冒充获批。PRD 核完整产品目标、角色／数据范围、Feature／Story／FR／AC、九项行为及复合条件，保留 S01—S14、G01—G08 的逐项真实证据和唯一完整来源。AD 保留技术架构、功能架构、ER 三图及字段／接口／数据／权限／状态／事务／恢复详设。TestCase 直接核 PRD 产品预期及 AD 技术判据、覆盖／环境／数据／用例／准入和未来报告要求；设计不等于执行，实际结果另存 TestReport。不靠数量或勾选代替检查。
-
-### R07 全文一致性与反例
-
-跨角色表、规则、流程、页面、状态、行为卡、AC 和 Q 核权限及例外，组合角色不无源削权，全读不等于可代执行。分别核生成、保存、展示、编辑、必填、业务前提与系统检查；正常、拒绝、技术失败、结果未知、重复／并发、取消、重试和恢复不合并。构造可复现反例，逐表逐行核表头列数及列义、稳定 ID 与引用，不以机器数量检查代替语义。
-
-### R08 工程六项与可选输入
-
-在适用阶段／交接范围核 Objective、完整 Commands（参数、cwd、前提、副作用）、Project Structure、真实 Code Style 示例、Testing Strategy、Always／Ask first／Never Boundaries。早期 BRD／PRD 不要求全部工程资料，缺项不能自称规格齐备或可编码；不造第五核心 SPEC。原型按需，可与 AD 并行，无原型不统一阻断；已有原型核准确版本／范围／appliesTo 和必要依据，不改其登记。TestCase 是 Plan 可选输入，已有读准确版本，没有可安排补设计，不能降低依赖任务验证条件。
-
-### R09 技术规约、契约与工程来源
-
-优先项目已有规范／CONSTRAINTS／ADR、实际技术栈、共享契约和采用说明，完整读本次实际采用的必要原文。辅助模板按任务适用，不强制另造总规约、预设技术栈或把模板当真实规范。核准确 PRD 及相关 AD、规范／契约版本、提供消费方、字段／状态和数据单一权威、最终校验／写入／事务、必要传递消费者、严格消费者及兼容／迁移／并存窗口。版本号、Schema、目录图或服务存在不证明兼容、实现或测试通过；目录采用、拟建工程、真实源码、应用验证分别表达，实际规则冲突只标注，不替业务决定。
-
-### R10 新增、修改、撤销和退役
-
-保留主题、有效 FR／AC 和完整当前目标；部分撤销不删整主题，文字更正不机械全链升版。真实变更追到相关契约、实体、AD、AC、用例、消费者及任务，保留旧组合、既有行为回归和未受影响范围，不自动重写其他主题。目标、任务实际状态和运行事实分别取证；未实施取消不标完成，进行中保留人工工作，已完成历史保留，已实现／运行功能退役用新兼容、移除、迁移、恢复及回归任务。删除文档或改 JSON 不代表代码／生产已退役；未知结果不盲重试，代码回滚不等于数据恢复，不删失败用例／降阈值／以替身关闭必需真实集成。
-
-### R11 原方法、选择与授权停点
-
-生成／修订继续先真实加载原 Spec，最后编辑后完整回读最终稿并停轮交审。生成存在不等于明确选用，选用不等于业务认可或 Plan 批准；JSON 顶层仍仅 schemaVersion、scope、selected，无 candidates、delivery 或审批字段。手动路径保留，不强制建清单或重跑 BRD。原 Plan 及唯一任务目标保留实际来源／FR／AC／验证、未完工作保护；获准后才进入原 Build／Build auto，原规格、Git、TDD／测试／构建／提交及风险停点不变，不隐藏变更规避原门禁。本文只审文档，不执行这些工程动作，不授予下一阶段或生产权限。
-
-### R12 独立只读与人工空间
-
-作者同会话自查不冒充独立审查。独立者用真实新上下文，只在会话输出问题、位置、来源、反例影响和最小建议，不写项目、业务稿、模板、提示词、报告文件、JSON、Plan、代码或采用记录，不调用 Spec／原代码 review／其他 Agent 或外部能力。人可修改、明确委托修订、有据不采纳或保留 Q；不为清零编决定。获准外层另存报告；缺已验证隔离时交准确新会话任务，不声称上下文被清除或 OS 级只读沙箱。
-
-### R13 必要全文与真实证据
-
-当前稿、必要上游、项目实际采用约束、本阶段 README、完整模板及唯一动作逐项全文读，长文分段覆盖截断。未读、部分、失败、确认缺失、不在选定集合和语义未核分别报告；成功 Read 一次、索引列名、作者摘要或外层读过不算完整模型读取。补读不追认为旧作业写前已读；生成／修订的末次编辑后全文回读要求保持，审查不负责自动补稿。
-
-### R14 报告、引用和角色
-
-以外层传入的同源 Schema 返回唯一 StructuredOutput：verdict、findings、checkedFacts、unread。结论为可交人工审阅／需修订／无法判断（兼容原契约交人工审阅），每条发现与已核事实有稳定 ID，target／source 各含实际路径、startLine、可选 endLine、所指行内短逐字 quote；保留原引号，不用省略、改写或 Read 行号前缀。发现区分 contradiction、evidence-gap、clarification、optional，给理由与最小建议，无真问题则 findings 为空，不凑问题。普通引用省略 role；只有外层绑定 sourceRoles 时用 Schema 枚举键，requiredSourceRoles 有真实路径／摘录／读取依据。角色表、作业 Schema 和校验同源，不另造描述性 role。引用通过不证明推理正确，模型不能引用仅外层读取而自己未读的材料。
-
-### R15 真实复查
-
-完整读当前稿、准确旧稿、原始审查报告、逐项回应和必要来源，不只看差异、作者摘要或已处理声明。旧发现 ID 逐项写进 checkedFacts，conclusion 以已关闭／部分关闭／未关闭／无法核实开头并给依据；局部修正仍有矛盾不能关闭。新问题使用新 ID，并核修订引入的回归、权限／状态／来源强度、表格和完整有效目标。未处理、没有人工回应或尚无裁定必须照实保留，状态说明不冒充人工采纳或批准；误报有据排除，原始失败和报告不覆盖。
-
-### R16 漂移、恢复与有限复核
-
-同路径同版本内容可变，旧审查只对当时对象有效；本次核准确正文及必要变化，不阻止之后人工改稿。不稳定、缺读、被拒、超时、来源漂移、越界工具、无效报告或缺隔离时保留失败、缺口、原因、推荐及可选操作，不换源／旁路追绿。按当次约定有界复核，仍失败交人工裁定；不重复生成业务稿解决登记，不自动 reset／回滚或清锁，不声称消除任意编辑器并发窗口。
-
-### R17 外层与模型读集分开
-
-外层解析选定阶段索引、manifest、路径／版本和依赖，传入 Schema，核实际 argv、session、工具尝试／回执、必要全文、逐字引用、旧 ID 和项目零变化。模型不必重复读取已被固定覆盖的纯元数据／校验说明；被移出的原件和元数据仍保留本轮变化检查。精简只用于本辅助中已逐条覆盖并固定指纹的资料组合，不以项目自报兼容或同名同版本代替。自改或未知组合继续完整读取该项目选定原件，额外依赖不得静默删除，缺项不回退发行模板。阶段 README、完整模板、业务和实际约束从不因本分流裁剪。sourceRoles 与 Schema 同源；外层检查通过不能伪称模型已读元数据。
-
-### R18 结果与范围
-
-evidence_accepted 仅接受执行、读取、引用、会话和文件保护证据；业务报告允许需修订、真实意见和 Q，不要求清零。needs_human_review 表示证据缺口，不等于业务稿错误或原版冲突。静态、包、安装、宿主、模型行为、人审、工程／测试／Ship 就绪、实际发布分别取证；Ship GO 不等于发布／部署授权。工具调用一经提交就算尝试，拒绝、失败、成功、未确认按真实回执区分，退出码 0 不证明报告完整。普通作业不强制增加 Bash 或其他执行报告；审查只用本报告契约，不串行自动修订，不扩展跨阶段调度，不承诺固定耗时。
-
-## 外层一次调用
-
-命令 /i3-sop review 与显式 i3-enterprise-sop 共用规则；正文明确复查时采用 recheck，不新增必填用户参数。调用者依据任务和项目采用整理准确阶段、目标和业务来源，不要求用户填写内部路径。当前作者有已获准 CLI 能力时由外层启动辅助；辅助不在只读审查会话内部运行。
-
-```json
-{"action":"review","stage":"prd","target":"spec/巡检管理/巡检管理-任务登记-PRD_v0.0.1.md","sources":["spec/现场运营/现场运营-BRD_v0.0.1.md"],"task":"核本主题权限，保留人工修改空间。"}
-```
-
-```text
-python3 <实际所选资料根>/verification/review_handoff.py --project-root <唯一业务项目根> --request <外层准备的任务.json> --evidence-dir <获准项目外新目录>
-```
-
-这是外层执行输入，不是业务 JSON。stage 仅 brd／prd／ad／testcase，action 仅 review／recheck。sources、inputs、previousTarget、priorReport、responses 是实际必要输入；recheck 三项历史输入缺失不猜。sourceRoles／requiredSourceRoles 仅在实际角色绑定需要时由外层提供，与 Schema 使用同一 scope，普通作业不增加角色。
-
-辅助生成随机新 session，不 resume／continue／fork，不覆盖默认模型／系统提示，只提供 Read／Glob／Grep／StructuredOutput，禁用 Shell、写入、Skill、其他 Agent 和外部 MCP。init.tools 的宿主目录不是有效白名单；核实际参数、调用／回执和文件差量，未尝试越界不虚构拒绝。报告及输入快照只存项目外，不向业务 JSON 加 hash 或批准。无 Python／CLI／隔离权限时给新会话任务并结束，不自动安装依赖或调用其他宿主。
-
-完整生成、标准隔离、三字段登记、四阶段双入口与真实原 Plan／Build 的剩余矩阵分别按 S10／S11／S12 验证；本次精简不关闭它们。旧 S09 失败、报告和当时版本保留。候选登记、撤回、delivery 及企业 auto 不因本接点恢复。

package/skills/i3-enterprise-sop/references/selection-handoff.md

@@ -1,55 +0,0 @@
-# 同主题规格改选与影响预览
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-本片补充单次受控入口的 selection-preview／selection-switch 操作，不新增顶级命令，不接管标准流程或企业 auto。只支持项目级 CodeBuddy CLI 内同一已选 capabilityId＋prdId 的 PRD、AD、已有 TestCase／原型路径组合。公共技术规约、共享契约、工程骨架、其他主题、scope／selected内人工内容、业务稿与 Plan 不由本操作改写；成功写入只保留三字段，旧candidates／delivery随原始清单留历史，其他未知顶层字段先明确用途。其他宿主、项目外来源或骨架目录仍可手动交接。
-
-## 先预览，再明确选择
-
-调用方按真实任务整理请求，不能让只读模型自行决定选用或生成授权。operation=selection-preview 时，先真实加载自有 SOP Skill，读取当前／目标主题与必要共享依赖、当前 Plan／任务和调用方明确补入的完成记录；外层核成功回执后，才将差异、配套证据、Plan 引用命中和任务文本观察保存到项目外 selection-preview.json。项目零写入。输入太大可按主题分段完成读取，不能以元数据裁剪替代业务正文。
-
-调用方在会话中展示原因、推荐与选项：保留当前选择／明确选择新组合／补齐配套或明确解除引用／本次手动交接／停止。无真实明确委托时结束；模型推荐、自动模式、已有候选和高版本号均不构成选择。
-
-确认准确预览后，调用方用相同的工作、主题、target、links、inputs 准备 operation=selection-switch，并用 preview 指向该项目外预览文件，再在真实委托范围内加 --switch-selection。仍运行一个新的只读会话，回读当前输入与旧预览所涉及来源；回执、来源或文件变化均不进入写入。通过后复用既有 handoff._store，最多一次受限更新本主题；保存旧清单并核完整差量。手动方式不依赖此辅助。请求和参数只能限制委托，不能认证人类身份或创造批准。
-
-## 请求与配套判据
-
-共同字段：schemaVersion=1；work、manifest、capabilityId、prdId、task 必须明确。target 必须含准确 prd 路径，只允许 prd／ad／testCase／prototype；未列项保持旧引用，显式 null 仅解除对应配套引用、保留实际文件。不要靠省略旧 AD 把它假配给新 PRD。
-
-links 是调用方从真实正文摘取的数组，每项为 role、upstreamRole、line、quote。AD 必须核直接 PRD；已有 TestCase 同时核直接 PRD 与 AD；已有原型核 PRD。line 为真实正文的一基行号，quote 为该行完整原文；原文需以行内代码或 Markdown 链接准确写出本次上游的项目根相对路径。程序核原文、准确路径及组合，不做业务语义批准。项目采用其他引用格式时，可补人工核对并继续手动方式，不能冒称本入口已自动识别。缺证据、旧上游、不存在的上游或矛盾配套列缺口，不能靠确认参数绕过。无 TestCase 或原型本身不阻断改选；缺 AD 时如实保留工程规划缺口，不能由选用推定可实施。
-
-inputs 为本次明确采用的额外正文路径；原／新主题和共享来源由选定清单补入。若 delivery 声明 plan／taskTarget，必须读取；当前存在的 tasks/plan.md、tasks/todo.md 也须读取。其他自定义任务／完成记录由调用方准确补入 inputs，不从任意文件或复选框推定完成或依赖。预览中的路径命中只是影响线索，不能证明未命中的任务无影响。
-
-```json
-{
-  "schemaVersion": 1,
-  "operation": "selection-preview",
-  "work": "本次实际工作",
-  "manifest": ".i3/sop/work/handoff.json",
-  "capabilityId": "PBC-ID",
-  "prdId": "THEME-ID",
-  "target": {"prd": "spec/能力/主题-PRD_v0.0.3.md", "ad": "spec/能力/主题-AD_v0.0.2.md", "testCase": null},
-  "links": [{"role": "ad", "upstreamRole": "prd", "line": 8, "quote": "直接产品依据：`spec/能力/主题-PRD_v0.0.3.md`"}],
-  "inputs": ["tasks/completed.md"],
-  "task": "核对这组准确路径的影响，先展示预览，不修改业务稿与Plan。"
-}
-```
-
-以上行号和路径是格式示意，必须从当前正文取得，不能照抄占位值。
-
-```text
-python3 <实际资料根>/controlled_handoff.py --project-root <实际项目根> --request <项目外预览请求.json> --evidence-dir <新项目外证据目录>
-python3 <实际资料根>/controlled_handoff.py --project-root <实际项目根> --request <绑定同一预览的切换请求.json> --evidence-dir <另一新证据目录> --switch-selection
-```
-
-## 并发、历史和后续原能力
-
-预览绑定本次实际输入和清单；摘要仅在项目外用作这次瞬时审计，不增加业务 JSON 的强制 hash 字段，不禁止后续人工修改。确认前发生人工修改、其他主题变化或并发写入时保留现状，重新预览。重复同一已完成切换且只有该次准确清单／历史差量时零写入；不把其他新增记录或新修改混入旧确认。基础锁与写前比对不构成跨编辑器事务，写后异常保留实际现场交人核对，不自动恢复业务稿或循环重试。
-
-清单切换不更新当前 Plan，也不迁移业务认可或工程开工许可。调用方须把新选 AD 及准确 PRD、公共规约、契约、工程骨架和必要代码显式交原 /i3-plan 核影响；仍由原方法写 tasks/plan.md／唯一任务目标，待人审认可后才按原 /i3-build 或 /i3-build auto 执行。完成任务及历史保留。共享技术定义或工程骨架本身需要修改时单独明确任务。候选登记／撤回已退出当前流程；撤销主题和跨主题完整差量仍按后续明确范围处理。