diff --git a/scripts/gen-skill-docs.ts b/scripts/gen-skill-docs.ts index 1c2a3fee..75deb5f4 100644 --- a/scripts/gen-skill-docs.ts +++ b/scripts/gen-skill-docs.ts @@ -340,15 +340,18 @@ function processTemplate(tmplPath: string, host: Host = 'claude'): { outputPath: const ctx: TemplateContext = { skillName, tmplPath, benefitsFrom, host, paths: HOST_PATHS[host], preambleTier }; - // Replace placeholders - let content = tmplContent.replace(/\{\{(\w+)\}\}/g, (match, name) => { - const resolver = RESOLVERS[name]; - if (!resolver) throw new Error(`Unknown placeholder {{${name}}} in ${relTmplPath}`); - return resolver(ctx); + // Replace placeholders (supports parameterized: {{NAME:arg1:arg2}}) + let content = tmplContent.replace(/\{\{(\w+(?::[^}]+)?)\}\}/g, (match, fullKey) => { + const parts = fullKey.split(':'); + const resolverName = parts[0]; + const args = parts.slice(1); + const resolver = RESOLVERS[resolverName]; + if (!resolver) throw new Error(`Unknown placeholder {{${resolverName}}} in ${relTmplPath}`); + return args.length > 0 ? resolver(ctx, args) : resolver(ctx); }); // Check for any remaining unresolved placeholders - const remaining = content.match(/\{\{(\w+)\}\}/g); + const remaining = content.match(/\{\{(\w+(?::[^}]+)?)\}\}/g); if (remaining) { throw new Error(`Unresolved placeholders in ${relTmplPath}: ${remaining.join(', ')}`); } diff --git a/scripts/resolvers/index.ts b/scripts/resolvers/index.ts index 6b5a9e4e..c2f3157f 100644 --- a/scripts/resolvers/index.ts +++ b/scripts/resolvers/index.ts @@ -3,7 +3,7 @@ * Each resolver takes a TemplateContext and returns the replacement string. */ -import type { TemplateContext } from './types'; +import type { TemplateContext, ResolverFn } from './types'; // Domain modules import { generatePreamble } from './preamble'; @@ -15,8 +15,9 @@ import { generateReviewDashboard, generatePlanFileReviewReport, generateSpecRevi import { generateSlugEval, generateSlugSetup, generateBaseBranchDetect, generateDeployBootstrap, generateQAMethodology, generateCoAuthorTrailer } from './utility'; import { generateLearningsSearch, generateLearningsLog } from './learnings'; import { generateConfidenceCalibration } from './confidence'; +import { generateInvokeSkill } from './composition'; -export const RESOLVERS: Record string> = { +export const RESOLVERS: Record = { SLUG_EVAL: generateSlugEval, SLUG_SETUP: generateSlugSetup, COMMAND_REFERENCE: generateCommandReference, @@ -53,4 +54,5 @@ export const RESOLVERS: Record string> = { LEARNINGS_SEARCH: generateLearningsSearch, LEARNINGS_LOG: generateLearningsLog, CONFIDENCE_CALIBRATION: generateConfidenceCalibration, + INVOKE_SKILL: generateInvokeSkill, }; diff --git a/scripts/resolvers/types.ts b/scripts/resolvers/types.ts index 891ea0cd..785f5a3a 100644 --- a/scripts/resolvers/types.ts +++ b/scripts/resolvers/types.ts @@ -40,3 +40,6 @@ export interface TemplateContext { paths: HostPaths; preambleTier?: number; // 1-4, controls which preamble sections are included } + +/** Resolver function signature. args is populated for parameterized placeholders like {{INVOKE_SKILL:name}}. */ +export type ResolverFn = (ctx: TemplateContext, args?: string[]) => string;