docs(repo): Align docs with current maintainer flows
Document the current static web-app behavior, local-only save flow, shallow installer path, and maintainer-only sync controls.\n\nAlign maintainer guides with the active audit-to-risk-sync workflow, canonical artifact bot contract, release/coverage requirements, and updated security triage context so the docs match the repository's real operating model.
This commit is contained in:
@@ -64,6 +64,8 @@ Use `npm run audit:skills` when you need a repo-wide report that goes beyond sch
|
||||
- which skills are missing examples or limitations,
|
||||
- and which skills have the highest concentration of warnings/errors.
|
||||
|
||||
Maintainers can pair that report with `npm run sync:risk-labels` for conservative legacy cleanup. That sync only rewrites `risk: unknown` when the suggested label is explicit and high-confidence enough to automate safely, and it preserves the contributor-facing rule that new or uncertain submissions can still start as `unknown`.
|
||||
|
||||
---
|
||||
|
||||
## Support Levels
|
||||
@@ -94,6 +96,7 @@ Notes:
|
||||
|
||||
- `npm run validate` is the operational contributor gate.
|
||||
- `npm run audit:skills` is the maintainer-facing compliance/usability report for the full library.
|
||||
- `npm run sync:risk-labels` is a maintainer cleanup tool for high-confidence legacy `risk:` fixes.
|
||||
- `npm run security:docs` is required for command-heavy or risky skill content.
|
||||
- PRs that touch `SKILL.md` also get an automated `skill-review` GitHub Actions check.
|
||||
- Skill changes and risky guidance still require a manual logic review before merge, even when the automated gates pass.
|
||||
|
||||
Reference in New Issue
Block a user