Evidence-Bound-Press-Conference-Revision-Skill README

The project's README from github.com/lensback940701/Evidence-Bound-Press-Conference-Revision-Skill. As one markdown file: README.md.

Evidence-Bound Press-Conference Revision

中文说明

Contribution-forward academic revision without overclaiming.

Co-created on RedNote by @Lensback's Lab and @Naruto AI.

Evidence-Bound Press-Conference Revision

press-conference-revision-evidence-bound is an academic revision skill for diagnosing and reducing defensive writing while preserving the evidentiary limits that make scholarly claims credible.

It is designed for manuscripts whose contribution is already present and supported, but is obscured by repeated caveats, self-defence, work-log narration, excessive qualification, unnecessary comparisons, or contribution statements buried beneath anticipatory responses to hypothetical reviewers.

The skill does not make a paper more assertive by inflating its claims. Instead, it helps a manuscript present its strongest supported contribution clearly while retaining the scope conditions, source-status distinctions, rival explanations, contradictions, methodological limits, and citation functions that determine what the evidence actually permits.

Core principle: remove rhetorical defensiveness, not scholarly caution.


Why “press-conference revision”?

Academic manuscripts often accumulate defensive prose during drafting, co-author revision, peer review, and repeated attempts to anticipate criticism.

The result can be a paper that reads less like an argument and more like a record of everything the authors worried about while producing it:

The press-conference metaphor asks a simple question:

If the evidence is fixed, what should the paper say first about what it has actually established?

A good revision therefore does not conceal weaknesses or manufacture certainty. It reorganizes the manuscript so that the supported proposition leads, while the necessary qualification appears where it performs real analytical work.

The goal is:

contribution → evidence → qualification

rather than:

qualification → self-defence → more qualification → eventual contribution


What this skill protects

The method is intentionally evidence-bound.

Every revision must preserve, or narrow, the original manuscript's epistemic commitments. In particular, the skill protects:

Claim ceiling

A revision cannot increase the certainty, causality, novelty, generality, representativeness, or portability of a claim beyond what the existing evidence supports.

may shape cannot silently become determines.

the interviews suggest cannot become the evidence demonstrates.

in this case cannot become cities generally.

Evidence status

The workflow keeps analytically different kinds of evidence separate, including:

Fluency is never a sufficient reason to collapse these distinctions.

Scope conditions

Case, temporal, population, institutional, geographical, and comparative boundaries remain visible wherever they are needed to interpret a claim correctly.

Rival explanations and negative evidence

Contradiction, delay, non-adoption, decoupling, reversal, failed implementation, and competing explanations are not treated as embarrassing residue when they are part of the empirical record.

Citation and quotation roles

A stylistic revision must not silently change what a citation, quotation, date, number, source-specific term, table, figure, or footnote is being asked to support.

Evidence-Bound Press-Conference Revision


What the skill does

The skill supports two distinct modes.

1. Read-only diagnostic

The manuscript is audited without changing its prose.

The diagnostic produces:

This mode is useful when the author wants to understand whether defensive writing is actually a manuscript-level problem before authorizing changes.

2. Authorized revision

Once revision authority is explicit, the skill can perform a concentrated revision while preserving the evidence ceiling.

Typical outputs include:

The distinction is important: diagnosis does not automatically authorize rewriting.


Workflow

flowchart LR
    A["Phase 0<br/>Contribution & Scope Contract"] --> B["Phase 1<br/>Batch Diagnostic"]
    B --> C{"Author authority<br/>to revise?"}
    C -- No --> D["Diagnostic Register<br/>+ Queries + Recommendation"]
    C -- Yes --> E["Phase 2<br/>Concentrated Revision"]
    E --> F["Phase 3<br/>Whole-Manuscript Regression"]
    F --> G["Tracked + Clean Manuscript<br/>+ Integrity Report"]

Phase 0 — Contribution-and-scope contract

Before editing begins, the skill establishes a compact contract containing:

Field Purpose
Core contribution The strongest evidence-bound statement of the manuscript's primary analytical payoff
Contribution hierarchy Primary concept, supporting lenses, empirical contribution, and portable payoff
Claim ceiling The strongest formulation already permitted by the manuscript and its evidence
Load-bearing cautions Qualifications that must survive revision
Edit authority What may and may not be changed
Live queries Meaning-dependent decisions that must remain with the author

If the contribution hierarchy, evidence ceiling, or editing authority cannot be established, the workflow stops at diagnosis rather than improvising a solution.


Phase 1 — Batch diagnostic

The manuscript is first read as a whole.

The skill does not perform a blind search-and-replace operation. Lexical cues are treated only as signals for contextual inspection.

Candidates are classified using the following taxonomy:

Code Pattern Typical response
D1 Self-deprecation or apology Cut or reframe
D2 Anticipatory defence Cut, tighten, or relocate
D3 Stacked hedge Retain the epistemically necessary hedge
D4 Work-log narration Reframe around problem, solution, and evidence
D5 Buried contribution Reframe or relocate
D6 Unnecessary comparison / volunteered loss Narrow, reframe, or cut
D7 Broad negative self-judgment Tighten to demonstrated scope
D8 Necessary caveat in the wrong rhetorical position Relocate
K1 Scope condition Keep
K2 Source-status distinction Keep
K3 Rival, contradiction, delay, reversal, or non-adoption Keep
K4 Ethical, provenance, reproducibility, or method limitation Keep

The K categories are deliberately visible in the audit.

A high number of KEEP decisions is not a failed revision. It may indicate that the manuscript contains disciplined evidence-bound qualification rather than rhetorical defensiveness.

The unit of judgment is the function of a statement in context, not the presence of a particular word.


The three-question test

Every candidate must pass three questions before it is changed:

  1. What function does this wording serve? Is it rhetorical self-defence, evidence status, scope, method, rival explanation, an empirical result, or several of these simultaneously?

  2. What would disappear if it were removed? The answer must identify the proposition or analytical boundary that would be lost—not simply describe a change in tone.

  3. Does the replacement preserve the ceiling? The new wording must not increase certainty, causality, novelty, generality, representativeness, or portability.

If these questions cannot be answered confidently, the candidate becomes QUERY.


Phase 2 — Concentrated revision

Authorized revisions are performed by pattern group and section role, rather than through global cue-word replacement.

Priority normally goes to:

  1. abstract;
  2. introduction;
  3. discussion;
  4. conclusion;
  5. theoretical positioning;
  6. methods;
  7. empirical sections where defensive rhetoric materially obstructs interpretation.

A major section should normally contain a visible contribution sentence before qualification begins to dominate the paragraph.

Necessary caution remains, but is moved to the location where it does real analytical work.

For example:

Defensive structure

Although this study cannot establish a universally applicable causal relationship and has several limitations arising from its case-specific design, the findings may nevertheless tentatively suggest that...

Contribution-forward structure

The case shows that X operated through Y under these institutional conditions. This inference is limited to the documented case and does not establish a general causal relationship.

The second version is not stronger in evidentiary terms. It is simply clearer about what is supported first and where the boundary lies.


Phase 3 — Whole-manuscript regression

Revision is followed by an independent regression pass.

This is not a proofreading step. Its purpose is to detect whether rhetorical improvement has accidentally altered the manuscript's epistemic structure.

Evidence-bound audit and regression loop

The regression checks:


Candidate dispositions

The audit uses six possible editorial dispositions:

Disposition Meaning
KEEP The wording performs necessary evidentiary or analytical work
TIGHTEN The function is necessary but expressed redundantly
REFRAME The proposition should remain but its rhetorical organization is defensive
RELOCATE Necessary information is currently placed where it obscures the contribution
CUT The rhetoric can disappear without removing a proposition, evidence boundary, or citation function
QUERY The decision depends on authorial meaning or evidentiary judgment

CUT therefore has a deliberately high threshold.

It can remove rhetoric. It cannot remove evidence.


Automated cue scanner

The repository includes a lightweight DOCX cue scanner:

scripts/scan_defensive_cues.py

It can create a preliminary candidate list from a clean .docx manuscript.

Example:

python scripts/scan_defensive_cues.py manuscript.docx \
  --out defensive-writing-candidates.csv

The script currently detects selected lexical patterns associated with:

It uses the Python standard library and reads paragraph text directly from the DOCX package.

Important

The scanner is not an automated editor and not a rhetorical classifier.

A matched cue is only a candidate for human or agent inspection.

The scanner intentionally outputs:

REVIEW_REQUIRED

rather than deciding whether a sentence should be kept, tightened, reframed, relocated, cut, or queried.

This distinction is central to the design of the skill:

lexical detection may be automated; epistemic judgment should remain contextual.


Audit register

The repository includes:

assets/defensive-writing-audit-template.csv

The register records, among other fields:

This makes the revision process inspectable rather than leaving integrity judgments implicit.


Repository structure

press-conference-revision-evidence-bound/
├── README.md
├── README.zh-CN.md
├── SKILL.md
├── agents/
│   └── openai.yaml
├── assets/
│   ├── defensive-writing-audit-template.csv
│   └── readme/
├── references/
│   ├── triage-and-regression.md
│   └── urban-geography-guardrails.md
└── scripts/
    └── scan_defensive_cues.py

SKILL.md

Defines the core workflow, authority order, revision phases, preservation tests, deliverables, and stop rules.

references/triage-and-regression.md

Contains the D1–D8 / K1–K4 candidate taxonomy, three-question test, caution-placement rules, and post-revision regression protocol.

scripts/scan_defensive_cues.py

Provides lightweight lexical pre-screening of DOCX manuscripts. It generates candidate locations but deliberately makes no editorial decision.

assets/defensive-writing-audit-template.csv

Provides a structured audit surface for candidate classification and integrity checking.

references/urban-geography-guardrails.md

Demonstrates how the generic method can be supplemented with project-specific guardrails.

The bundled example protects a manuscript-specific conceptual hierarchy and evidence firewall. It is not required for generic use of the skill.

This illustrates a broader design principle:

generic revision protocol
        +
project-specific evidence/concept guardrails
        =
bounded manuscript revision

Users working with manuscripts that have tightly defined concepts, source hierarchies, or previously agreed author decisions can create comparable project-specific guardrail files.


Installation

Clone the repository into your Codex skills directory:

git clone https://github.com/lensback940701/Evidence-Bound-Press-Conference-Revision-Skill.git \
  ~/.codex/skills/press-conference-revision-evidence-bound

On Windows, the usual destination is:

%USERPROFILE%\.codex\skills\press-conference-revision-evidence-bound

Restart or refresh Codex after installation. Invoke the skill as $press-conference-revision-evidence-bound.


When to use this skill

This workflow is particularly useful when:

It is especially suited to qualitative, historical, interpretive, case-based, and mixed-method research where a small rhetorical change can materially alter what the evidence appears to establish.


When not to use it

This skill is not designed for:

If the underlying problem is weak evidence rather than defensive presentation, this skill should not be used to disguise that weakness.


Example prompts

Whole-manuscript diagnostic

Use $press-conference-revision-evidence-bound to conduct a read-only,
whole-manuscript audit for defensive academic writing.

Do not revise the manuscript yet.

First establish the contribution-and-scope contract, then classify candidates
using the D1–D8 / K1–K4 taxonomy. Keep necessary scholarly caution visible as
KEEP decisions and identify all changes that would require author authority.

Authorized revision

Use $press-conference-revision-evidence-bound to revise the authorized sections
of this manuscript.

Make the supported contribution more visible and reduce rhetorical defensiveness,
but preserve the existing claim ceiling, evidence-status distinctions, scope
conditions, rival explanations, citations, quotations, and conceptual hierarchy.

Run the full regression protocol after revision and report deliberate non-edits
and unresolved author decisions.

Diagnostic with cue scanner

Use the bundled defensive-writing cue scanner only as a candidate-gene

Evidence-Bound-Press-Conference-Revision-Skill (lensback940701/Evidence-Bound-Press-Conference-Revision-Skill)

Searching Database…

这是什么?这是一个面向社会科学研究学术稿件、以证据为边界的修改技能。它会剔除防御性、自我保护式的文风(模糊限定语、工作日志式叙述、预防性反驳),同时保留证据真正支持的每一条适用范围条件、证据状态区分和竞争性解释。
它是独立的编辑器,还是更像工作流指南加一个小脚本?它被打包为一个代理/修改技能(一套结构化的诊断加编辑工作流),并附带一个轻量级的 Python DOCX 线索扫描器,用于标记候选句子供审阅,本身并不是一个完整的编辑器。
实际怎么在稿件上运行它?有两种模式:一种是只读诊断,审计 .docx 并产出贡献契约、候选登记表和 KEEP 决定,不做任何改动;另一种是授权修改模式,在作者明确授予编辑权限后,通过阶段 0-3 执行集中修改。
除了 Python 和一个 .docx 文件,还需要别的吗?不需要额外的软件包。自带的线索扫描器只依赖 Python 标准库,直接从 DOCX 包中读取段落文本。
扫描器会自动改写我的防御性文字吗?不会。它只把词汇线索作为候选呈现出来;每个候选都必须通过三问测试,并被指定一个由人工或代理审核的处理决定(KEEP、TIGHTEN、REFRAME、RELOCATE、CUT 或 QUERY),然后才会改动任何措辞。
这里的 claim ceiling(论断上限)是什么意思?它是一个陈述被允许断言的确定性、因果性、新颖性、普适性或可迁移性的上限。修改可以收紧一个句子,但绝不能让“may shape”这样的模糊限定语悄悄变成不加限定的“determines”。
诊断模式和修改模式的真正区别是什么?诊断模式只产出一份报告——贡献契约、候选登记表和 KEEP 决定——不碰正文。修改模式需要作者明确授权,并输出一份带修订标记的稿件、一份干净稿件,以及一份论断/证据回归报告。
这套工作流如何防止修改悄悄夸大论断?一个独立的阶段 3 回归检查会在编辑完成后核对论断变化、证据状态、引用角色、适用范围和章节角色,专门用来捕捉对原始证据支持范围的任何意外夸大。
Size
3.6 MB
Stars
270
Updated
CommitAug 23
Age
2mo
Commits · 90 Days