mirror of
https://github.com/wassname/ml-debug.git
synced 2026-06-27 16:15:57 +08:00
Document quote-first evidence style
This commit is contained in:
@@ -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.
|
||||
Reference in New Issue
Block a user