agentleFS
enstwenstw/thesisbug2/.agents/skills/flow-check/SKILL.md

flow-check

Skill0 starsChanged 6 days agoMITView on GitHub

Discourse-coherence gate for long-form manuscripts: finds places where every sentence is correct but the argument jumps (跳躍感). Use for /check_flow, when the user mentions 連貫 / 不連貫 / 跳躍 / 逆向大綱 / coherence / 銜接, after a batch of incremental insertions, or before a milestone, 口試, or submission. Runs reverse outline, connective naming, a fresh-context cold read, cross-chapter consistency, and git-seam targeting; outputs a severity-ranked 跳躍點清單 with proposed bridge sentences and rewrites nothing.

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Run 1–3 per chapter, 4 once across chapters, 5

    line 25
  2. Distinctive:

    Run the chapters sequentially or use parallel agents when available and authorized.

    line 84
  3. Distinctive:

    No fact checking, no citation form (cite-check), no whether-a-source- backs-the-claim (source-kit § Source review), no cross-strait usage …

    line 94

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

flow-check — 篇章連貫檢查 (discourse coherence gate)

LLM-generated prose is locally fluent but globally unplanned: each sentence is conditioned on its neighbours, while "does this paragraph's role in the chapter's argument hold" is maintained by no one. Incremental revision makes it worse — every 入章-style insertion splices fluent text between two sentences that were originally written as one continuous move, leaving a seam that is invisible sentence-by-sentence. This skill finds those seams and ranks them; it changes nothing by itself.

The five checks

Run 1–3 per chapter, 4 once across chapters, 5 first whenever git history is available (cheapest, highest hit rate).

  1. 逆向大綱 (reverse outline). Compress every paragraph to one sentence: "this paragraph's claim is X." Then read only the outline. Flag: adjacent claims that don't connect, a claim unrelated to its section heading, the same claim appearing twice.
  2. 銜接命名 (connective naming). For each adjacent paragraph pair, force an answer: "the implied connective between ¶N's end and ¶N+1's start is ___ (因此/然而/此外/例如/回到⋯⋯)." Cannot name one → seam. This is objective where "does it read smoothly" is not.
  3. 冷讀 (cold read). A fresh-context reviewer reads the chapter text and nothing else, marking: places it had to re-read, terms/entities appearing without introduction, abrupt topic shifts. Isolation is the invariant: the cold reader gets no outline, no other chapters, no conversation history — a reader with full context cannot feel the jumps because their brain silently supplies the missing bridges. (This is also why the author agent must not grade its own chapter.) "Fresh" means spawned empty: a context-inheriting subagent (a forked conversation, a resumed session, a teammate that saw the drafting) carries the bridges with it and is disqualified — use a plain new agent whose whole prompt is the chapter text plus the marking instructions. A bigger context window changes none of this: the point is what the reader has not seen. A separate clean session is equivalent to a fresh subagent. If neither is available, prepare a handoff containing only the chapter and marking instructions, run the other checks, and mark the cold read pending; never call a same-context re-read independent.
  4. 跨章一致 (cross-chapter consistency). One agent over the per-chapter outlines from layer 1 (not full text): terminology drift on core concepts (the manuscript's own coinages — is the same mechanism named the same way in every chapter?), theory-chapter concepts actually used in the case chapters, comparison-chapter dimensions matching case-chapter section structure, and every 「如第X章所述」-style reference resolving to something that exists and says what is claimed.
  5. git 接縫定位 (seam targeting). git log --stat -- <manuscript files> to list late insertions and heavily-patched spots; check the ±3 sentences around each insertion point before anything else. Seams concentrate here.

Output: 跳躍點清單

One severity-ranked list, 章:節/段 → 類型 → 說明 → 建議橋接句:

類型Meaning
斷裂adjacent paragraphs with no nameable connective
接縫insertion seam — flow breaks exactly at a patched-in block
漂移the manuscript's own term/register changes across chapters
未介紹entity/term used before it is introduced
失指「如第X章」-style cross-reference that doesn't resolve or misstates
重複same content re-introduced as if new

Each 建議橋接句 is a proposal for the author to confirm — same scan-and-propose discipline as fix-terms. A bridge sentence must not alter any cited claim (house-style reference/content-integrity.md): if the only way to connect two paragraphs changes what a source is made to say, report the gap as structural instead of papering over it.

Orchestration

Run the chapters sequentially or use parallel agents when available and authorized; isolation of layer 3 matters, not the orchestration API. Do layer 4 over the collected outlines, then deduplicate and rank. For a single-file paper, treat top-level sections as the chapters. Findings from layer 5 seed the other checks ("check these spots first"), but must not be included in the cold reader's prompt because they would prime that independent assessment. State which layers ran and which remain pending in the report.

What it does NOT do

No fact checking, no citation form (cite-check), no whether-a-source- backs-the-claim (source-kit § Source review), no cross-strait usage (fix-terms — that lints against a fixed external rule list; flow-check lints the manuscript's internal consistency with itself). Run order for a full lint pass: fix-terms → flow-check → cite-check (cite-check stays last as the mechanical gate).

Backs the /check_flow macro.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.