merge: 合入候选分支（09-17借款/ERP退役、09-18编号、09-19预算并发、完整10-05错误码迁移，均经确认）

# Conflicts: # .agents/skills/trellis-before-dev/SKILL.md # .agents/skills/trellis-brainstorm/SKILL.md # .agents/skills/trellis-continue/SKILL.md # .agents/skills/trellis-start/SKILL.md # .trellis/tasks/08-23-isolated-backup-restore-drill/design.md # .trellis/tasks/08-23-isolated-backup-restore-drill/prd.md # .trellis/tasks/09-05-error-explainability-payment-readiness/prd.md # .trellis/tasks/09-05-error-explainability-payment-readiness/task.json # .trellis/tasks/09-09-existing-deploy-seed-separation/implement.md # .trellis/tasks/archive/2026-09/09-05-trellis-upgrade-rule-cleanup/task.json # .trellis/workflow.md # scripts/qa/error-reason-legacy-baseline.json # server/src/routes/apOperations.js # server/src/routes/portal.js # server/src/routes/todos.js # server/tests/unit/fixtures/error-reason-messages.json # server/tests/unit/routes/apOperations.permissions.test.js
2026-09-26 07:54:10 +08:00
@@ -1,5 +1,64 @@
 # 升级与规则治理设计

+## 自主经验精简设计（2026-09-19，最新）
+
+用户授权主会话自主决定本轮维护。沿用项目合同，先记录本方案再执行，不为纯文本编辑重启同范围审批。
+
+### 已核问题及处置
+
+| 位置 | 已核问题 | 处理 |
+| --- | --- | --- |
+| trellis-update-spec | 10109 字节，强制七段输出和多份示例，容易把一次性事实扩为永久规约 | 改为短入口：先判断稳定/复用价值，再在原章节增改；infra/API/schema 的具体字段、边界、失败和断言深度保持，版式不固定 |
+| trellis-break-loop | 6963 字节，要求猜先验并合计100%、强制概率阈值、立即提交及同步不存在的上游模板目录 | 保留根因、失败原因、区分性证据和最小预防；去掉伪精确概率、擅自提交和跨项目模板写入 |
+| trellis-brainstorm | 10645 字节，重复规划/提问/汇总清单，已有充分信息也容易停顿 | 保留真实用户决策和批准门禁；自主授权范围内的常规选择直接处理，问题只阻塞依赖部分；复用已有任务 |
+| spec/guides | 通用教程、固定重复次数阈值、多平台源码模板路径与本项目不符；“入口校验一次”误导跨信任边界 | 只保留按风险触发的消费者/数据流检查；明确前端校验不替代服务端权限与事务重验，生成模板检查按本地实际适用 |
+| docs-and-evidence | 三类场景的正反例/正文重复 | 保留既有章节标题和可执行合同，缩短重复示例；补原章节维护稳定经验、任务保存本轮事实的规则 |
+
+本轮不拆分或移动大型业务 spec、不删历史经验/截图/回执、不改四个官方 bundled skills，不为减少提示字符停用技能。不修改 AGENTS、runtime、workflow、用户级技能/配置或产品。
+
+### 验证与回退
+
+证据根 artifacts/qa-governance/knowledge-pruning-20260919；before/ 保存允许改动的12个路径，protected-before.json 保存3070条整树基线，working-before.diff 保留既有差异。本轮逐文件对照，不以 HEAD 混入旧修改。
+
+先核保留契约映射及引用，再运行 skill-creator quick_validate、已有隔离 app-server 的技能发现（扩展核对本轮三技能）、task/process/docs/governance/diff 和保护检查。无 runtime/业务修改，不重跑50个未变 runtime用例或4437/372全量。只读主会话检查不冒充独立模型行为评估；新规划/复盘指令的独立审阅单列，旧升级 PASS 仍仅覆盖原增量。
+
+失败时从本轮 before/ 逐文件恢复，不重置整树。修订覆盖“证据先行、授权边界、合同深度、最小防回归、引用与历史保护”；不以压缩百分比决定删除条款。
+
+## 0.6.17 续办设计（2026-09-19）
+
+### 本轮审查结论
+
+- 已落实：三份项目入口技能共 5411 → 3981 字节（减少 26.4%）；其中 continue 为 2685 → 1640 字节（减少 38.9%），移除重复阶段表。当前任务查询实测输出由完整会话的 5320 字节缩为 123 字节，但只覆盖任务身份，仍须另读任务合同，不能把它当作等价上下文或 token 节省比例。
+- 大规约：10 份 spec 标题盘点未发现重复二级标题；大文件主要由各场景合同累计形成。本轮增加定位指引，不凭文件大小删除场景或迁移历史链接。新增指引使部分文档略增，目录总大小没有作为优化目标。
+- AGENTS：6072 字节，现有核心条款已经覆盖按需读取、同范围不重复确认及风险验证。本轮保持原件，不增加 GPT-6 专属长规则，也不降低安全/审批要求。
+- Skills：盘点 12 个项目技能。5 个既有精简入口保留，其中 start/before-dev 进一步压缩；continue 补齐。官方 bundled meta/session-insight 的描述仍偏长（525/552 字符），保持上游来源，不把业务定制塞入公共目录。channel 等未触发时不加载正文；不因当前 inline 删除可选能力及其他工具可能依赖的全局技能。
+- 经验沉淀：采用“原章节维护稳定规则、task/evidence 保存当次事实”的方式；不再复制阶段路由或当次结果。既有 22 个未登记文档提示和旧 CSV 工具缺项不扩大为本轮清理。
+- 新会话：尝试新进程 skills/list 时 Codex CLI 不在 PATH，记 NOT_RUN；静态 frontmatter/引用/入口合同可验，但本会话目录缓存、实际选技和 token 用量未测。未安装新 CLI 或修改全局配置来弥补该缺项。
+- 独立复核：本轮上游 runtime/workflow 增量仍需独立只读 review；当前 inline 未派 implement/check 代理，记 PENDING。不能把历史 0.6.16 独立 PASS 移用于 0.6.17。
+
+### 来源与现状
+
+- npm latest/本机 CLI=0.6.17，项目=0.6.16；beta=0.7.0-beta.4，不纳入本轮。
+- 官方 v0.6.17 migration manifest：breaking=false、recommendMigrate=false、migrations=[]。修复缺少当前 session id 时误认其他会话任务、archive 中断时恢复子任务 parent；另更新 mem 与子代理上下文入口。无文件迁移。
+- 官方指南：https://developers.openai.com/blog/rethinking-skills-and-prompts-for-gpt-6-astra 、https://developers.openai.com/codex/skills/ 、https://developers.openai.com/codex/guides/agents-md/ 。已实际抓取正文。要点是精确触发、渐进读取、给出完成边界并避免重复确认，不据模型更强删除项目安全约束。
+- 基线：342 项 Git 状态条目；10 份 hyb-oa spec 共 679071 字节，workflow 42074 字节，AGENTS 6072 字节；46 份项目技能 Markdown 共 235792 字节。技能目录总大小并非默认注入量。
+- 既有归档升级经验已沉淀于 project-governance；本轮上下文足够，不读取无关原始会话或真实配置。
+
+### 最小批次
+
+1. 官方 update：只自动更新预览列出的 active_task.py、task_store.py、session-insight 的 SKILL/CLI reference、Codex inject-subagent-context.py。11 个本地冲突先生成 .new，再对照本轮备份/上游内容逐项处理；保留现有 task.py/task_context.py 的 inline 与 seed 合同、config、gitignore、workflow 和精简技能。不手改模板哈希，不 force。
+2. 读取入口：trellis-start 先查官方 current/source，trellis-continue 移除默认全量 get_context 和重复路由说明；before-dev 明确先定位章节再读完整相关合同。保留 PRD/计划批准、检查、独立 review 与提交授权边界。
+3. 经验整理：spec index 提供主题路由与大文档章节检索方式；project-governance 和 Agent 开发交付实践只补稳定读取/沉淀规则。workflow 的 no_task 口径与已有“复用/已授权”规则对齐；inline breadcrumb 明示相关章节和授权边界。保留阶段号和上游多平台参考，不做大规模拆分或搬迁历史经验。
+4. 本轮不改公共 bundled skills 的业务规则，不新建一套 GPT-6 专用技能，不改模型/推理强度/全局 Codex 设置。审查的全局技能仅限本会话已提供的元数据及任务相关正文；不宣称已审全部全局专业资源。
+
+### 验证与回退
+
+本轮证据根为 artifacts/qa-governance/trellis-0617-context-20260919；before/ 保存允许更新的原文件，protected-before.json/working-before.diff 保存 3070 路径状态及旧差异。执行官方 update 前已备份，dry-run 的潜在写入也纳入对照。
+
+只运行 Trellis/规则定向回归与流程文档门禁，不因治理升级重跑 4437 后端、372 浏览器或恢复演练。session 绑定和 archive 回滚用临时合成任务验证，不归档真实任务。后置 dry-run 应无新自动更新，已明确的本地定制可以保留；清点本轮 .new/备份并收口，不删除旧证据。
+
+失败时按 before/ 逐文件恢复本轮改动，必要时用固定 CLI 0.6.16 配套旧模板；不整树 reset/stash。高风险运行时变更的独立只读复核在当前 inline 限制下保留 PENDING，主会话测试不代替。
+
 ## 基线和证据

 2026-09-05：全局 CLI 与项目模板均为 0.6.12；npm latest 为 0.6.16，beta 为 0.7.0-beta.3。Node.js 22.22.2 满足目标包要求，CLI 软链接目标与 npm 全局 prefix 一致。
@@ -1,5 +1,69 @@
 # 执行清单

+## 知识精简独立静态复核接收（2026-09-19，最新）
+
+- 已读取用户交回的 Claude 原报告 `artifacts/qa-governance/knowledge-pruning-claude-review-20260919T023533Z.txt`：本轮知识精简 **PASS，无必修项**。比较基线为本轮 before/ 与 incremental-review.diff，独立于 0.6.17 升级批次；仅覆盖指令与静态合同。
+- Reviewer 无 shell，以逐行内容比对核对12份输入，未运行命令或重算 SHA。接收前主会话另行重算 final-inputs.json 所列12份输入，全部匹配；这是主会话的输入完整性检查，不归为 reviewer 实测。本次接收仅追加 implement.md 和 task.json 的结果记录，不改受审技能、指南或 spec。
+- 唯一非必修建议按观察项保留：基础设施类示例若在实际执行中因缺失造成理解偏差，再评估收紧；当前没有该问题证据，不恢复强制模板。当前客户端刷新、真实用户配置下发现、模型实际选技及 token 节省仍未验证，原22份未登记文档提示保持。
+- 知识精简批次的独立指令/静态复核门禁已通过；原 final-inputs/final-checks 中的 PENDING 是交审时点记录，保留原件，以新增 review-reception-20260919 证据为后续状态。业务补审 b1rubx7qf 仍在外部进行，本结论不覆盖业务候选或其发布资格。
+- task 保持 review；历史 G1–G10 用户级复核欠项单列。不提交、推送、归档、部署或扩大精简范围。
+
+## 自主经验维护批次（2026-09-19，最新）
+
+用户已授权自主优化经验、skills 和 specs；范围/设计见同 task 顶部。原0.6.17独立PASS保持，本增量不冒用该结论。
+
+- [x] 核对官方 current、技能/规约正文和实际调用者，保存12文件副本及3070路径保护基线。
+- [x] 精简三份技能，去掉固定教学模板、伪概率及未经授权提交/上游写入要求。
+- [x] 精简三份思考指南，修正重复即抽象/只校验一次等泛化规则。
+- [x] 合并证据规约重复示例，保留字段、状态、错误、测试与隐私合同。
+- [x] 完成契约保留核对、skill validator/引用/真实隔离发现、task/process/docs/governance/diff与保护检查。
+- [x] 记录增量、实际字节变化及独立行为复核限制；无提交、部署、全局配置或业务修改。
+
+本轮完成情况：
+
+- 三技能 brainstorm/break-loop/update-spec 共27717→6712字节（-75.8%）；三指南11892→4564（-61.6%）；证据规约/索引12879→11123（-13.6%）；8份文本合计52488→22399（-57.3%）。这些是文件字节，非实际token节省；本轮PRD/design/结果记录另计。
+- 将已授权范围自主推进写入当前规划语义，仍保留真实用户决策/批准和独立复核边界；删除机械七段式、泛化抽象阈值、概率表、擅自提交及跨项目模板写入要求。新经验应在原归属章节维护，不为每次修复增加长模板。
+- 12项主会话契约保留核对通过；docs-and-evidence的31个标题全部保留，无内部锚点破坏。三个skill-creator quick_validate均通过；引用/锚点、task/process/docs/Trellis敏感扫描/diff通过，22份既有未登记文档提示保留。
+- 现有Codex0.125.0在空白用户目录/禁网/项目只读隔离中真实skills/list(forceReload=true)：12个项目技能、0错误，本轮3个技能来源/描述/启用匹配。未读真实用户配置/密钥、未改HOME/CODEX_HOME、未启动模型turn；不证明真实客户端刷新、模型实际选技或独立行为评估。
+- 模板预览无自动待更新，14个本地定制提示符合预期（新增break-loop/update-spec，brainstorm原已定制）；模板哈希未改。此次只改变指令/规约，不重跑输入未变的50个runtime或4437/372业务全量。
+- 3070路径保护核验仅12个本轮允许文件变化；1076个r6业务输入及11个原始证据SHA保持，HEAD/index、runtime、workflow、AGENTS、全局/官方bundled skills不变。
+- 证据根artifacts/qa-governance/knowledge-pruning-20260919：size-comparison、contract-preservation-review、validation、isolated-skill-discovery、protection-check、incremental-review.diff及final-inputs。增量基线为本轮before/，旧交审包保持。主会话审阅/静态检查/真实发现分列，本轮新指令的独立行为复核未执行，旧Trellis独立PASS不抵扣；task保留review，不归档。
+
+## 2026-09-19 Claude 复核接收与技能发现纠正（最新）
+
+用户提供 Claude 独立只读报告：本轮 18 个受审路径全部覆盖，Trellis 升级/精简 PASS；其另跑既有回归 50/50 和上游探针 7/7。按用户提供的外部复核结果登记，未取得其 scratchpad 原始日志，不冒称主会话新跑或覆盖原证据。接收前主会话重新核对原 final-inputs.json，18 项均一致；以下仅补任务记录，不改受审 runtime/skills/spec。
+
+- Claude 会话 current=none 是正确的会话隔离行为；本会话 current=本 task 不应被当作跨会话保证。
+- 更正原“找不到 Codex CLI”判断：npm 全局 prefix 下已有 0.125.0，仅不在当前 PATH。主会话已通过实际 --version、app-server 协议 schema 核实；该版本支持 skills/list 和 forceReload。Claude 对 mcp-server 调用返回 method not found，不能证明 app-server 不支持，不据此升级 CLI。
+- 已用现有 CLI 完成真正的新进程 app-server initialize/skills/list(forceReload=true)：12 个项目技能、0 个加载错误，start/continue/before-dev 来源和描述匹配。采用 bubblewrap 空白 Codex 用户目录、禁网、项目只读；HOME/CODEX_HOME 环境值未改，真实用户配置/凭据被挂载隔离，未修改全局文件或启动模型 turn。
+- 本项结论为 PASS_ISOLATED_HOME；真实用户配置下的发现、当前客户端刷新/选技、token 节省仍未验证。Claude 报告的全局 config 类型错误记外部观察，主会话未读取该文件，不直接采纳改全局配置/升级 CLI 的建议。
+- 本轮 Trellis 独立复核门禁可关；历史 G1–G10 全局技能完整复核及真实客户端限制继续单列，task 保持 review，不提交或归档。
+
+新增证据：artifacts/qa-governance/trellis-0617-review-followup-20260919。原 final-checks、fresh-skill-discovery 的 NOT_RUN、交审 diff 和回执均保留，它们描述原检查时点；当前实际结果以新增证据为准。
+
+## 当前批次：0.6.17 与上下文精简（2026-09-19）
+
+按用户本轮升级和审查要求，续办既有稳定版升级、保留本地定制、按需加载与规则精简方案；最新具体边界见 PRD/设计顶部。历史独立提交/合入授权不用于本轮。
+
+- [x] 官方 current/source、CLI/npm/项目版本、上游迁移清单及官方 GPT-6 指南核对。
+- [x] 核对既有治理任务、经验和技能入口，保存受管文件及旧差异保护基线；目标版 dry-run 完成。
+- [x] 官方保守更新并逐项处理 .new；保持 inline、关闭自动提交及 seed 加固。
+- [x] 收紧当前任务/规约读取入口，补主题路由与可复用经验的精简原则。
+- [x] 实际 Python 兼容、既有 Trellis 定向回归及新增上游行为的合成探针。
+- [x] task/context/hook、process/docs/governance/sensitive/diff、后置 dry-run 与任务外保护核验。
+- [x] 记录字节度量、实际覆盖、独立 review 和新会话限制，交付增量审查包。
+
+本轮结果：
+
+- CLI 和项目 0.6.17；5 个上游文件更新，11 个冲突保留定制，全部 .new 原件和官方自动备份移入本轮证据目录保存。后置 dry-run 无自动待更新项，12 个提示均为保留的本地定制（比升级前新增 continue 定制），模板哈希再次预览后未变。
+- Python 3.9.2 对 31 个 runtime/hook 文件实际编译通过；既有两文件回归 50/50 PASS。新增临时合成检查 7/7 PASS；同探针对升级前备份 4 FAIL / 3 PASS，保留负向日志。合成归档检查只证明子任务 parent 链恢复，上游失败时父任务仍标 completed 且留原处，不夸大为整项回滚。
+- task validate/current/list、phase、真实 hook 路由（既有回归）、process/docs/Trellis（含敏感扫描）及 diff 检查通过。文档登记仍有既有 22 项提示；历史 CSV 校验未运行，本轮未改 CSV。
+- 3070 路径保护基线仅 18 个本轮允许路径变化；业务代码、旧任务、HEAD/index 保持。r6 的 1076 个代码输入及 11 个已有原始证据文件 SHA 复核保持；当前新增治理/spec/文档变化不被旧发布回执覆盖，deploymentEligible=false。
+- 字节度量见 size-review.json；来源、冲突、升级日志、探针及旧证据核验均在本轮证据根。incremental-review.diff 以本轮 before/ 为基线，不使用 HEAD 混入 342 项旧差异。
+- 本地实施与可执行检查完成，任务回到 review。独立复核 PENDING；新进程技能发现 NOT_RUN（缺少 Codex CLI），当前客户端实际刷新/选技未验证。未提交、推送、归档、部署、启用编号或更新其他工作树。
+
+当前无业务实施、提交、推送、归档、部署或生产操作。原官方 current 为 09-06-release-gate-integrity，原任务及回执状态保留，治理续办用本 task。
+
 ## 授权与阶段

 用户已审阅落盘方案并批准 CLI 升级与项目只读预览，随后于 2026-09-05 批准本文件第二阶段四个补丁批次。任务为 in_progress，按该范围实施并验证，不重复申请同一授权；提交、归档、部署与业务修改仍未授权。
@@ -1,5 +1,37 @@
 # Trellis 升级与规则精简

+## 经验维护自主优化授权（2026-09-19，最新）
+
+用户明确授权主会话自主决定经验、skill、spec 的优化改进或精简。本轮在既有治理任务中维护项目技能/思考指南/经验规则，无需逐份文本再次确认；不扩展为业务变更、验收降级、全局配置修改、提交部署或旧证据删除。
+
+- M1：压缩 brainstorm/break-loop/update-spec 的重复教程与机械模板，保留规划批准、证据与明确的不变量；消除未经授权提交、修改上游模板、强制猜概率等错误指令。
+- M2：精简项目思考指南，按共享契约风险决定复用和跨层验证；保留服务端信任边界与事务内必要重验，避免“只校验一次”等泛化误导。
+- M3：经验沉淀按事实归属更新已有章节，不默认新增七段式案例；精简证据说明的重复示例，保留历史证据和全部可执行门禁。
+- M4：提供本轮增量、字节变化、技能真实发现和治理检查；静态/加载验证不冒充模型行为评估或独立审阅。原升级独立 PASS 不覆盖本轮新技能修改。
+
+本轮验收：
+
+- [x] 三份技能与三份指南精简完成，关键契约有保留映射。
+- [x] 证据规约重复说明压缩，原状态、错误和验证边界保持。
+- [x] skill frontmatter/引用、真实隔离发现、task/process/docs/governance/diff 与任务外保护核验通过。
+- [x] 当前结果、外部复核范围、未验证部分如实交接；未修改业务代码、全局配置或原回执。
+
+## 本轮续办（2026-09-19）
+
+用户要求现在升级 Trellis、按官方指南更新相关文件，并审查既有经验和 skills，结合 GPT-6 减少上下文消耗。本轮复用该任务的稳定版升级、保留定制、按需读取与规则精简范围；下文 0.6.16 和历史提交授权只说明历史，不沿用为本轮提交授权。
+
+- R5：CLI 已为 npm latest 0.6.17，将执行树的 0.6.16 模板保守升级到 0.6.17；不选 beta，不重装已匹配 CLI。
+- R6：以官方 GPT-6 Astra 和 Codex skills 文档为依据，审查重复入口、过宽触发及大文档读取；改进项目内的读取路由，保留既有合同与历史经验。
+- R7：量化文档/入口字节和读取路径变化；静态字节不是模型实际 token 节省，不虚报新会话行为。
+- 边界：仅指定执行树。保留所有业务差异、冻结包、回执及旧失败；不读真实配置/密钥/备份，不改用户级技能或其他工作树，不提交、推送、归档、部署或启用生产编号。历史全局技能独立复核欠项保持。
+
+本轮验收：
+
+- [x] A17：项目和 CLI 均为 0.6.17，官方迁移清单/更新预览/冲突处理留证，定制与 inline/禁止自动提交保持。
+- [x] A18：续办/开发入口按需读当前任务与相关章节，经验原文和引用可用；未将模型能力当作权限或验收豁免。
+- [x] A19：Python 实际运行时、Trellis 定向回归、task/context/hook、process/docs/governance/diff 检查及任务外保护核验完成。
+- [x] A20：精简收益、未实施建议、独立复核和新会话验证状态分别记录；不复用旧业务回执证明新整树发布资格。
+
 ## Goal

 先完成全局 Trellis CLI 稳定版升级与当前项目只读更新预览，再提出按来源、任务和风险分层的规则精简方案。全局只做一轮，项目分别处理，不因模型升级直接删除必要保障。
@@ -21,6 +21,6 @@
  "children": [],
  "parent": null,
  "relatedFiles": [],
-  "notes": "",
+  "notes": "2026-09-17 W8本地对账：seed分离已随b87cc55发布，init阶段validate_config→migrate→check_required_configuration且无seed；已有合成PG/组合110回归及有限独立review保留，不重做已实现分离。 原回执从主副本接回，见implement顶部；本轮无新的远端/提交发布，原验收未补勾。\n",
  "meta": {}
 }