1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

# Project: MyAwesomeApp

## Tech Stack
- Frontend: Next.js 14 + Tailwind + shadcn/ui
- Backend: Node.js + Express + PostgreSQL
- AI: OpenAI API + LangChain

## Architecture
- Clean Architecture / Hexagonal
- Domain-driven design
- Repository pattern for data layer

## Commands
- `npm run dev` - Start dev server
- `npm run test` - Run test suite
- `npm run lint` - Check code style

## Constraints
- Always use TypeScript strict mode
- Prefer functional components
- Use React Server Components where possible
- Never expose API keys in client code

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

---
name: Testing Best Practices
description: When writing tests, use this skill to ensure quality and coverage
---

## Testing Guidelines

1. **Unit Tests**
   - Test one thing per test
   - Use descriptive test names: `should_do_something_when_condition`
   - Arrange-Act-Assert pattern

2. **Integration Tests**
   - Test real database interactions
   - Mock external services only
   - Clean up test data after each test

3. **Coverage**
   - Aim for 80%+ coverage on business logic
   - Don't chase 100% coverage for coverage's sake

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

// .claude/hooks/pre-tool-use.js
module.exports = {
  beforeToolUse: async (tool, args) => {
    // 检查敏感操作
    if (tool === 'Bash' && args.command.includes('rm -rf')) {
      return {
        allow: false,
        message: '⚠️ 危险操作检测：删除命令需要手动确认'
      };
    }
    return { allow: true };
  }
};

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

// .claude/hooks/post-tool-use.js
module.exports = {
  afterToolUse: async (tool, args, result) => {
    // 自动记录文件修改
    if (tool === 'Write' || tool === 'Edit') {
      console.log(`📝 文件修改: ${args.file_path}`);
    }
    return result;
  }
};

1
2
3
4
5
6
7

// .claude/hooks/notification.js
module.exports = {
  onLongRunningTask: async (task) => {
    // 长时间任务完成时发送通知
    await sendDiscordNotification(`✅ 任务完成: ${task.description}`);
  }
};

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

---
name: Feature Development Agent
description: Use this agent for implementing new features from spec to PR
---

## Workflow

1. **Understand**: Read the feature spec and ask clarifying questions
2. **Plan**: Create a detailed implementation plan
3. **Research**: Check existing code patterns and dependencies
4. **Implement**: Write code following project conventions
5. **Test**: Write unit tests and integration tests
6. **Review**: Self-review against checklist
7. **Document**: Update README and API docs

## Checklist

- [ ] All new code has tests
- [ ] No console.log left in production code
- [ ] Error handling is comprehensive
- [ ] TypeScript types are correct
- [ ] Documentation is updated