generic-feature-developer — скилл для Claude Code
Скилл generic-feature-developer ведёт новую фичу по шагам: разобраться в коде, выбрать паттерн, собрать мелкими коммитами и проверить края перед закрытием.
MIT 142 установок ★ 114 обновлён 2026-11-06
npx skills add travisjneuman/.claude --skill generic-feature-developer -a claude-codeЧто делает generic-feature-developer
Скилл проводит фичу через четыре шага: прочитать CLAUDE.md и перечислить затронутые файлы, выбрать паттерны и набросать поток данных, собрать всё мелкими коммитами, а потом сверить диф с краевыми случаями и обновить документацию.
Под каждый тип проекта в нём готовая раскладка папок: статический сайт с css/ и js/, дерево React/Next.js с components/, hooks/, stores/ и services/, бэкенд на NestJS, где фича — это модуль с контроллером, сервисом и DTO. Отдельные таблицы помогают выбрать между своим кодом и библиотекой и решить, где держать состояние. Формат ошибок и пагинация вынесены в чек-лист по API.
Чистая вёрстка и UX-решения вне его зоны: там он отправляет к generic-design-system и generic-ux-designer. Тесты пишутся, только если вы их попросили. Ссылки в конце ведут на ../_shared/CODE_REVIEW_STANDARDS.md и DESIGN_PATTERNS.md из того же репозитория, поэтому ставьте скилл вместе с репозиторием, иначе они не откроются.
Какие задачи решает
- решить, писать модуль самому или взять готовую библиотеку
- выбрать, где хранить состояние: в компоненте, в сторе или в кеше серверных данных
- разложить фичу на мелкие коммиты, которые успевают прочитать на ревью
- свести ответы API к одному формату ошибок и одной схеме пагинации
- пройти чек-лист перед тем, как закрыть фичу
Примеры запросов агенту
- Добавь экспорт отчёта в CSV: сначала покажи план и затронутые файлы, потом код.
- Спроектируй эндпоинт
POST /invoicesв модуле NestJS: DTO, валидация, формат ошибок. - Где держать состояние фильтров — в компоненте или в Zustand? Разбери оба варианта и выбери.
Как установить generic-feature-developer
1Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-feature-developer -a claude-code2Вручную: положить файлы
~/.claude/skills/generic-feature-developer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/generic-feature-developer/
1Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-feature-developer -a codex2Вручную: положить файлы
.agents/skills/generic-feature-developer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-feature-developer -a cursor2Вручную: положить файлы
.cursor/skills/generic-feature-developer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install travisjneuman/.claude skills/generic-feature-developer2Вручную: положить файлы
.github/skills/generic-feature-developer/SKILL.md1Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-feature-developer -a gemini-cli2Командой платформы
gemini skills install https://github.com/travisjneuman/.claude --path skills/generic-feature-developerВручную: положить файлы
.devin/skills/generic-feature-developer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-feature-developer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о generic-feature-developer
Как установить generic-feature-developer в Claude Code?
Выполните npx skills add travisjneuman/.claude --skill generic-feature-developer -a claude-code. После этого файл скилла лежит в ~/.claude/skills/generic-feature-developer/SKILL.md.
Что делает generic-feature-developer?
Задаёт порядок работы над фичей: чтение CLAUDE.md и затронутых файлов, выбор паттернов и потока данных, реализация мелкими коммитами, затем ревью дифа и обновление документации.
Он пишет тесты?
Только если попросить: в чек-листе тесты отмечены как выполняемые по запросу, а таблица по слоям подсказывает инструменты для компонентных, юнит-, интеграционных и E2E-проверок.
Исходный текст
SKILL.md · MIT
---
name: generic-feature-developer
description: Guide feature development with architecture patterns for any tech stack. Covers frontend, backend, full-stack, and automation projects. Use when adding new features, modifying systems, or planning changes.
---
# Generic Feature Developer
Guide feature development across any tech stack.
## When to Use This Skill
**Use for:**
- Adding new features to existing codebase
- Modifying or extending current systems
- Planning architectural changes
- Choosing between implementation approaches
- Designing data flow for new functionality
**Don't use when:**
- Pure UI/styling work → use `generic-design-system`
- UX design decisions → use `generic-ux-designer`
- Code review → use `generic-code-reviewer`
## Development Workflow
1. **Understand** - Read CLAUDE.md, identify affected files, list constraints
2. **Plan** - Choose patterns, design data flow, identify edge cases
3. **Implement** - Small reviewable changes, commit frequently
4. **Review & Document** - Review the diff against edge cases and callers, update docs, performance check
## Architecture by Project Type
### Static Sites
```
project/
├── index.html
├── css/ # variables.css, style.css
├── js/ # main.js, utils.js
└── assets/
```
**Patterns:** CSS variables, ES modules, event delegation
### React/Next.js
```
src/
├── components/ # ui/, features/, layout/
├── hooks/
├── stores/
├── services/
└── types/
```
**Patterns:** Container/Presentational, custom hooks, Zustand/React Query
### NestJS Backend
```
src/
├── modules/[feature]/
│ ├── feature.module.ts
│ ├── feature.controller.ts
│ ├── feature.service.ts
│ └── dto/
└── common/ # guards, decorators
```
**Patterns:** Module organization, DTOs, Guards, Prisma
## Feature Decision Framework
### Scope Assessment (First)
| Scope | Action |
| --------------------- | ------------------------------------- |
| Single component | Implement directly |
| Cross-cutting concern | Design interface first |
| New subsystem | Create architecture doc, get approval |
### Build vs Integrate
| Factor | Build Custom | Use Library |
| ------------------------ | ------------ | ----------- |
| Core to product | Yes | |
| Commodity feature | | Yes |
| Tight integration needed | Yes | |
| Time-critical | | Yes |
| Long-term ownership | Yes | |
### State Management Selection
| Scope | Solution |
| --------------- | ------------------------ |
| Component-local | useState/useReducer |
| Feature-wide | Context or Zustand slice |
| App-wide | Zustand/Redux store |
| Server state | React Query/SWR |
| Form state | React Hook Form |
### API Design Checklist
- [ ] RESTful or GraphQL decision documented
- [ ] Authentication method chosen
- [ ] Error response format standardized
- [ ] Pagination strategy defined
- [ ] Rate limiting considered
## Common Features
### Adding UI Component
1. Create component → 2. Export → 3. Review usage and edge cases → 4. Document
### Adding API Endpoint
1. Define route → 2. Add validation → 3. Implement service → 4. Review error paths
### Adding State Management
1. Define shape → 2. Create store → 3. Add actions → 4. Connect components
### Database Changes
1. Design schema → 2. Create migration → 3. Update models → 4. Add service
## Data Flow Patterns
### Frontend Data Flow
```
User Action → Event Handler → State Update → Re-render → UI Feedback
```
- **Optimistic updates:** Update UI immediately, rollback on error
- **Pessimistic updates:** Wait for server confirmation
- **Decision:** Optimistic for low-risk (likes), pessimistic for high-risk (payments)
### API Request Flow
```
Request → Auth Check → Validation → Business Logic → Database → Response
```
- Early exit on validation failure
- Transaction boundaries around multi-step operations
- Consistent error response format
### Event-Driven Patterns
| Event Type | Approach |
| ---------------- | --------------------------- |
| User events | Immediate feedback |
| Server events | WebSocket/SSE for real-time |
| Background tasks | Queue for long operations |
## Error Handling Strategy
| Error Type | Frontend | Backend |
| ------------ | ------------------------- | ------------------ |
| Validation | Inline field errors | 400 + field errors |
| Auth | Redirect to login | 401/403 |
| Not Found | Empty state or redirect | 404 |
| Server Error | Generic message + retry | 500 + log |
| Network | Offline indicator + queue | N/A |
### Frontend Pattern
```typescript
try {
await apiCall();
} catch (error) {
if (error instanceof ValidationError) showFieldErrors(error.fields);
else showGenericError();
}
```
### Backend Pattern
```typescript
if (err instanceof ValidationError)
return res.status(400).json({ errors: err.errors });
if (err instanceof AuthError)
return res.status(401).json({ message: "Unauthorized" });
```
## Testing Strategy (when the user asks for tests)
| Layer | Type | Tools |
| ----- | ----------- | --------------- |
| UI | Component | Testing Library |
| Logic | Unit | Jest, Vitest |
| API | Integration | Supertest |
| E2E | End-to-end | Cypress |
## Performance
**Frontend:** Code splitting, lazy loading, memoization, debounce
**Backend:** DB indexing, caching, connection pooling, background jobs
## Feature Implementation Checklist
Before marking feature complete:
- [ ] Works for happy path
- [ ] Error states handled
- [ ] Loading states implemented
- [ ] Edge cases reviewed
- [ ] TypeScript types complete
- [ ] Tests written (only if the user asked for them)
- [ ] Documentation updated
## See Also
- [Code Review Standards](./../_shared/CODE_REVIEW_STANDARDS.md) - Quality checks
- [Design Patterns](./../_shared/DESIGN_PATTERNS.md) - UI patterns
- `generic-design-system` - For styling and visual consistency
- `generic-ux-designer` - For UX flow decisions
- Project `CLAUDE.md` - Workflow rules
**READ shared standards when:**
- Complex feature design → CODE_REVIEW_STANDARDS.md (architecture section)
- UI component patterns → DESIGN_PATTERNS.md (component section)
© travisjneuman · MIT · travisjneuman/.claude