菜单
Documentation consistency enforcement - prevents drift between README.md and actual codebase state. Auto-activates when updating docs, committing changes, or working with skills/agents/commands.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
GenAI-first testing with structural assertions, congruence validation, and tier-based test structure. Use when writing tests, setting up test infrastructure, or validating coverage. TRIGGER when: test, pytest, coverage, TDD, test patterns, congruence, validation. DO NOT TRIGGER when: production code implementation, documentation, config-only changes.
One topic, one home. Routes content to its canonical store (CLAUDE.md, PROJECT.md, MEMORY.md, docs/, memory/) and audits for duplication. TRIGGER when: auditing CLAUDE.md/PROJECT.md/MEMORY.md sizes, deduplicating docs, applying the content-allocation pattern to a new repo, running /align --content. DO NOT TRIGGER when: implementing features, writing tests, routine code edits, debugging.
Prompt engineering patterns for writing agent prompts and skill files — constraint budgets, register shifting, HARD GATE patterns, anti-personas. Use when writing or reviewing agents/*.md or skills/*/SKILL.md. TRIGGER when: agent prompt, skill file, prompt engineering, model-tier compensation, HARD GATE, prompt quality. DO NOT TRIGGER when: user-facing docs, README, CHANGELOG, config files.
7-step planning workflow for pre-implementation design. Enforced by plan_gate hook, critiqued by plan-critic agent. Use when creating plans, design documents, or architecture decisions before implementation. TRIGGER when: plan, planning, /plan, design document, architecture decision. DO NOT TRIGGER when: implementation, coding, testing.
Structured logging, debugging (pdb/ipdb), profiling (cProfile/line_profiler), and performance monitoring. Use when adding logging, debugging issues, or optimizing performance. TRIGGER when: logging, debug, profiling, performance monitoring, metrics, stack trace. DO NOT TRIGGER when: feature implementation, testing, documentation, config changes.
10-point code review checklist covering correctness, tests, error handling, type hints, naming, security, and performance. Use when reviewing PRs or evaluating code quality. TRIGGER when: code review, PR review, review checklist, code quality check. DO NOT TRIGGER when: writing new code, debugging, refactoring without review context.
| name | consistency-enforcement |
| version | 1.1.0 |
| type | knowledge |
| description | Documentation consistency enforcement - prevents drift between README.md and actual codebase state. Auto-activates when updating docs, committing changes, or working with skills/agents/commands. |
| keywords | readme, documentation, commit, sync, update, skill, agent, command, count, marketplace, consistency, drift |
| auto_activate | false |
| allowed-tools | ["Read"] |
Layer 4 Defense Against Documentation Drift
Auto-activates to maintain documentation consistency when working on docs, skills, agents, or commands.
See: workflow.md for step-by-step scenarios See: templates.md for checklists and commands
Keywords: "readme", "documentation", "docs", "commit", "sync", "update", "skill", "agent", "command", "count", "marketplace", "consistency", "drift"
All counts must match reality:
# Count actual resources
ls -d plugins/autonomous-dev/skills/*/ | wc -l # Skills
ls plugins/autonomous-dev/agents/*.md | wc -l # Agents
ls plugins/autonomous-dev/commands/*.md | wc -l # Commands
These files MUST show the same counts:
README.md (primary source)docs/SYNC-STATUS.mddocs/UPDATES.mdINSTALL_TEMPLATE.md.claude-plugin/marketplace.json (metrics)# Verify skill exists before referencing
ls -1 plugins/autonomous-dev/skills/
{
"metrics": {
"agents": 8,
"skills": 12,
"commands": 21
}
}
| Layer | Location | Purpose |
|---|---|---|
| 1 | tests/test_documentation_consistency.py | Automated CI/CD enforcement |
| 2 | agents/doc-master.md | Agent memory checklist |
| 3 | hooks/validate_docs_consistency.py | Pre-commit hook (optional) |
| 4 | This skill | Auto-reminder during work |
pytest tests/test_documentation_consistency.py -v
When adding/removing skills, agents, or commands:
See: workflow.md for detailed scenarios
Documentation drift causes user confusion:
With 4-layer defense:
Result: Documentation always matches reality
Works with: