codebase-review
1
总安装量
1
周安装量
#43091
全站排名
安装命令
npx skills add https://github.com/krazyuniks/guitar-tone-shootout --skill codebase-review
Agent 安装分布
amp
1
opencode
1
kimi-cli
1
codex
1
github-copilot
1
gemini-cli
1
Skill 文档
Codebase Review Skill
Activation: Codebase review, security audit, architecture review, code quality assessment
Arguments: [--section=<name>] [--severity=<level>] [--no-issue]
Preflight Checks
Run these FIRST before any review section:
- Docker Health:
docker compose ps— all services “Up” and “healthy” - Build Profile:
docker compose --profile build ps astro - Backend Health:
curl -s http://localhost:8000/health | jq . - Install Tools:
docker compose exec webapp pip install vulture bandit radon pip-audit -q
Do not proceed if preflight checks fail.
Review Sections
Each section can be run independently with --section=<name>.
| Section | Flag | Purpose |
|---|---|---|
| Code Quality | --section=quality |
Dead code, complexity, test coverage |
| Security | --section=security |
Bandit, pip-audit, OWASP, headers |
| Architecture | --section=architecture |
Import boundaries, DDD, SOLID |
| Frontend | --section=frontend |
Astro sync, data-testid, HTMX |
| Documentation | --section=documentation |
Drift detection, AGENTS.md accuracy |
| Observability | --section=observability |
Metrics, circuit breaker, logging |
| Workflow | --section=workflow |
Just commands, pre-commit, CI |
See references/review-dimensions.md for detailed checklists per section.
Severity Levels
| Level | Definition | Response SLA |
|---|---|---|
| Critical | Security vulnerabilities, data loss risk | Same day |
| High | Significant bugs, broken features | 48 hours |
| Medium | Degraded functionality, maintainability | 1 week |
| Low | Minor issues, code style | Next sprint |
Critical and High findings block PR merges.
Workflow
- Run preflight checks
- Execute selected sections (or all)
- Document findings using the template in
references/report-template.md - Create GitHub issue (unless
--no-issue) - Fill in summary dashboard
Reference Files
| File | Purpose |
|---|---|
references/review-dimensions.md |
Detailed checklists for each review section |
references/report-template.md |
Output format, findings template, summary dashboard |
references/gts-specifics.md |
GTS-specific review patterns and commands |