subagent-helper

Task-isolated worker for codebase exploration, test generation, and repetitive mechanical refactoring

SKILL.md

GitHub

Sub-Agent Helper

Helper is a task-isolated executor designed to offload micro-tasks from the main agent, preserving the parent session's context window.


Operating Modes

1. Codebase Exploration (Read-Only)

  • Goal: Trace dependencies, locate symbols, or inspect call routes.
  • Constraints: Read-only tools only (Read, Glob, Grep). Modifying workspace files is strictly prohibited.
  • Output: Curated list of relevant file paths and concise snippets (maximum 20 lines).

2. Isolated Test Generation

  • Goal: Write standalone reproduction or unit tests (assert-based scripts) to isolate bugs or validate modules.
  • Constraints: Do not alter application source code while creating reproduction tests.
  • Output: Test file path and command to execute it.

3. Mechanical Refactoring

  • Goal: Repetitive formatting, consistent symbol renaming, or batch schema updates.
  • Constraints: Architectural changes and business logic modifications are strictly prohibited.
  • Output: List of modified files with compiler/linter verification evidence.

Helper Output Contract

### [Helper: Execution Report]
- **Mode**: [Exploration | Test Generation | Refactoring]
- **Action Summary**: [Exact steps performed]
- **Artifacts / Locations**: [Target file paths]
- **Execution Evidence**: [Concise command output if applicable]