القائمة
OnePlan is a GitHub-native, context-driven engineering workflow using Milestones (tracks), Issues (spec/plan), and Sub-issues (phases/tasks). Use for complex features/bugfixes that need structured planning, resumable execution, parallel tasks, and team coordination.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | oneplan |
| description | OnePlan is a GitHub-native, context-driven engineering workflow using Milestones (tracks), Issues (spec/plan), and Sub-issues (phases/tasks). Use for complex features/bugfixes that need structured planning, resumable execution, parallel tasks, and team coordination. |
| metadata | {"author":"giulioleone","version":"1.0"} |
| compatibility | Works with VS Code Agent Skills. Optional GitHub CLI (gh) for local automation. |
| allowed-tools | Read Write Bash(git:*) Bash(gh:*) |
Questa skill implementa l’equivalente del workflow “Conductor” (file-based) ma con GitHub come backend e un’identità propria: OnePlan.
Idea guida: Measure twice, ship once.
oneplan/speconeplan/plan (parent)oneplan/phaseoneplan/taskFallback (se le Sub-issues non sono abilitate nel repo):
[PHASE] ...) + linkata dal PLAN tramite task list[TASK] ...) + linkata dalla PHASE tramite task liststatus/pending, status/in-progress, status/blocked, status/doneObiettivo: standardizzare convenzioni e ridurre ambiguità.
references/LABELS_AND_STATES.md).references/ISSUE_TEMPLATES.md).[CONTEXT] Project contextoneplan/contextOutput desiderato:
Obiettivo: un contenitore unico per spec/plan/tasks.
Track: <nome>.[SPEC] <nome>oneplan/spec[PLAN] <nome>oneplan/planNota: la SPEC deve essere “approvata” (anche solo via commento “LGTM / approved”) prima di creare task dettagliate.
Obiettivo: trasformare SPEC → fasi e task eseguibili.
Regole:
Algoritmo pratico di scomposizione:
Parallelismo:
Se non puoi creare sub-issues, usa le task list nel body del PLAN/PHASE:
E dentro una PHASE:
Obiettivo: eseguire una task per volta, mantenendo stato su GitHub.
Selezione “next task” (deterministica):
status/in-progress assegnata a te → continua quella.status/pending:
status/blockedCiclo di esecuzione per task:
status/in-progress.status/done e chiudi la issue task.Obiettivo: visione rapida a milestone/phase/task.
Heuristics:
Obiettivo: dopo aver consegnato una milestone, ridurre il debito tecnico “fresco”.
Workflow consigliato:
@techdebt e trasforma i findings in issue piccole e prioritizzate.Suggerimenti pratici:
@techdebt assess (panoramica)@techdebt smells, @techdebt complexity, @techdebt unused (se pertinente)Nota: l’estensione può proporre automaticamente la creazione della issue di review quando la milestone è completa.
Se vuoi “contesto locale” per far lavorare meglio l’agente (e facilitare review), puoi mantenere:
.conductor/product.md.conductor/tech-stack.md.conductor/workflow.mdQuesti file sono derivati dal contesto GitHub (o viceversa). La fonte di verità resta GitHub.
Track: <Titolo umano>[SPEC], [PLAN], [PHASE], [TASK]Usa un blocco standard nel body:
E quando blocchi una task:
status/blockedQuando serve progettazione “larga”:
in-progress per persona.references/GITHUB_MAPPING.mdreferences/LABELS_AND_STATES.mdreferences/ISSUE_TEMPLATES.mdreferences/DEPENDENCIES.mdSystematic technical debt reduction and code optimization agent. Use when refactoring code, reducing complexity, eliminating code smells, improving performance, cleaning up unused code, or modernizing legacy patterns. Handles dependency updates, architecture improvements, and codebase health metrics.
State-of-the-art debugging agent with hypothesis-driven analysis, automatic code instrumentation, git worktree isolation, and browser automation. Use when debugging errors, stack traces, unexpected behavior, performance issues, failed tests, race conditions, or hard-to-reproduce bugs.
Meta-skill for creating, refining, and managing Agent Skills. Use when needing to create new skills, improve existing skills, analyze skill performance, or teach the agent new capabilities. Enables self-improvement and knowledge capture.