editing-long-documents-consistentlylisted
Install: claude install-skill zhaiby-web/ai-coworker-skills
# Editing Long Documents Consistently
## Core Rule
For a semantic fact change, the edit unit is every active instance of that fact, not the sentence named by the user. A small diff is desirable only after the full semantic impact surface is known.
Do not modify files outside the task's authorized scope. This Skill strengthens consistency checks; it does not expand write authority.
## Workflow
### 1. Establish Current Truth
Read the authoritative source and the relevant complete sections before editing. Distinguish the new effective fact from historical records and unresolved alternatives.
### 2. Search Before Editing
Search the whole active artifact and build an impact list covering:
- the old value, conclusion, status, version, ID, and relation;
- synonyms, paraphrases, negative forms, and competing statements;
- headings, tables, summaries, conclusions, checklists, and examples;
- `见 §X`, section-number references, and passages that summarize the changed section.
Search hits are navigation candidates, not semantic proof. Read enough surrounding context to classify each hit as active, historical, quoted, or unrelated.
Before adding the new fact, answer explicitly: **Which existing statements does this make obsolete?**
### 3. Edit the Complete Impact Surface
Update every affected active statement in the same edit cycle. Remove obsolete active claims or move them into an explicitly labeled historical or `superseded` record when audit history must remain.
Do not l