marketing-shibata50/multica
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat(skills): implement progressive loading for reduced token usage

Browse source 
Changed buildModelSkillsPrompt() to only output skill metadata (name + description)
instead of full instructions. Full instructions are now loaded on-demand when a
skill is triggered via the new buildSkillPromptForInjection() method.

This reduces initial system prompt size significantly for projects with many skills.

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Jiang Bohan 2026-02-02 16:00:38 +08:00
parent 64878d9fe1
commit 6f0be4a1cb
1 changed files with 36 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

45
src/agent/skills/index.ts
View file

@ -479,11 +479,13 @@ export class SkillManager {
}
/**
* Build skills prompt excluding user-only skills
* Build skills prompt excluding user-only skills (metadata only)
*
* Only includes skills that are model-invocable (disableModelInvocation !== true)
* Uses progressive loading: only outputs name + description, not full instructions
* Full instructions are loaded on-demand via getSkillInstructions() when a skill is triggered
*
* @returns Formatted skill documentation for AI system prompt
* @returns Formatted skill metadata for AI system prompt
*/
buildModelSkillsPrompt(): string {
this.ensureLoaded();
@ -501,20 +503,45 @@ export class SkillManager {
const parts: string[] = [];
parts.push("# Available Skills\n");
parts.push("You have access to the following skills:\n");
parts.push("You have access to the following skills. When you need to use a skill, the full instructions will be provided.\n");
for (const [id, skill] of modelSkills) {
const emoji = skill.frontmatter.metadata?.emoji ?? "🔧";
const name = skill.frontmatter.name;
const desc = skill.frontmatter.description ?? "No description provided";
parts.push(`## ${emoji} ${name} (${id})`);
parts.push(`${desc}\n`);
// Progressive loading: only output metadata, not full instructions
parts.push(`- ${emoji} **${name}** (\`${id}\`): ${desc}`);
}
if (skill.instructions) {
parts.push(skill.instructions);
parts.push("");
}
parts.push("");
return parts.join("\n");
}
/**
* Build full skill prompt for injection when a skill is triggered
*
* This is used for on-demand loading - when a skill is invoked,
* this method provides the complete instructions to inject into context
*
* @param skillId - Skill identifier
* @returns Formatted skill prompt with full instructions, or undefined if not found
*/
buildSkillPromptForInjection(skillId: string): string | undefined {
const skill = this.getSkill(skillId);
if (!skill) return undefined;
const emoji = skill.frontmatter.metadata?.emoji ?? "🔧";
const name = skill.frontmatter.name;
const desc = skill.frontmatter.description ?? "No description provided";
const parts: string[] = [];
parts.push(`# Skill: ${emoji} ${name}\n`);
parts.push(`${desc}\n`);
if (skill.instructions) {
parts.push("## Instructions\n");
parts.push(skill.instructions);
}
return parts.join("\n");