mirror of
https://github.com/Fission-AI/OpenSpec.git
synced 2026-09-14 20:16:53 +08:00
Tabish Bidiwale
92731e2263
* refactor: split skill templates into workflow modules * fix: align template index exports and parity docs * fix: add standard metadata to feedback skill template * fix: add ff command guardrail for context and rules * spec: add unified template generation pipeline proposal
2.4 KiB
2.4 KiB
Why
The recent split of skill-templates.ts into workflow modules improved readability, but the generation pipeline is still fragmented across multiple layers:
- Workflow definitions are split from projection logic (
getSkillTemplates,getCommandTemplates,getCommandContents) - Tool capability and compatibility are spread across
AI_TOOLS,CommandAdapterRegistry, and hardcoded lists likeSKILL_NAMES - Agent/tool-specific transformations (for example OpenCode command reference rewrites) are applied in different places (
init,update, and adapter code) - Artifact writing logic is duplicated across
init,update, and legacy-upgrade flow
This fragmentation creates drift risk (missing exports, missing metadata parity, mismatched counts/support) and makes future workflow/tool additions slower and less predictable.
What Changes
- Introduce a canonical
WorkflowManifestas the single source of truth for all workflow artifacts - Introduce a
ToolProfileRegistryto centralize tool capabilities (skills path, command adapter, transforms) - Introduce a first-class transform pipeline with explicit phases (
preAdapter,postAdapter) and scopes (skill,command,both) - Introduce a shared
ArtifactSyncEngineused byinit,update, and legacy upgrade paths - Add strict validation and test guardrails to preserve fidelity during migration and future changes
Capabilities
New Capabilities
template-artifact-pipeline: Unified workflow manifest, tool profile registry, transform pipeline, and sync engine for skill/command generation
Modified Capabilities
command-generation: Extended to support ordered transform phases around adapter renderingcli-init: Uses shared artifact sync orchestration instead of bespoke loopscli-update: Uses shared artifact sync orchestration instead of bespoke loops
Impact
- Primary refactor area:
src/core/templates/*src/core/shared/skill-generation.tssrc/core/command-generation/*src/core/init.tssrc/core/update.tssrc/core/shared/tool-detection.ts
- Testing additions:
- Manifest completeness tests (workflows, required metadata, projection parity)
- Transform ordering and applicability tests
- End-to-end parity tests for generated skill/command outputs across tools
- User-facing behavior:
- No new CLI surface area required
- Existing generated artifacts remain behaviorally equivalent unless explicitly changed in future deltas