csh/playbook
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

📦 deps(skills): sync thirdparty skills

Browse Source
This commit is contained in:
ci[bot]
2026-08-12 12:41:45 +08:00
parent a0131f52c6
commit 073dac13a3
101 changed files with 5290 additions and 3529 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/thirdparty/_shared/common.md
Vendored
+19 -10
View File
@@ -55,6 +55,11 @@ maturity stages. One of:
See **Health Score Calculation** below for the per-preset deduction weights.
**`sweep`** — Full Sweep only. `max_iterations` (default 3) caps how many
non-critical re-scan rounds the sweep pipeline runs before it stops and reports
the remainder as unresolved. Critical findings are exempt from the cap — they
iterate until resolved or retired. Ignored by every other mode.
**Minimal example:**
```yaml
version: 1
@@ -65,6 +70,8 @@ severity:
R1: suggestion
ignore:
- "**/*.generated.*"
sweep:
max_iterations: 3
```
If `.brooks-lint.yaml` contains a `custom_risks` map, read `custom-risks-guide.md`
@@ -109,10 +116,9 @@ When no files or code are specified, detect scope automatically:
## The Six Decay Risks
Navigation index only — canonical definitions (symptoms, severity guides, sources, "What Not
to Flag" guards) live in `decay-risks.md`. Do not duplicate or edit diagnostic questions here;
update `decay-risks.md` directly. Book-level coverage, exceptions, and tradeoffs are in
`source-coverage.md`.
Navigation index only. Canonical definitions — symptoms, severity guides, sources, "What Not
to Flag" guards — live in `decay-risks.md`; edit them there, not here. Book-level coverage,
exceptions, and tradeoffs are in `source-coverage.md`.
| Code | Risk | Diagnostic Question |
|------|------|---------------------|
@@ -137,7 +143,7 @@ and fixed structural headers from the template below (`Findings`, `Summary`,
````
# Brooks-Lint Review
**Mode:** [PR Review / Architecture Audit / Tech Debt Assessment / Test Quality Review]
**Mode:** [PR Review / Architecture Audit / Tech Debt Assessment / Test Quality Review / Health Dashboard / Full Sweep]
**Scope:** [file(s), directory, or description of what was reviewed]
**Health Score:** XX/100
@@ -196,7 +202,10 @@ Remedy: ...
## Remedy Mode
When the user passes `--fix` or asks to "fix the findings", read
`remedy-guide.md` from the `_shared/` directory before writing the report.
`remedy-guide.md` from the `_shared/` directory before writing the report. It
sharpens each Remedy into a concrete action — the diagnostic modes still do not
edit files. Full Sweep is the mode that applies fixes, and it follows
`brooks-sweep/sweep-guide.md` instead.
## Health Score Calculation
@@ -209,9 +218,7 @@ Base score: 100. Per-finding deductions depend on the `strictness` preset
| `balanced` (default) | −15 | −5 | −1 |
| `legacy-friendly` | −8 | −3 | −1 |
Floor: 0 (score cannot go below 0). The preset changes only the score weighting and
framing — every finding is still reported in full. Under `legacy-friendly`, lead the
**Summary** with the three highest-leverage fixes so a first run is not a wall of Criticals.
Floor: 0 (score cannot go below 0).
## History Tracking
@@ -240,7 +247,9 @@ After reporting Warning or Suggestion findings, offer:
For each finding one at a time (lowest severity first): show title, ask `[a]ccept / [d]ismiss / [f]defer / [s]kip`; wait for reply before moving to the next.
**Dismiss:** ask one-line reason → append to `.brooks-lint.yaml` under `suppress:` → downgraded to info in future runs.
**Dismiss:** ask one-line reason → append to `.brooks-lint.yaml` under `suppress:` →
downgraded to info in future runs. Entry fields: `risk` (code), `pattern` (file glob),
`reason` (required), `date` (when it was dismissed).
**Defer:** same as dismiss, add `expires: YYYY-MM-DD` (default 90 days) → resurfaces at original severity after expiry.