# 半导体调研体系 MVP 范围重置与开发精简方案 V001 创建人员:`dev.developer.ana.cai` 目标体系:`case_analysis/ana` 文件职责:落实人类对半导体调研体系 MVP 的范围简化决定,撤销普通本地开发中的一次性授权和普遍字节级冻结,并定义后续收口与验收边界。 记录方式:append-only;后续修改另建 V002 或更高版本,不覆盖本文件。 当前状态:`PENDING_INDEPENDENT_DEV_REVIEW_AND_MANAGEMENT_SCOPE_RESET` ## 1. 决策来源 1. 人类明确要求先建立“半导体调研体系”,不填充半导体调研内容,并优先精简两项机制: - 普通开发的一次性授权; - 普通开发的字节级冻结。 2. 管理终态 `HANDOFF-MGADMIN-DEV-ANA-SEMI-ROOT-PREFLIGHT-V007-PYTHON-STAGE-S-RESCUE-BUILDER-V037-AUTH-DECISION-20260728-001` 已判定 `HOLD_SCOPE_SUPERSEDED`:旧 V037 Stage S/Stage V、Y01-Y08、R01-R20 不再是调研体系 MVP 的当前范围,候选授权未生成、未发送。 3. 本方案只调整 `project-info` 项目内“半导体调研体系 MVP”的开发与验收口径,不修改 MB-X 全局规则,不降低数据库、凭据、网络、正式业务数据或不可逆操作的安全要求。 ## 2. MVP 的目标与非目标 ### 2.1 目标 建立一个可直接承载后续调研工作的体系骨架,包含: - 半导体案例容器与目录入口; - 调研方案、问题、证据、结论和审计的文档链; - 轻量开发与测试工作区; - 明确的范围、角色、流程、模板、验收和风险分级; - 后续可以逐步添加 Python 工具,但工具不是体系 MVP 收口的前置条件。 ### 2.2 非目标 - 不填充具体半导体公司、产业链、市场或技术调研内容; - 不连接数据库,不读取凭据,不访问网络,不执行 SQL; - 不创建正式业务目标,不执行 `BATCH-001`; - 不恢复或继续旧 V037 的 parent/child/rescue/taskkill/Y01-Y08 链; - 不以 root preflight、进程救援、字节向量包或失败笛卡尔矩阵作为体系 MVP 的验收条件。 ## 3. 精简规则一:一次性授权改为风险分级 ### 3.1 普通开发不再使用一次性管理授权 下列动作属于项目内可逆、无外部副作用的普通开发。在一个已登记事项内可以重复执行、修复和复验,不因一次语法错误、测试失败或格式错误而永久关闭事项,也不要求每次重新申请管理 A001: - 新建或修改项目文档、模板、目录索引; - 在 `dev/ana-dev/` 编写本地 Python、PowerShell 或其他轻量工具; - 在 `dev/ana-dev/test/` 编写和运行语法检查、静态检查、单元测试、契约测试; - 在 `dev/ana-dev/tmp/` 生成可删除的本地测试输出; - 修复失败后重新运行同一组本地测试; - 只读查看项目文件、目录和本地进程状态。 普通开发仍需遵守:目标路径边界、no-overwrite 适用场景、测试留痕、独立审核、不得伪造证据、不得把 tmp 当正式结果。 ### 3.2 仅高风险外部动作保留单独授权 下列动作继续要求独立管理审批;管理方可以根据风险决定是否采用一次性授权: - 真实数据库连接、查询、写入、DDL、账号或 `GRANT`; - 凭据、密钥、受控配置或正式连接信息的访问; - 网络访问、外部系统写入或对外消息; - 正式业务数据、正式目标、正式批次的创建或变更; - `BATCH-001` 或其他真实调研执行; - 删除、覆盖、迁移不可恢复证据,或其他不可逆操作。 ### 3.3 风险等级 | 等级 | 典型动作 | 执行口径 | |---|---|---| | L0 | 文档、目录、模板、只读检查 | 登记后直接执行,可重复校验 | | L1 | 本地源码、静态检查、单元测试、模拟数据 | 开发计划或轻量事项内执行,可修复重跑,完成后独立审核 | | H1 | 数据库、凭据、网络、正式数据、正式批次、不可逆变更 | 单独管理授权;默认 fail-closed | ## 4. 精简规则二:字节级冻结改为语义优先 ### 4.1 普通开发的默认验收 普通源码、测试、内部 JSON、命令参数和本地结果默认按语义验收: - 源码可解析、可导入或可编译; - 单元测试和契约测试通过; - JSON/CSV 可解析,必需字段、类型和业务约束正确; - 核心行为、错误处理和边界条件符合方案; - 文件位于正确目录,未越权触达外部系统; - 独立审核可以复现主要结果。 以下内容不再作为普通开发的默认阻断项: - Base64 预像; - 文件逐字节预冻结; - JSON 字段顺序或尾部换行; - 命令行逐 token SHA-256; - 为每个内部中间文件预先冻结 bytes/hash; - 与功能无关的换行风格或序列化字段顺序。 文件哈希可以在交付时记录,用于标识送审快照;哈希不是普通源码首次创建前的许可条件,也不把合理修复变成“新授权链”。 ### 4.2 仍需字节级或不可变证据的情形 只有下列情形保留字节级冻结或强不可变要求: - 外部原始证据需要证明未被改写; - 已正式发布的证据包、清单或审计快照; - 数字签名、JCS、协议签名或跨系统接口明确依赖 canonical bytes; - 法务、合规或管理审批明确要求的不可变材料; - 数据库执行回执等需要防抵赖的高风险证据。 是否启用字节级冻结必须在具体事项中说明“消费者是谁、为什么依赖精确字节”;没有真实消费者时不得仅为形式严谨而增加该门禁。 ## 5. 旧 V001-V037 链的处置 1. 旧方案、审核、失败包和审计记录保持 append-only 历史,不删除、不覆盖、不冒充成功。 2. V037 的专业计划审核结果仍是历史 `PASS/0/0`,但管理决策为 `HOLD_SCOPE_SUPERSEDED`;这不构成执行授权。 3. Stage S、Stage V、Y01-Y08、R01-R20 统一标记为 `DEFERRED_OUT_OF_SCOPE_FOR_RESEARCH_SYSTEM_MVP`。 4. 不再申请或生成旧 V037 候选 A001,不创建 A002,不恢复旧路径。 5. 旧失败暴露的 JSON 转义、尾部 LF、PowerShell 语法和时间比较问题保留为经验,不再作为体系骨架收口的阻断项。 ## 6. 半导体调研体系 MVP 的完成判定 MVP 在以下条件满足后可标记为 `RESEARCH_SYSTEM_MVP_READY`: - 半导体案例容器、目录索引和角色边界已存在; - 调研方案已定义问题、证据、执行、结论和审计结构; - BATCH-001 的设计可以保留,但执行状态继续为 `HELD`; - 本精简方案通过 `dev.reviewer.ana.cai` 独立审核; - 管理端完成项目级 scope reset,并确认 V037 不再是 MVP 阻断链; - 在案例总纲、半导体目录导读和案例设计中追加 MVP 收口状态; - 明确声明“体系已建立”不等于“调研内容已完成”。 MVP 收口不要求:创建 Y01-Y08、运行 Python、连接数据库、恢复 darkline、执行 root preflight 或产出真实半导体调研结论。 ## 7. 落地顺序 1. 创建本方案并更新目标开发目录入口; 2. 提交 `dev.reviewer.ana.cai` 独立审核,重点审核两项精简是否越过高风险边界; 3. 审核通过后,向 `management.admin` 提交 scope-reset/MVP-closure 请求; 4. 管理确认后,append-only 更新: - `ana-doc/案例总纲.md`; - `ana-doc/半导体案例/目录导读.md`; - `ana-doc/半导体案例/案例分析设计.md`; - 必要的管理与审计账本; 5. 将半导体调研体系标记为 `RESEARCH_SYSTEM_MVP_READY`,保持内容填充、数据库和 `BATCH-001` 为后续独立事项。 ## 8. 独立审核检查点 - 是否明确区分 L0/L1 普通开发与 H1 高风险外部动作; - 是否只取消普通开发的“一次一授权”,未取消数据库等高风险审批; - 是否只取消普遍字节级冻结,仍保留真实不可变证据; - 是否保持旧失败历史不可变且不复用旧授权; - 是否能在不运行候选代码、不连接数据库的前提下完成调研体系 MVP; - 是否与现有案例分析规范的轻量、可继续推进原则一致; - 是否具备清晰的 MVP 收口文件清单和后续边界。 ## 9. 当前授权与边界 - 本文件是范围重置与开发精简请求,不是数据库或业务执行授权。 - 当前不创建或修改 Y01-Y08、R01-R20,不运行旧 parent/child/rescue/taskkill 链。 - `BATCH-001=HELD`,`darkline_restored=false`。 - 在独立审核和管理 scope reset 完成前,不宣称 `RESEARCH_SYSTEM_MVP_READY`;当前只可称 `MVP_SCOPE_RESET_SUBMITTED`。