content-preflight
Skill1 starsChanged 14 days agoMITView on GitHub
要把网页、日志、大段外部文本读进上下文之前,或会话被内容审核退回(Content Exists Risk / HTTP 400、Compaction could not produce a useful summary)之后 —— 预检工具与「会话手术」工具都在这里。
- Reads credentials
1 other project uses a version of this.
Adopted by
Most recently taken up by
- robdasi/skillstheir own version, first seen Jun 15, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- robdasi/skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository6 other files it gives its agents.
- handoffSkill
- exploration-outsourcingSkill
- grill-meSkill
- writing-for-agentsSkill
- agents-md-auditSkill
- wait-whatSkill
The file
Files
内容预检与会话手术
先看自己在哪个分支。
这份 skill 被两台机器各自维护过,所以正文里凡是「另一份 / 工作区那份」的写法, 对只装了这个包的人都不成立 —— 那些句子已改成「建议在工作区里也放一份」。 只装包的人:
node <本 skill 目录>\preflight.js这一路照用,surgery\就留在 skill 目录下。
分支一:还没读 —— 先预检(预防)
要读对话外的文本(网页抓取、日志、用户给的大文件)之前,把内容落盘,再预检:
node <本 skill 目录>\preflight.js <文件...> 预检这些文件拼起来的内容
node <本 skill 目录>\preflight.js --gap <文件> <a> <b> 二分出最小触发窗口,并用整份删除验证- 退出码四态:
0通过|1被拦(内容审核)|2出错或参数不合法(2 不是「被拦」)|3只有--gap会返回:该窗口单独发就通过 ⇒ 缩窗口不适用(3 也不是「被拦」) - ⚠️ 不是所有 400 都是内容审核(2026-09-18 改):参数写错、模型名不对、配额问题也会 400。
脚本现在按错误码区分 —— 只有内容相关的码才返回
1(被拦),其余返回 2 并把错误正文打出来。 看到 2 先照正文查参数/模型名/配额,别急着做阅读包。 - 200 才读。被拦就:
--gap量窗口 → 做「阅读包」(跳过窗口、其余片段拼成新文件)→ 逐次预检到 200 → 读那份包 - 200 只说明「这一次、这个形状」过了:预检只发 1 条消息,真实请求还带系统提示、工具表、整段历史; 实测同一段文本差一个字符就从 200 翻到 400。所以长材料分批读,单条工具结果别超过 8192 字符
- 用户自己粘贴的文本挡不住 —— 那种要在粘贴之前请用户先存成文件
分支二:已经死了 —— 做手术(救援)
症状:某一轮结束在 Content Exists Risk(HTTP 400),之后那个对话每轮都发不出去。
死掉的对话自己用不了这个 skill(它连一句话都发不出去),所以手术在另一个活着的对话里做:
node <脚本所在目录>\repair-session.cjs --session <会话id> 演练:只算不做
node <脚本所在目录>\repair-session.cjs --session <会话id> --apply 动真格:先备份再追加- 建议在工作区里也放一份脚本(比如
<工作区>\活跃\内容预检\):surgery\建在脚本自己所在的 目录里,内容是plan-*(剪过的正文)、backup-*(整份会话日志)、surface-*(重建的正文) —— 都含会话正文。放工作区就落工作区;直接用 skill 目录那份,就落进~\.dsh\skills\。 (只装包、不在工作区另放一份也完全能用,只是产物落在 skill 目录里。) - 原理:会话日志是只追加的,照 DSH 修剪器的做法补两条事件 ——
compaction/prune记账, 加一条带surfaceOp:{op:"replace",startSeq,endSeq}与sourceEventSeqs的tool/result, 内容剪成「头 4096 + 标记 + 尾 1024」顶掉超长结果。原文不删,仍在日志里可回放 - 做完要重启 dsh 才会生效(按「重启会重放日志」的机制推断);⚠️ 重启到底认不认追加的事件,本身还没真验过(见下面〈边界〉第二条)—— 停着做更保险,运行中做也成功过
- 回滚:备份在脚本自己所在目录下的
surgery\,覆盖回~/.dsh\sessions\<工作区>\session-<id>\session.v3.jsonl.zstd - 核对(推荐):
node <脚本所在目录>\verify-surgery.cjs <会话id> <备份路径>—— 查「只追加保证」(原文一个字节没动)、追加事件形状、被顶掉的原事件还在不在 - 写
~/.dsh在工作区外,沙箱会拦 —— 按规矩把事和代价讲清楚,让用户授权 /compact不是救法(实测:压缩请求自己也被拒),别在那儿花时间- 更省事的一条(前提是进度一直落盘):换新会话,读工作区的交接文件接上
(这套体系的约定是
活跃\交接.md,见handoff那个 skill)
边界(照实说)
- 手术只在一个会话上做过(毒在超阈值工具结果里:11673 字符 → 剪成 5159); 毒在用户消息里、或毒在 ≤8192 字符的工具结果里,没试过
- DSH 重启时认不认追加的事件:目前只做到静态核对(事件信封字段白名单、replace 必须正好三个键、
sourceEventSeqs非空无重复且涵盖被顶掉的表面节点 —— 三条都满足),没有真重启验过 - 预检只判「发得出去」,不判内容对不对
- Web 客户端没有 fork / rewind,「从带毒消息之前分叉」这条路不存在
换台电脑还能不能用(自查过 2026-09-16;安装与排障期才需要读)
- 三个脚本不含任何本机路径:会话目录靠扫
~/.dsh\sessions\*\找(不写死工作区名); 会话目录名两种形态都认(session-<uuid>与裸<uuid>,实测两种都真实存在); 凭证按DEEPSEEK_API_KEY→~/.dsh\.credentials.yaml的顺序取。 - 可覆盖的环境变量:
PREFLIGHT_MODEL(默认deepseek-flash)、DEEPSEEK_BASE_URL、DSH_CREDENTIALS、PREFLIGHT_TIMEOUT_MS(默认 120000 ms)。 - 剪枝预算(头 4096 / 尾 1024 / 阈值 8192)取的是 DSH 修剪器的默认值;那边若改过配置,
同步改
repair-session.cjs顶部那三个常量。 - 依赖 Node 的 zstd 接口(较新的 Node LTS 都带;不确定就先跑一次演练,跑不起来它会直接报错)。
- 要整个目录一起拷(手装时别只拷
SKILL.md):这个 skill 带三个脚本 (preflight.js、repair-session.cjs、verify-surgery.cjs),只拷说明文件的话它就是个空壳。 用包里的install.ps1装不会有这个问题(它是递归整目录拷的)。 - 想在工作区里放一份也可以(比如
活跃\内容预检\):内容一样,好处是surgery\的产物落工作区。 用哪份都行,但别两边混着用 —— 产物会落在各自脚本的目录里。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

