AgentSkillsCN

engineering

资深工程师就代码质量、架构模式与最佳实践提供专业指导。无论是实施规划、代码审查,还是针对可维护性与设计规范的一般性工程问题,均可获得权威建议。

SKILL.md
--- frontmatter
name: engineering
description: |
  Senior engineering guidance on code quality, architecture patterns, and
  best practices. Use for implementation planning, code review, or general
  engineering questions about maintainability and design.

Engineering Skill

Provide senior engineering guidance on code quality, architecture, and implementation.

When to Use

  • Planning implementation approach
  • Reviewing code for quality and maintainability
  • Evaluating architecture decisions
  • Debugging complex issues
  • User says "review this code", "how should I implement", "is this good practice"

What This Skill Does

  1. Implementation Planning - Guide on how to build features with quality
  2. Code Review - Assess quality, patterns, maintainability
  3. Architecture Guidance - Evaluate structure and design decisions
  4. Best Practices - Share knowledge on conventions and patterns

Key Principles

Code Quality

  • Clear naming and organization
  • DRY (Don't Repeat Yourself)
  • SOLID principles
  • Consistent style

Architecture

  • Design patterns
  • Separation of concerns
  • Component boundaries
  • Dependency management

Maintainability

  • Easy to understand and modify
  • Easy to test
  • Well-documented
  • Error handling

Performance

  • Efficient algorithms and data structures
  • Resource management
  • Caching strategies

Review Process

Use comprehensive checklists covering:

  • Structure (patterns, abstractions, dependencies)
  • Quality (naming, duplication, style)
  • Error handling (recovery, messages)
  • Maintainability (clarity, configuration)
  • Performance (queries, data structures)
  • Agent overstepping (unnecessary changes, commented-out code, scope creep)

See refs/checklists.md for detailed review checklists and severity guidelines.

Output Formats

Provide structured guidance for:

  • Implementation planning with approach and steps
  • Code reviews with strengths, issues, and recommendations

See refs/templates.md for output templates and focus areas.

Integration with Specialists

Coordinate with specialized perspectives:

  • /wicked-engineering:frontend - React, CSS, browser-specific concerns
  • /wicked-engineering:backend - APIs, databases, server-side patterns
  • /wicked-engineering:debugging - Error investigation and root cause analysis

Integration with wicked-crew

Engaged during:

  • Build Phase: Implementation guidance and pattern recommendations
  • Review Phase: Code quality and architecture review
  • Error Recovery: When issues are encountered during development

Notes

  • Always explain the "why" behind recommendations
  • Be constructive, not critical
  • Offer alternatives with tradeoffs
  • Encourage questions and discussion