Skill practices: quiet test wrappers, targeted diffs and file ranges, grep logs, batch tool calls

This commit is contained in:
2026-11-04 13:12:21 +00:00
parent 66b5f564b4
commit c188b36d95
+14 -3
View File
@@ -62,8 +62,19 @@ below (errors block publishing; warnings print and do not).
## Commands and scope
- **Quiet commands**: summary flags, `git diff --stat` before a full diff,
`grep`/`glob` before `read`, read file ranges rather than whole files, tail or
filter long logs, never print generated or vendored files.
Every earlier tool result is re-sent on each later model call, so output a stage
reads once is paid for on every call after it.
- **Quiet commands**: use the project's quiet/summary test or analyze wrapper
(failures only plus a log path) and summary flags; never print generated or
vendored files.
- **Diffs**: `git diff --stat` or `--name-only` first, then `git diff -- <path>`
only for the files you need. Never a full diff or `git log -p`.
- **Files**: `grep`/`glob` first, then read only the relevant line range. Read a
whole file only when it is short or mostly being edited, and do not re-read a
file that has not changed.
- **Logs**: when a test log is needed, grep the log path for the failing test
instead of reading the log whole.
- **Batch independent tool calls** into one step instead of one call per step.
- **Small task scope**: one independently testable change per run (roughly a
10–15 minute change). Split larger work into several runs in parallel.