public/bluecraft
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

optimize agent-docs

Browse Source
This commit is contained in:
Ge Song
2026-04-23 02:16:39 +08:00
parent 2c22fcc4c3
commit c14adfc633
31 changed files with 734 additions and 377 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
skills/agent-docs-audit/SKILL.md
View File

@@ -22,21 +22,24 @@ Do not use this skill as the main workflow when the task is to edit files. Switc
1. Read the root `AGENTS.md` and every active child doc in scope.
2. Read `../agent-docs/references/audit-checklist.md`.
3. Use `../agent-docs/references/refactor-checklist.md` as the structural baseline.
4. Separate observed facts from inferences:
3. Read `../agent-docs/references/severity-model.md`.
4. Read `../agent-docs/references/report-format.md`.
5. Use `../agent-docs/references/refactor-checklist.md` as the structural baseline.
6. Separate observed facts from inferences:
- observed facts: file contents, references, checklists, routing text, command output
- inferences: likely adherence impact, likely confusion points, likely maintenance risk
5. Evaluate:
7. Evaluate:
- routing clarity
- single authoritative rule ownership
- shape fitness: rule doc vs inventory doc
- instruction density and likely adherence load
- residual cycles or secondary-index behavior
6. Report findings first, ordered by severity.
8. Report findings first, ordered by severity from `severity-model.md`, using the audit shape from `report-format.md`.
## Reporting
- Findings first
- Label each finding with `blocking`, `major`, `minor`, or `observation`
- Then open questions or assumptions
- Then an adherence assessment
- Then any optional summary

2
skills/agent-docs-audit/agents/openai.yaml
View File

@@ -1,4 +1,4 @@
interface:
display_name: "Audit agent-docs"
short_description: "Review agent-docs quality and adherence"
default_prompt: "Use $agent-docs-audit to evaluate AGENTS.md and agent-docs for instruction quality, routing clarity, and adherence risk."
default_prompt: "Use $agent-docs-audit to review AGENTS.md and agent-docs with findings first, apply the shared severity model, separate facts from inferences, and focus on routing clarity, authority ownership, and followability."