升级Trellis并精简项目知识（09-05-trellis-upgrade-rule-cleanup）
更新Trellis适配、任务归属与归档失败恢复，精简技能入口和知识读取规则。 保留权限、证据、事务及独立复核合同；纳入对应任务及已完成复核记录。 仅本地提交，不启用新平台适配，不推送或部署。
这个提交包含在：
@@ -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 一致。
|
||||
|
||||
在新工单中引用
屏蔽一个用户