Function suggestSkillFromSession

src/skills/learning/skill-suggest.ts:114–128

(input: SkillSuggestionInput)

}

export function suggestSkillFromSession(input: SkillSuggestionInput): SkillSuggestion {
  const area = commonArea(input.changedFiles);
  const n = input.changedFiles.length;
  const multiFile = n >= 2 && n <= 12;        // focused multi-file = a pattern, not a one-off or a sprawl
  const focused = input.cohesion >= 0.6;       // concentrated in one module / connected cluster
  const verb = taskVerb(input.prompt);
  const score = (multiFile ? 0.4 : 0) + (focused ? 0.3 : 0) + (verb ? 0.3 : 0);
  // A skill is a cross-file pattern: multi-file is a hard gate (a one-file edit is never a skill).
  const worth = multiFile && score >= 0.6;
  const symbolsBit = input.touchedSymbols?.length ? ` touching ${input.touchedSymbols.slice(0, 3).join(', ')}` : '';
  const reason = worth
    ? `A focused ${verb ?? 'change'} across ${n} file(s) in ${area || 'one area'}${symbolsBit} (cohesion ${input.cohesion.toFixed(2)}) — a repeatable pattern worth capturing as a skill.`
    : `Not a clear reusable pattern (${n} file(s), cohesion ${input.cohesion.toFixed(2)}${verb ? '' : ', no clear task verb'}).`;
  return { worth, score, reason, proposedName: proposeSkillName(input.prompt), area };
}