@winspan/claude-forge 8.51.0 → 8.53.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/CLAUDE.md +6 -6
  2. package/dist/cli/commands/skills.d.ts.map +1 -1
  3. package/dist/cli/commands/skills.js +115 -0
  4. package/dist/cli/commands/skills.js.map +1 -1
  5. package/dist/core/constants.d.ts +2 -0
  6. package/dist/core/constants.d.ts.map +1 -1
  7. package/dist/core/constants.js +4 -0
  8. package/dist/core/constants.js.map +1 -1
  9. package/dist/daemon/hook-sync.d.ts +17 -0
  10. package/dist/daemon/hook-sync.d.ts.map +1 -0
  11. package/dist/daemon/hook-sync.js +74 -0
  12. package/dist/daemon/hook-sync.js.map +1 -0
  13. package/dist/daemon/index.d.ts.map +1 -1
  14. package/dist/daemon/index.js +21 -1
  15. package/dist/daemon/index.js.map +1 -1
  16. package/dist/daemon/skill-sync.d.ts +21 -0
  17. package/dist/daemon/skill-sync.d.ts.map +1 -0
  18. package/dist/daemon/skill-sync.js +75 -0
  19. package/dist/daemon/skill-sync.js.map +1 -0
  20. package/dist/hooks/notification.sh +1 -1
  21. package/dist/hooks/post-tool-use.sh +1 -1
  22. package/dist/hooks/pre-tool-use.sh +1 -1
  23. package/dist/hooks/stop.sh +1 -1
  24. package/dist/hooks/user-prompt-submit.sh +1 -1
  25. package/dist/skills/official/code-simplifier.md +37 -1
  26. package/dist/skills/official/find-skills.md +120 -1
  27. package/dist/skills/official/official-api-design.md +14 -1
  28. package/dist/skills/official/official-architecture-decision.md +22 -1
  29. package/dist/skills/official/official-db-schema-design.md +19 -1
  30. package/dist/skills/official/official-debug.md +9 -1
  31. package/dist/skills/official/official-pr-review.md +1 -1
  32. package/dist/skills/official/official-security-hardening.md +7 -1
  33. package/dist/skills/official/planning-with-files.md +206 -2
  34. package/dist/skills/official/ui-ux-pro-max.md +88 -1
  35. package/dist/skills/official/webapp-testing.md +85 -1
  36. package/dist/skills/registry.d.ts +1 -1
  37. package/dist/skills/registry.d.ts.map +1 -1
  38. package/dist/skills/registry.js +2 -2
  39. package/dist/skills/registry.js.map +1 -1
  40. package/dist/skills/semantic-matcher.d.ts +2 -1
  41. package/dist/skills/semantic-matcher.d.ts.map +1 -1
  42. package/dist/skills/semantic-matcher.js +6 -3
  43. package/dist/skills/semantic-matcher.js.map +1 -1
  44. package/dist/skills/upgrade-engine.d.ts +91 -0
  45. package/dist/skills/upgrade-engine.d.ts.map +1 -0
  46. package/dist/skills/upgrade-engine.js +436 -0
  47. package/dist/skills/upgrade-engine.js.map +1 -0
  48. package/dist/skills/upgrade-prompt.d.ts +20 -0
  49. package/dist/skills/upgrade-prompt.d.ts.map +1 -0
  50. package/dist/skills/upgrade-prompt.js +75 -0
  51. package/dist/skills/upgrade-prompt.js.map +1 -0
  52. package/docs/design/skill-ai-upgrade-spec-20260518-1930.md +297 -0
  53. package/docs/implementation/daemon-skill-sync-changelog-20260518-2000.md +22 -0
  54. package/docs/implementation/skill-ai-upgrade-changelog-20260518-1930.md +49 -0
  55. package/package.json +1 -1
  56. package/src/cli/commands/skills.ts +143 -0
  57. package/src/core/constants.ts +5 -0
  58. package/src/daemon/hook-sync.ts +91 -0
  59. package/src/daemon/index.ts +21 -1
  60. package/src/daemon/skill-sync.ts +88 -0
  61. package/src/hooks/notification.sh +1 -1
  62. package/src/hooks/post-tool-use.sh +1 -1
  63. package/src/hooks/pre-tool-use.sh +1 -1
  64. package/src/hooks/stop.sh +1 -1
  65. package/src/hooks/user-prompt-submit.sh +1 -1
  66. package/src/skills/official/code-simplifier.md +37 -1
  67. package/src/skills/official/find-skills.md +120 -1
  68. package/src/skills/official/official-api-design.md +14 -1
  69. package/src/skills/official/official-architecture-decision.md +22 -1
  70. package/src/skills/official/official-db-schema-design.md +19 -1
  71. package/src/skills/official/official-debug.md +9 -1
  72. package/src/skills/official/official-pr-review.md +1 -1
  73. package/src/skills/official/official-security-hardening.md +7 -1
  74. package/src/skills/official/planning-with-files.md +206 -2
  75. package/src/skills/official/ui-ux-pro-max.md +88 -1
  76. package/src/skills/official/webapp-testing.md +85 -1
  77. package/src/skills/registry.ts +2 -2
  78. package/src/skills/semantic-matcher.ts +6 -3
  79. package/src/skills/upgrade-engine.ts +541 -0
  80. package/src/skills/upgrade-prompt.ts +84 -0
  81. package/tests/unit/daemon/hook-sync.test.ts +71 -0
  82. package/tests/unit/daemon/skill-sync.test.ts +75 -0
  83. package/tests/unit/skills/upgrade-engine-parse.test.ts +138 -0
  84. package/tests/unit/skills/upgrade-engine.test.ts +401 -0
  85. package/tests/unit/skills/upgrade-prompt.test.ts +89 -0
@@ -0,0 +1,436 @@
1
+ /**
2
+ * upgrade-engine.ts
3
+ *
4
+ * Orchestrates the AI-assisted official skill upgrade pipeline.
5
+ * Does NOT contain AI prompt strings — those live in upgrade-prompt.ts.
6
+ */
7
+ import { exec } from 'node:child_process';
8
+ import { promises as fs, readFileSync } from 'node:fs';
9
+ import path from 'node:path';
10
+ import { promisify } from 'node:util';
11
+ import matter from 'gray-matter';
12
+ import { buildEvaluationPrompt } from './upgrade-prompt.js';
13
+ import { logger } from '../core/utils/logger.js';
14
+ const execAsync = promisify(exec);
15
+ // ── Default candidate sources ───────────────────────────────────────────────
16
+ export const DEFAULT_SOURCES = [
17
+ { name: 'agent-skills', url: 'https://github.com/addyosmani/agent-skills.git' },
18
+ { name: 'superpowers', url: 'https://github.com/obra/superpowers.git' },
19
+ ];
20
+ // ── Helpers ─────────────────────────────────────────────────────────────────
21
+ /**
22
+ * Parse a .md file into a CandidateSkill.
23
+ * If frontmatter is missing, falls back to filename-based id.
24
+ */
25
+ function parseCandidateFile(filePath, sourceName) {
26
+ try {
27
+ const raw = readFileSync(filePath, 'utf-8');
28
+ const parsed = matter(raw);
29
+ const { data } = parsed;
30
+ const fileName = path.basename(filePath, '.md');
31
+ const id = typeof data.name === 'string' ? data.name : fileName;
32
+ const name = typeof data.name === 'string' ? data.name : fileName;
33
+ const description = typeof data.description === 'string' ? data.description : '';
34
+ const rawKeywords = data.keywords ?? data.tags;
35
+ const keywords = Array.isArray(rawKeywords)
36
+ ? rawKeywords.filter((k) => typeof k === 'string')
37
+ : [];
38
+ return {
39
+ id,
40
+ source: sourceName,
41
+ filePath,
42
+ name,
43
+ description,
44
+ keywords,
45
+ content: raw,
46
+ };
47
+ }
48
+ catch {
49
+ return null;
50
+ }
51
+ }
52
+ /**
53
+ * Recursively scan a directory for .md files.
54
+ * Supports both directory/SKILL.md format (agent-skills) and flat *.md format.
55
+ */
56
+ async function scanMdFiles(dir) {
57
+ const results = [];
58
+ async function walk(current) {
59
+ let entries;
60
+ try {
61
+ entries = await fs.readdir(current, { withFileTypes: true });
62
+ }
63
+ catch {
64
+ return;
65
+ }
66
+ for (const entry of entries) {
67
+ const fullPath = path.join(current, entry.name);
68
+ if (entry.isDirectory()) {
69
+ // Check for SKILL.md inside this directory (agent-skills format)
70
+ const skillMd = path.join(fullPath, 'SKILL.md');
71
+ try {
72
+ await fs.access(skillMd);
73
+ results.push(skillMd);
74
+ }
75
+ catch {
76
+ // Recurse into sub-directories that don't have SKILL.md directly
77
+ await walk(fullPath);
78
+ }
79
+ }
80
+ else if (entry.isFile() && entry.name.endsWith('.md') && entry.name !== 'README.md') {
81
+ results.push(fullPath);
82
+ }
83
+ }
84
+ }
85
+ await walk(dir);
86
+ return results;
87
+ }
88
+ // ── Exported pipeline functions ─────────────────────────────────────────────
89
+ /**
90
+ * Clone or pull each source into `candidatesDir/<source.name>/`, then scan
91
+ * all .md files and parse them into CandidateSkill objects.
92
+ * Individual source failures are caught and logged; they do not abort the run.
93
+ */
94
+ export async function pullCandidates(sources, candidatesDir) {
95
+ await fs.mkdir(candidatesDir, { recursive: true });
96
+ const candidates = [];
97
+ for (const source of sources) {
98
+ const targetDir = path.join(candidatesDir, source.name);
99
+ let exists = false;
100
+ try {
101
+ await fs.access(targetDir);
102
+ exists = true;
103
+ }
104
+ catch { /* not exists */ }
105
+ // Try pull/clone, but don't abort scan if pull fails on existing dir
106
+ try {
107
+ if (exists) {
108
+ logger.info(`[upgrade] Pulling ${source.name}...`);
109
+ await execAsync(`git -C "${targetDir}" pull --ff-only`, { timeout: 60_000 });
110
+ }
111
+ else {
112
+ logger.info(`[upgrade] Cloning ${source.name}...`);
113
+ await execAsync(`git clone --depth=1 "${source.url}" "${targetDir}"`, { timeout: 120_000 });
114
+ }
115
+ }
116
+ catch (err) {
117
+ const msg = err instanceof Error ? err.message : String(err);
118
+ if (exists) {
119
+ logger.warn(`[upgrade] ${source.name} pull failed (using existing checkout): ${msg}`);
120
+ }
121
+ else {
122
+ logger.warn(`[upgrade] ${source.name} clone failed, skipping: ${msg}`);
123
+ continue;
124
+ }
125
+ }
126
+ // Always scan if dir exists (even when pull fails — old checkout is better than nothing)
127
+ try {
128
+ const mdFiles = await scanMdFiles(targetDir);
129
+ for (const filePath of mdFiles) {
130
+ const candidate = parseCandidateFile(filePath, source.name);
131
+ if (candidate) {
132
+ candidates.push(candidate);
133
+ }
134
+ }
135
+ logger.info(`[upgrade] ${source.name}: ${mdFiles.length} .md files found`);
136
+ }
137
+ catch (err) {
138
+ const msg = err instanceof Error ? err.message : String(err);
139
+ logger.warn(`[upgrade] Skipping source ${source.name}: ${msg}`);
140
+ }
141
+ }
142
+ return candidates;
143
+ }
144
+ /**
145
+ * Match a candidate skill to the best official skill using keyword + name token
146
+ * overlap. Returns null if the best score is below the 30-point threshold.
147
+ */
148
+ export function matchToOfficial(candidate, officialSkills) {
149
+ /** Tokenise a string into lowercase words / tokens. */
150
+ function tokenise(text) {
151
+ return new Set(text
152
+ .toLowerCase()
153
+ .replace(/[^a-z0-9一-鿿\s-]/g, ' ')
154
+ .split(/[\s-]+/)
155
+ .filter((t) => t.length > 1));
156
+ }
157
+ /** Jaccard-like overlap score (0–100). */
158
+ function overlapScore(aSet, bSet) {
159
+ if (aSet.size === 0 && bSet.size === 0)
160
+ return 0;
161
+ let intersection = 0;
162
+ for (const t of aSet) {
163
+ if (bSet.has(t))
164
+ intersection++;
165
+ }
166
+ const union = new Set([...aSet, ...bSet]).size;
167
+ return union === 0 ? 0 : Math.round((intersection / union) * 100);
168
+ }
169
+ const candidateKeywordTokens = tokenise(candidate.keywords.join(' '));
170
+ const candidateNameTokens = tokenise(candidate.name + ' ' + candidate.description);
171
+ let best = null;
172
+ for (const official of officialSkills) {
173
+ const officialKeywordTokens = tokenise(official.keywords.join(' '));
174
+ const officialNameTokens = tokenise(official.name + ' ' + official.description);
175
+ // keyword overlap (weight 60) + name/description token overlap (weight 40)
176
+ const keywordScore = overlapScore(candidateKeywordTokens, officialKeywordTokens);
177
+ const nameScore = overlapScore(candidateNameTokens, officialNameTokens);
178
+ let combined = Math.round(keywordScore * 0.6 + nameScore * 0.4);
179
+ // Substring boost: candidate id/name contains official keyword (or vice versa)
180
+ // helps with English↔中文 token mismatch (e.g. "debugging" ↔ "debug"/"调试")
181
+ const candidateText = (candidate.id + ' ' + candidate.name + ' ' + candidate.description).toLowerCase();
182
+ const officialText = (official.name + ' ' + official.description).toLowerCase();
183
+ for (const kw of official.keywords) {
184
+ const kwLower = kw.toLowerCase();
185
+ if (kwLower.length >= 3 && candidateText.includes(kwLower)) {
186
+ combined = Math.max(combined, 50);
187
+ break;
188
+ }
189
+ }
190
+ for (const kw of candidate.keywords) {
191
+ const kwLower = kw.toLowerCase();
192
+ if (kwLower.length >= 3 && officialText.includes(kwLower)) {
193
+ combined = Math.max(combined, 50);
194
+ break;
195
+ }
196
+ }
197
+ if (combined >= 15) {
198
+ if (!best || combined > best.score) {
199
+ best = { officialId: official.name, score: combined };
200
+ }
201
+ }
202
+ }
203
+ return best;
204
+ }
205
+ /**
206
+ * Ask the AI provider to evaluate whether a candidate should upgrade / merge /
207
+ * skip the matched official skill. Returns a parsed UpgradeDecision.
208
+ *
209
+ * On JSON parse failure → returns { action: 'skip', confidence: 0, reasoning:
210
+ * 'AI response could not be parsed', merged_content: null } with needs_review=true
211
+ * embedded in the reasoning (caller promotes to needs_review).
212
+ */
213
+ export async function evaluateWithAI(candidate, official, aiProvider) {
214
+ const { system, user } = buildEvaluationPrompt(candidate, official);
215
+ let raw;
216
+ try {
217
+ raw = await aiProvider.complete(user, {
218
+ system,
219
+ maxTokens: 1200,
220
+ timeoutMs: 45_000,
221
+ maxRetries: 2,
222
+ });
223
+ }
224
+ catch (err) {
225
+ const msg = err instanceof Error ? err.message : String(err);
226
+ return {
227
+ action: 'skip',
228
+ confidence: 0,
229
+ reasoning: `AI 调用失败: ${msg}`,
230
+ merged_content: null,
231
+ needs_review: true,
232
+ };
233
+ }
234
+ // Strip markdown code fences if model wrapped the JSON
235
+ const stripped = raw
236
+ .replace(/^```(?:json)?\s*/im, '')
237
+ .replace(/\s*```$/im, '')
238
+ .trim();
239
+ try {
240
+ const parsed = JSON.parse(stripped);
241
+ const validActions = new Set(['upgrade', 'merge', 'skip']);
242
+ const action = typeof parsed.action === 'string' && validActions.has(parsed.action)
243
+ ? parsed.action
244
+ : 'skip';
245
+ const confidence = typeof parsed.confidence === 'number'
246
+ ? Math.max(0, Math.min(100, parsed.confidence))
247
+ : 0;
248
+ const reasoning = typeof parsed.reasoning === 'string' ? parsed.reasoning : '';
249
+ const merged_content = typeof parsed.merged_content === 'string' ? parsed.merged_content : null;
250
+ return { action, confidence, reasoning, merged_content };
251
+ }
252
+ catch {
253
+ return {
254
+ action: 'skip',
255
+ confidence: 0,
256
+ reasoning: `AI 返回内容无法解析为 JSON,需人工审核。原始响应片段: ${stripped.slice(0, 200)}`,
257
+ merged_content: null,
258
+ needs_review: true,
259
+ };
260
+ }
261
+ }
262
+ /**
263
+ * Write the upgrade report as a markdown file with embedded HTML comment
264
+ * machine markers for `applyDecisions` to parse.
265
+ */
266
+ export async function generateReport(entries, outputPath, stats) {
267
+ const now = new Date();
268
+ const timestamp = now.toISOString().replace('T', ' ').slice(0, 16);
269
+ const actionCounts = { upgrade: 0, merge: 0, skip: 0, error: 0, needs_review: 0 };
270
+ for (const e of entries) {
271
+ if (e.action in actionCounts) {
272
+ actionCounts[e.action]++;
273
+ }
274
+ }
275
+ const lines = [
276
+ '# Skill Upgrade Report',
277
+ '',
278
+ `Generated: ${timestamp}`,
279
+ '',
280
+ '## Summary',
281
+ '',
282
+ '| Metric | Count |',
283
+ '|--------|-------|',
284
+ `| Candidates scanned | ${stats.total} |`,
285
+ `| Matched to official | ${stats.matched} |`,
286
+ `| Action: upgrade | ${actionCounts.upgrade} |`,
287
+ `| Action: merge | ${actionCounts.merge} |`,
288
+ `| Action: skip | ${actionCounts.skip} |`,
289
+ `| Needs review | ${actionCounts.needs_review} |`,
290
+ `| Error | ${actionCounts.error} |`,
291
+ `| Unmatched | ${stats.unmatched} |`,
292
+ '',
293
+ '## Per-Skill Decisions',
294
+ '',
295
+ ];
296
+ for (const entry of entries) {
297
+ lines.push(`### ${entry.officialId}`);
298
+ lines.push(`- **Action**: ${entry.action}`);
299
+ lines.push(`- **Confidence**: ${entry.confidence}%`);
300
+ lines.push(`- **Candidate**: \`${entry.candidateSource}/${entry.candidateId}\``);
301
+ lines.push(`- **Candidate path**: \`${entry.candidateFilePath}\``);
302
+ lines.push(`- **Reasoning**: ${entry.reasoning}`);
303
+ // Machine-readable marker for applyDecisions
304
+ lines.push('');
305
+ lines.push(`<!-- upgrade-entry: ${entry.officialId} | ${entry.candidateFilePath} | ${entry.action} -->`);
306
+ if (entry.action === 'merge' && entry.merged_content) {
307
+ lines.push('');
308
+ lines.push('<!-- merged-content-begin -->');
309
+ lines.push(entry.merged_content);
310
+ lines.push('<!-- merged-content-end -->');
311
+ }
312
+ lines.push('');
313
+ }
314
+ await fs.mkdir(path.dirname(outputPath), { recursive: true });
315
+ await fs.writeFile(outputPath, lines.join('\n'), 'utf-8');
316
+ logger.info(`[upgrade] Report written to ${outputPath}`);
317
+ }
318
+ /**
319
+ * Apply the decisions recorded in a report file to the official skills directory.
320
+ *
321
+ * Safety checks:
322
+ * 1. `git status --porcelain <officialDir>` must be clean
323
+ * 2. Full backup created in `backupBaseDir/<YYYYMMDD-HHMM>/` (conflict → -2/-3)
324
+ *
325
+ * Returns { applied, skipped, backupPath }.
326
+ */
327
+ export async function applyDecisions(reportPath, officialDir, backupBaseDir) {
328
+ // 1. Check git working tree is clean
329
+ try {
330
+ const { stdout } = await execAsync(`git status --porcelain "${officialDir}"`);
331
+ if (stdout.trim().length > 0) {
332
+ throw new Error(`Working tree is dirty in ${officialDir}. Commit or stash changes before applying.\n${stdout}`);
333
+ }
334
+ }
335
+ catch (err) {
336
+ // If git is not available or it's not a repo, rethrow only for dirty-tree errors
337
+ const msg = err instanceof Error ? err.message : String(err);
338
+ if (msg.includes('Working tree is dirty'))
339
+ throw err;
340
+ logger.warn(`[upgrade] git status check failed (not a git repo?): ${msg}`);
341
+ }
342
+ // 2. Create timestamped backup directory
343
+ const ts = new Date()
344
+ .toISOString()
345
+ .replace(/[-:]/g, '')
346
+ .replace('T', '-')
347
+ .slice(0, 13); // YYYYMMDD-HHM -> need YYYYMMDD-HHMM format
348
+ const tsFormatted = (() => {
349
+ const d = new Date();
350
+ const YYYY = d.getFullYear();
351
+ const MM = String(d.getMonth() + 1).padStart(2, '0');
352
+ const DD = String(d.getDate()).padStart(2, '0');
353
+ const HH = String(d.getHours()).padStart(2, '0');
354
+ const mm = String(d.getMinutes()).padStart(2, '0');
355
+ return `${YYYY}${MM}${DD}-${HH}${mm}`;
356
+ })();
357
+ let backupPath = path.join(backupBaseDir, tsFormatted);
358
+ // Handle conflict: try -2, -3, ...
359
+ let suffix = 2;
360
+ while (true) {
361
+ try {
362
+ await fs.access(backupPath);
363
+ // Directory exists — try next suffix
364
+ backupPath = path.join(backupBaseDir, `${tsFormatted}-${suffix}`);
365
+ suffix++;
366
+ }
367
+ catch {
368
+ break; // doesn't exist, we can use it
369
+ }
370
+ }
371
+ await fs.mkdir(backupPath, { recursive: true });
372
+ // Copy all .md files from officialDir into backup
373
+ const officialFiles = (await fs.readdir(officialDir)).filter((f) => f.endsWith('.md'));
374
+ for (const file of officialFiles) {
375
+ await fs.copyFile(path.join(officialDir, file), path.join(backupPath, file));
376
+ }
377
+ logger.info(`[upgrade] Backed up ${officialFiles.length} files to ${backupPath}`);
378
+ // 3. Parse report
379
+ const reportContent = await fs.readFile(reportPath, 'utf-8');
380
+ // Parse <!-- upgrade-entry: id | path | action --> markers
381
+ const entryPattern = /<!-- upgrade-entry: (.+?) \| (.+?) \| (.+?) -->/g;
382
+ let match;
383
+ const entries = [];
384
+ while ((match = entryPattern.exec(reportContent)) !== null) {
385
+ entries.push({
386
+ officialId: match[1].trim(),
387
+ candidatePath: match[2].trim(),
388
+ action: match[3].trim(),
389
+ });
390
+ }
391
+ // Parse merged content blocks
392
+ const mergedContentMap = new Map();
393
+ // Associate merged-content blocks with the preceding entry
394
+ const mergedPattern = /<!-- upgrade-entry: (.+?) \| (.+?) \| merge -->[\s\S]*?<!-- merged-content-begin -->\n([\s\S]*?)\n<!-- merged-content-end -->/g;
395
+ while ((match = mergedPattern.exec(reportContent)) !== null) {
396
+ mergedContentMap.set(match[1].trim(), match[3]);
397
+ }
398
+ let applied = 0;
399
+ let skipped = 0;
400
+ for (const entry of entries) {
401
+ if (entry.action === 'skip' || entry.action === 'error' || entry.action === 'needs_review') {
402
+ skipped++;
403
+ continue;
404
+ }
405
+ const targetFile = path.join(officialDir, `${entry.officialId}.md`);
406
+ try {
407
+ if (entry.action === 'upgrade') {
408
+ // Copy candidate file content
409
+ const candidateContent = await fs.readFile(entry.candidatePath, 'utf-8');
410
+ await fs.writeFile(targetFile, candidateContent, 'utf-8');
411
+ applied++;
412
+ logger.info(`[upgrade] Applied upgrade: ${entry.officialId}`);
413
+ }
414
+ else if (entry.action === 'merge') {
415
+ const mergedContent = mergedContentMap.get(entry.officialId);
416
+ if (mergedContent) {
417
+ await fs.writeFile(targetFile, mergedContent, 'utf-8');
418
+ applied++;
419
+ logger.info(`[upgrade] Applied merge: ${entry.officialId}`);
420
+ }
421
+ else {
422
+ logger.warn(`[upgrade] Merge entry ${entry.officialId} has no merged content; skipping`);
423
+ skipped++;
424
+ }
425
+ }
426
+ }
427
+ catch (err) {
428
+ const msg = err instanceof Error ? err.message : String(err);
429
+ logger.error(`[upgrade] Failed to apply ${entry.officialId}: ${msg}`);
430
+ skipped++;
431
+ }
432
+ }
433
+ logger.info(`[upgrade] Apply complete: ${applied} applied, ${skipped} skipped`);
434
+ return { applied, skipped, backupPath };
435
+ }
436
+ //# sourceMappingURL=upgrade-engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upgrade-engine.js","sourceRoot":"","sources":["../../src/skills/upgrade-engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * upgrade-prompt.ts
3
+ *
4
+ * Builds the system + user prompts for AI-assisted skill evaluation.
5
+ * Pure functions — no I/O, no side effects.
6
+ */
7
+ import type { CandidateSkill } from './upgrade-engine.js';
8
+ import type { OfficialSkill } from './official-skills.js';
9
+ /**
10
+ * Build system + user prompts for evaluating whether a candidate skill should
11
+ * upgrade, merge with, or skip an official skill.
12
+ *
13
+ * The system prompt defines the decision criteria and output JSON contract.
14
+ * The user prompt contains the two skill bodies (capped at 2000 chars each).
15
+ */
16
+ export declare function buildEvaluationPrompt(candidate: CandidateSkill, official: OfficialSkill): {
17
+ system: string;
18
+ user: string;
19
+ };
20
+ //# sourceMappingURL=upgrade-prompt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upgrade-prompt.d.ts","sourceRoot":"","sources":["../../src/skills/upgrade-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAa1D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,aAAa,GACtB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAoDlC"}
@@ -0,0 +1,75 @@
1
+ /**
2
+ * upgrade-prompt.ts
3
+ *
4
+ * Builds the system + user prompts for AI-assisted skill evaluation.
5
+ * Pure functions — no I/O, no side effects.
6
+ */
7
+ const MAX_CONTENT_CHARS = 2000;
8
+ /**
9
+ * Truncate content to at most `maxChars` characters, appending an ellipsis
10
+ * marker so the model knows the text was cut.
11
+ */
12
+ function truncate(text, maxChars = MAX_CONTENT_CHARS) {
13
+ if (text.length <= maxChars)
14
+ return text;
15
+ return text.slice(0, maxChars) + '\n\n...[content truncated]';
16
+ }
17
+ /**
18
+ * Build system + user prompts for evaluating whether a candidate skill should
19
+ * upgrade, merge with, or skip an official skill.
20
+ *
21
+ * The system prompt defines the decision criteria and output JSON contract.
22
+ * The user prompt contains the two skill bodies (capped at 2000 chars each).
23
+ */
24
+ export function buildEvaluationPrompt(candidate, official) {
25
+ const system = `你是 Claude Code skill 内容评估专家。
26
+
27
+ 你的任务是比较"候选 skill"和"官方 skill",决定如何处理。
28
+
29
+ ## 评估维度
30
+ - **主题重叠度**:两个 skill 覆盖的领域是否高度相关
31
+ - **内容质量**:深度、广度、实例丰富程度、可操作性
32
+ - **互补性**:候选是否包含官方 skill 未涵盖的独特章节
33
+
34
+ ## 决策标准
35
+ - **skip**:主题不重叠,或官方 skill 已完整覆盖候选内容,合并无额外价值
36
+ - **upgrade**:候选覆盖官方 skill 的全部核心要点,且整体质量明显更高(深度/广度提升 ≥30%),用候选直接替换官方版本
37
+ - **merge**:主题相同但各有独特章节,合并后整体价值更高,需要生成合并后完整内容
38
+
39
+ ## 输出格式
40
+ 必须返回严格的 JSON,不含任何其他文本、代码块标记或注释:
41
+ {"action":"upgrade|merge|skip","confidence":0-100,"reasoning":"简短中文说明(<200字)","merged_content":null或合并后完整md字符串}
42
+
43
+ ## merged_content 规则
44
+ - action = merge → 提供合并后的完整 .md 文件内容(含 frontmatter)
45
+ - action = upgrade → null(直接使用候选原文)
46
+ - action = skip → null`;
47
+ const user = `## 官方 Skill(目标)
48
+
49
+ **ID**: ${official.name}
50
+ **描述**: ${official.description}
51
+ **关键词**: ${official.keywords.join(', ') || '(无)'}
52
+
53
+ \`\`\`markdown
54
+ ${truncate(official.content)}
55
+ \`\`\`
56
+
57
+ ---
58
+
59
+ ## 候选 Skill(来源: ${candidate.source})
60
+
61
+ **ID**: ${candidate.id}
62
+ **名称**: ${candidate.name}
63
+ **描述**: ${candidate.description}
64
+ **关键词**: ${candidate.keywords.join(', ') || '(无)'}
65
+
66
+ \`\`\`markdown
67
+ ${truncate(candidate.content)}
68
+ \`\`\`
69
+
70
+ ---
71
+
72
+ 请评估候选 skill 相对于官方 skill 的升级价值,返回 JSON。`;
73
+ return { system, user };
74
+ }
75
+ //# sourceMappingURL=upgrade-prompt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upgrade-prompt.js","sourceRoot":"","sources":["../../src/skills/upgrade-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B;;;GAGG;AACH,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAQ,GAAG,iBAAiB;IAC1D,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,4BAA4B,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAyB,EACzB,QAAuB;IAEvB,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;yBAqBQ,CAAC;IAExB,MAAM,IAAI,GAAG;;UAEL,QAAQ,CAAC,IAAI;UACb,QAAQ,CAAC,WAAW;WACnB,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK;;;EAG9C,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;;;;;kBAKV,SAAS,CAAC,MAAM;;UAExB,SAAS,CAAC,EAAE;UACZ,SAAS,CAAC,IAAI;UACd,SAAS,CAAC,WAAW;WACpB,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK;;;EAG/C,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC;;;;;uCAKU,CAAC;IAEtC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}