Skill practices: quiet test wrappers, targeted diffs and file ranges, grep logs, batch tool calls
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user