Document quote-first evidence style

This commit is contained in:
wassname
2026-06-25 09:56:26 +08:00
parent 20f03f20b8
commit 67d4dc90bb
3 changed files with 66 additions and 216 deletions
+21
View File
@@ -0,0 +1,21 @@
# Local Instructions
## Quote-first evidence
When adding evidence or appendix material for this skill, prefer the expert's
own words over assistant synthesis. These sources are high-level SME material,
often above current frontier LLM taste and more diverse than model priors.
Quoting them is grounding data; rewording them injects assistant bias.
- Use generous quote blocks, usually 2-3 sentences or a full paragraph.
- Preserve the author's paragraph flow. Do not insert blank blockquote lines
between sentences from the same paragraph; it makes expert prose harder to
read and adds fake structure.
- Keep editorial text sparse and mostly for routing: why this source is here,
when to read it, and what local file it supports.
- Do not atomize useful source material into tiny one-line quotes when a longer
block preserves the author's reasoning.
- Put lower-relevance sources in "See also" rather than forcing a synthetic
narrative around them.
- In `SKILL.md`, link to reference docs like `refs/research_taste.md` instead
of copying a long assistant-written summary.