dsh-trim-cot-leakage
Use when auditing or fixing prose that reads like a leaked reasoning transcript — dead design-session citations such as (decision N), audit item codes, or §N of uncommitted drafts; change narration such as "used to", "no longer", "this cut"; stack or review vantage ("a later PR in this stack", "rejected in review"); reviewer-addressed justifications; control-flow narration; or hedged planning residue in comments, JSDoc, docs, or Agent Notes.
- License 许可
- MIT
- 最近更新
- 2026-09-10
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- dsh-trim-cot-leakage
- description
- Use when auditing or fixing prose that reads like a leaked reasoning transcript — dead design-session citations such as (decision N), audit item codes, or §N of uncommitted drafts; change narration such as "used to", "no longer", "this cut"; stack or review vantage ("a later PR in this stack", "rejected in review"); reviewer-addressed justifications; control-flow narration; or hedged planning residue in comments, JSDoc, docs, or Agent Notes.
02 资源文件 2
- 参考文档references/examples.md11.0 KB
- 参考文档references/recall-batteries.md3.6 KB
03 SKILL.md 正文
Trimming Chain-of-Thought Leakage
Chain-of-thought leakage is prose whose vantage is the authoring session rather than the repository: it cites artifacts only that session could see, narrates the change instead of the state, or argues with a reviewer who has left. The fix is never deletion alone when a passage carries factual clauses — restate each so it stands at HEAD, then delete the transcript around it; a passage carrying none (an audit code, control-flow narration) is deleted outright. REQUIRED BACKGROUND: dsh-prose-standard owns the complete-proposition rule this skill applies; the committed-artifact-citations note owns the citation rule's rationale. It is guidance, not a script.
The one test
For every suspect passage ask: could a reader at HEAD, with no access to any session transcript, PR thread, or uncommitted draft, resolve every reference and verify every claim? If no, restate the surviving facts from the repository's vantage and delete the rest. If yes, it is not leakage, however historical it sounds — but resolvability only clears this skill's bar: on current-state surfaces (READMEs, docs, JSDoc) a resolvable change story is still change narration, and class 3 routes it to its sanctioned home.
Taxonomy
- Dead design-session citations —
(decision 7),(audit C2),design §4.7,plan §1.4, phase labels (T4,W3,P-I), "the design ledger", "(B ruling)". If the decision has a committed owner, cite it by name and path; otherwise delete the citation and restate its factual clause to stand alone. - Stack and PR vantage — "a later PR in this stack", "this PR adds", "the previous commit". State the shipped mechanism or the extension point; deferred work moves to a
TODOmarker or an issue reference. - Change narration and version stamps — "used to", "no longer", "the old X", and indexical stamps ("v1", "this cut", "today", "now" contrasting with a past state). State the present behavior; a fixed regression becomes a present-tense counterfactual ("without X, Y happens"), never repo history ("used to Y").
- Review choreography — "Rejected in review:", "the reviewer confirmed", draft ordinals ("v5 of this note"), round attributions. Keep the surviving decision and rationale as plain fact; delete who said it when.
- Reviewer-addressed justification — "the cast is safe — it simply…", "this is correct because…". A comment arguing its own correctness addresses a reviewer, not a maintainer. State the invariant that makes the code safe, or delete the comment if the code shows it.
- Restatement and derivation transcripts — control-flow narration ("first we X, then we Y"), test walkthroughs, proofs of obvious branches. Delete; keep only a non-obvious contract or invariant.
- Hedges and planning residue — "probably fine for now", "should be enough", deferrals with no marker. Promote to
TODO/FIXMEor restate as the actual bound; delete the hedge. - Authoring-language slips — untranslated working-language fragments (端, 设计稿,
---- 私有 ----separators) in prose whose language is otherwise English, or the reverse in a zh counterpart. Translate or delete.
What is not leakage
Unaided citation passes fail in both directions by deleting durable references and keeping dead ones. Apply these keep rules as written; examples calibrates each:
- Issue references —
#1470,TODO(name):, "issue #N owns the follow-up" resolve at HEAD; keep them on any surface, including READMEs. Do not relocate them to Agent Notes. - Merged-PR and issue citations inside Agent Notes and postmortems — sanctioned evidence per the documentation standard's change-story routing.
- Suppression justifications —
oxlint-disable … -- reason, coverage-ignore reasons, empty-catch explanations are required prose; fix a false reason, never delete it. - Counterfactual-present regression pins — "without X, Y happens", "a naive X would…".
- Measured bounds — "(measured: 512 nests ≈ 0.15s)" calibrating a constant; the provenance word "measured" is load-bearing.
- Runtime old/new states — "the old connection drains before the new one accepts" is runtime lifecycle, not change history.
- Historical stage names inside a note's change-story sections — "the first cut shipped X" is current-state-safe there; indexical stamps ("this cut") stay banned everywhere.
- External references that resolve outside the repo by design — standards sections (RFC 9110 §10.1.5), Figma frame names; the §-ban covers uncommitted internal drafts, not external standards or committed docs that own their §-numbering.
- Project voice and genre forms — "we" as project voice; a note's Alternatives-considered section.
Workflow
- Scope and exclusions per dsh-prose-standard: require an explicit scope; never touch
vendor/,.agents/notes/archived/, or recorded fixtures and snapshots — recorded model output and sealed history keep their original voice. - Audit read-only first: run the recall batteries (with
--hiddenso.agents/is searched), then judge every hit semantically. The batteries are probes, not the definition — each review round of the original purge found cases the batteries missed, so also read the densest prose in scope (module JSDoc, READMEs, Agent Notes) without a pattern in hand. - Fix owner-first per surface: generated catalogs → fix the source JSDoc or generator template, then regenerate; type-equivalence fences → fix the source JSDoc, then re-paste both bilingual pages (
verify-type-equivpins them); bilingual pairs → update the counterpart and re-record per dsh-translate-docs; model-visible strings → wording is behavior, so flag for a snapshot-backed change instead of silently rewording. - Before deleting anything, enumerate the passage's propositions (prose-standard) and check the overcorrection traps: trims that flip an obligation into an endorsement, promote a hypothetical to a shipped feature, delete a true fact, or drop provenance.
- Verify: re-run the batteries expecting only sanctioned keeps, this skill's own directory, and the owning note's quoted evidence; confirm every remaining citation resolves at HEAD; run the gates for touched surfaces (
doc-syncfor docs,verify-type-equiv,verify-translation-pairing).
04 同仓库更多 Skills
short-drama-domain
Short-drama project object map and task routing. Use when the user works with screenplay artifacts, episode scenes, continuity, diagnosis, revision, or delivery. This skill provides operational vocabulary and questions, not a mandatory writing style.
creative-project-organization
从梗概开始创作、生成设定/人物/大纲/正文等文件时,在首批落盘前规划内容分组和保存位置;新增独立交付物时复核布局。自动适配项目语言和命名习惯,也用于用户要求的项目整理。无需用户提出归档要求。
skill-sink
技能沉淀机制:把创作中验证有效的经验、方法论与个人文风,提炼成可复用的 DSH skill。当创作中发现可复用经验、用户要沉淀个人文风、或要把反复出现的规则固化成技能时使用。
short-drama-zonggang
短剧创作总纲与情绪账务引擎方法论。以「恨账—存债/付息/兑付」债务系统为内核,覆盖选题、故事骨架、压爽循环与卡点、付费闸门、台词正文格式、验收自检与失效模式库。当用户要创作短剧剧本、立项选题、写分集大纲、写正文台词、设计付费卡点,或评审/修改/验收短剧时,先加载本 Skill。
short-drama-structure
把已确认的故事前提排成短剧四幕二十拍、分集节奏和场次骨架(4×5 节拍表、卡点与高潮兑现)。当用户已有故事梗概,要求拆成四幕/20 拍/分集/场次表、中段松散需要重排转折,或想设置悬念、反转、付费卡点及高潮兑现路径时使用。不适用于从零提炼创意、单场对白润色或平台投稿咨询。
short-drama-scene
当用户提供剧本片段、分场或对白,要求更可拍/更有戏/减少解释/改得口语化时调用;重点处理单场冲突、动作进出、状态变化、信息差、潜台词和对白瘦身。不适用于从零搭故事结构、设计整部剧的悬念卡点或行业投稿咨询。