Agent skill
fix-audit-issue
Fix a single audit issue in a git worktree. Creates a feature branch, follows fix-bug procedure, and creates a PR. Designed for parallel execution by spawned agents.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/fix-audit-issue
SKILL.md
Fix Audit Issue (Worktree Workflow)
This skill wraps the fix-bug procedure for agents running in git worktrees.
Step 1: Create branch
git checkout -b fix/{short-description}
Use a descriptive branch name based on the issue (e.g., fix/redaction-policy-merge, fix/crewai-double-callback).
Step 2: Follow fix-bug procedure
Execute all 8 steps from the fix-bug skill:
- Understand the bug
- Root cause analysis
- Write failing behavior test FIRST
- Fix the source code
- Verify the fix
- Check regression scope
- Docs-code sync check
- Full verification
Step 3: Commit and push
git add {specific files}
git commit -m "fix: {description}"
git push -u origin fix/{short-description}
Step 4: Create PR
gh pr create --title "fix: {short description}" --body "$(cat <<'EOF'
## Summary
{one-line summary}
## Root Cause
{what the code did wrong and why tests didn't catch it}
## Fix
{what was changed}
## Test Plan
- [ ] Behavior test added in tests/test_behavior/
- [ ] Full test suite passes
- [ ] Lint passes
- [ ] Docs build passes
- [ ] Docs-code sync passes
EOF
)"
Conventions
- One issue per branch, one issue per PR
- Conventional commit:
fix: {description} - No Co-Authored-By
- No banned terminology — check
.docs-style-guide.mdbefore writing any user-facing string - Branch from
main, targetmain
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?