Initial commit
This commit is contained in:
136
skills/review-implementing/SKILL.md
Normal file
136
skills/review-implementing/SKILL.md
Normal file
@@ -0,0 +1,136 @@
|
||||
---
|
||||
name: review-implementing
|
||||
description: Process and implement code review feedback systematically. Use when user provides reviewer comments, PR feedback, code review notes, or asks to implement suggestions from reviews.
|
||||
---
|
||||
|
||||
# Review Feedback Implementation
|
||||
|
||||
Systematically process and implement changes based on code review feedback.
|
||||
|
||||
## When to Use
|
||||
|
||||
- Provides reviewer comments or feedback
|
||||
- Pastes PR review notes
|
||||
- Mentions implementing review suggestions
|
||||
- Says "address these comments" or "implement feedback"
|
||||
- Shares list of changes requested by reviewers
|
||||
|
||||
## Systematic Workflow
|
||||
|
||||
### 1. Parse Reviewer Notes
|
||||
|
||||
Identify individual feedback items:
|
||||
- Split numbered lists (1., 2., etc.)
|
||||
- Handle bullet points or unnumbered feedback
|
||||
- Extract distinct change requests
|
||||
- Clarify ambiguous items before starting
|
||||
|
||||
### 2. Create Todo List
|
||||
|
||||
Use TodoWrite tool to create actionable tasks:
|
||||
- Each feedback item becomes one or more todos
|
||||
- Break down complex feedback into smaller tasks
|
||||
- Make tasks specific and measurable
|
||||
- Mark first task as `in_progress` before starting
|
||||
|
||||
Example:
|
||||
```
|
||||
- Add type hints to extract function
|
||||
- Fix duplicate tag detection logic
|
||||
- Update docstring in chain.py
|
||||
- Add unit test for edge case
|
||||
```
|
||||
|
||||
### 3. Implement Changes Systematically
|
||||
|
||||
For each todo item:
|
||||
|
||||
**Locate relevant code:**
|
||||
- Use Grep to search for functions/classes
|
||||
- Use Glob to find files by pattern
|
||||
- Read current implementation
|
||||
|
||||
**Make changes:**
|
||||
- Use Edit tool for modifications
|
||||
- Follow project conventions (CLAUDE.md)
|
||||
- Preserve existing functionality unless changing behavior
|
||||
|
||||
**Verify changes:**
|
||||
- Check syntax correctness
|
||||
- Run relevant tests if applicable
|
||||
- Ensure changes address reviewer's intent
|
||||
|
||||
**Update status:**
|
||||
- Mark todo as `completed` immediately after finishing
|
||||
- Move to next todo (only one `in_progress` at a time)
|
||||
|
||||
### 4. Handle Different Feedback Types
|
||||
|
||||
**Code changes:**
|
||||
- Use Edit tool for existing code
|
||||
- Follow type hint conventions (PEP 604/585)
|
||||
- Maintain consistent style
|
||||
|
||||
**New features:**
|
||||
- Create new files with Write tool if needed
|
||||
- Add corresponding tests
|
||||
- Update documentation
|
||||
|
||||
**Documentation:**
|
||||
- Update docstrings following project style
|
||||
- Modify markdown files as needed
|
||||
- Keep explanations concise
|
||||
|
||||
**Tests:**
|
||||
- Write tests as functions, not classes
|
||||
- Use descriptive names
|
||||
- Follow pytest conventions
|
||||
|
||||
**Refactoring:**
|
||||
- Preserve functionality
|
||||
- Improve code structure
|
||||
- Run tests to verify no regressions
|
||||
|
||||
### 5. Validation
|
||||
|
||||
After implementing changes:
|
||||
- Run affected tests
|
||||
- Check for linting errors: `uv run ruff check`
|
||||
- Verify changes don't break existing functionality
|
||||
|
||||
### 6. Communication
|
||||
|
||||
Keep user informed:
|
||||
- Update todo list in real-time
|
||||
- Ask for clarification on ambiguous feedback
|
||||
- Report blockers or challenges
|
||||
- Summarize changes at completion
|
||||
|
||||
## Edge Cases
|
||||
|
||||
**Conflicting feedback:**
|
||||
- Ask user for guidance
|
||||
- Explain conflict clearly
|
||||
|
||||
**Breaking changes required:**
|
||||
- Notify user before implementing
|
||||
- Discuss impact and alternatives
|
||||
|
||||
**Tests fail after changes:**
|
||||
- Fix tests before marking todo complete
|
||||
- Ensure all related tests pass
|
||||
|
||||
**Referenced code doesn't exist:**
|
||||
- Ask user for clarification
|
||||
- Verify understanding before proceeding
|
||||
|
||||
## Important Guidelines
|
||||
|
||||
- **Always use TodoWrite** for tracking progress
|
||||
- **Mark todos completed immediately** after each item
|
||||
- **Only one todo in_progress** at any time
|
||||
- **Don't batch completions** - update status in real-time
|
||||
- **Ask questions** for unclear feedback
|
||||
- **Run tests** if changes affect tested code
|
||||
- **Follow CLAUDE.md conventions** for all code changes
|
||||
- **Use conventional commits** if creating commits afterward
|
||||
Reference in New Issue
Block a user