swe
20
总安装量
3
周安装量
#18086
全站排名
安装命令
npx skills add https://github.com/knoopx/pi --skill swe
Agent 安装分布
codex
3
windsurf
2
opencode
2
claude-code
2
gemini-cli
2
Skill 文档
Software Engineering Best Practices
A comprehensive guide to writing maintainable, scalable, and high-quality software, organized by development phase.
Phases
| Phase | File | Content |
|---|---|---|
| Design | design.md | Requirements, principles, architecture, security by design |
| Implementation | implementation.md | Self-documenting code, naming, functions, error handling, linting, code smells |
| Testing | testing.md | Test pyramid, BDD, test quality, anti-patterns |
| Review | review.md | Code review checklist, self-review before PR |
| Maintenance | maintenance.md | Refactoring, technical debt, performance, documentation |
Key Principles Summary
- Simplicity wins: Write the simplest code that works; add complexity only when required
- Single responsibility: Each function/class/module should do one thing well
- Self-documenting code: Code should explain itself; comments are a code smell
- Fail fast: Validate inputs early, let unexpected errors propagate
- Test behavior: Focus on what code does, not implementation details
- No backwards compatibility: Don’t add legacy support unless explicitly requested
- Consistency: Match existing project conventions over personal preference
Related Skills and Tools
This skill integrates with other available tools for practical implementation:
| Task | Skill/Tool | Usage |
|---|---|---|
| Code Analysis | codemapper | Map codebase structure, trace call paths, find callers/callees |
| Structural Refactoring | ast-grep | Search/replace code patterns using AST, safe automated refactoring |
| Duplicate Detection | jscpd | Find copy-pasted code blocks across files |
| Dead Code Detection | knip | Find unused dependencies, files, and exports |
| Testing | vitest | Write and run tests, mocking, coverage reports |
| Type Safety | typescript | Type definitions, generics, type guards |
| Python Quality | python | pytest, ruff, mypy for Python projects |
| Version Control | jujutsu | Track changes, rebase, manage commits |
| Code Review | gh | Create PRs, manage issues, review workflow |
| Package Management | bun | Install dependencies, run scripts, bundle code |