AgentSkillsCN

feature-dev

指导新功能开发。在实现新功能、处理GitHub问题、规划架构或创建开发PR时使用。

SKILL.md
--- frontmatter
name: feature-dev
description: Guía el desarrollo de nuevas features. Usar cuando se implementa funcionalidad nueva, se trabaja en issues de GitHub, se planifica arquitectura, o se crean PRs de desarrollo.
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, Task, WebFetch, WebSearch

Feature Development Skill

Workflow

  1. •Analizar requerimientos - Leer issue/task y entender el objetivo
  2. •Explorar código existente - Usar Glob/Grep para encontrar patrones relevantes
  3. •Diseñar solución - Seguir arquitectura existente del proyecto
  4. •Implementar - Escribir código siguiendo convenciones
  5. •Tests - Añadir tests para nueva funcionalidad
  6. •Verificar - Ejecutar linting, tipos y tests

Guidelines

Código

  • •Seguir convenciones existentes en el codebase
  • •Cambios mínimos y focalizados - no refactorizar código no relacionado
  • •Usar tipos explícitos en TypeScript
  • •No añadir dependencias sin justificación

Tests

  • •Tests unitarios para lógica nueva
  • •Tests de integración si afecta múltiples módulos
  • •Cubrir edge cases y error paths

Documentación

  • •Documentar solo si la lógica no es obvia
  • •Actualizar README si cambia API pública
  • •No añadir comentarios redundantes

Arquitectura oss-agent

code
src/
├── cli/           # Commands (Commander.js)
├── core/
│   ├── ai/        # AI providers (CLI/SDK)
│   ├── engine/    # Workflow engines
│   ├── git/       # Git operations
│   └── state/     # SQLite state management
├── infra/         # Utils, logging, errors
└── types/         # Zod schemas

Convenciones del Proyecto

  • •ESM modules - Usar .js en imports
  • •Strict TypeScript - noUncheckedIndexedAccess, exactOptionalPropertyTypes
  • •Zod para validación - Schemas en src/types/
  • •Commander.js para CLI - Commands en src/cli/commands/

Ver PATTERNS.md para patrones específicos del proyecto.