Merge branch 'main' into feat/optimize-naming
This commit is contained in:
+76
-64
@@ -2,9 +2,9 @@
|
|||||||
// front-matter, returns listing. No watching in this MVP — re-scans on every
|
// front-matter, returns listing. No watching in this MVP — re-scans on every
|
||||||
// GET /api/skills, which is fine for dozens of skills.
|
// GET /api/skills, which is fine for dozens of skills.
|
||||||
|
|
||||||
import { readdir, readFile, stat } from 'node:fs/promises';
|
import { readdir, readFile, stat } from "node:fs/promises";
|
||||||
import path from 'node:path';
|
import path from "node:path";
|
||||||
import { parseFrontmatter } from './frontmatter.js';
|
import { parseFrontmatter } from "./frontmatter.js";
|
||||||
|
|
||||||
export async function listSkills(skillsRoot) {
|
export async function listSkills(skillsRoot) {
|
||||||
const out = [];
|
const out = [];
|
||||||
@@ -17,26 +17,32 @@ export async function listSkills(skillsRoot) {
|
|||||||
for (const entry of entries) {
|
for (const entry of entries) {
|
||||||
if (!entry.isDirectory()) continue;
|
if (!entry.isDirectory()) continue;
|
||||||
const dir = path.join(skillsRoot, entry.name);
|
const dir = path.join(skillsRoot, entry.name);
|
||||||
const skillPath = path.join(dir, 'SKILL.md');
|
const skillPath = path.join(dir, "SKILL.md");
|
||||||
try {
|
try {
|
||||||
const stats = await stat(skillPath);
|
const stats = await stat(skillPath);
|
||||||
if (!stats.isFile()) continue;
|
if (!stats.isFile()) continue;
|
||||||
const raw = await readFile(skillPath, 'utf8');
|
const raw = await readFile(skillPath, "utf8");
|
||||||
const { data, body } = parseFrontmatter(raw);
|
const { data, body } = parseFrontmatter(raw);
|
||||||
const hasAttachments = await dirHasAttachments(dir);
|
const hasAttachments = await dirHasAttachments(dir);
|
||||||
const mode = data.od?.mode || inferMode(body, data.description);
|
const mode = data.od?.mode || inferMode(body, data.description);
|
||||||
out.push({
|
out.push({
|
||||||
id: data.name || entry.name,
|
id: data.name || entry.name,
|
||||||
name: data.name || entry.name,
|
name: data.name || entry.name,
|
||||||
description: data.description || '',
|
description: data.description || "",
|
||||||
triggers: Array.isArray(data.triggers) ? data.triggers : [],
|
triggers: Array.isArray(data.triggers) ? data.triggers : [],
|
||||||
mode,
|
mode,
|
||||||
platform: normalizePlatform(data.od?.platform, mode, body, data.description),
|
platform: normalizePlatform(
|
||||||
|
data.od?.platform,
|
||||||
|
mode,
|
||||||
|
body,
|
||||||
|
data.description
|
||||||
|
),
|
||||||
scenario: normalizeScenario(data.od?.scenario, body, data.description),
|
scenario: normalizeScenario(data.od?.scenario, body, data.description),
|
||||||
previewType: data.od?.preview?.type || 'html',
|
previewType: data.od?.preview?.type || "html",
|
||||||
designSystemRequired: data.od?.design_system?.requires ?? true,
|
designSystemRequired: data.od?.design_system?.requires ?? true,
|
||||||
defaultFor: normalizeDefaultFor(data.od?.default_for),
|
defaultFor: normalizeDefaultFor(data.od?.default_for),
|
||||||
upstream: typeof data.od?.upstream === 'string' ? data.od.upstream : null,
|
upstream:
|
||||||
|
typeof data.od?.upstream === "string" ? data.od.upstream : null,
|
||||||
featured: normalizeFeatured(data.od?.featured),
|
featured: normalizeFeatured(data.od?.featured),
|
||||||
// Optional metadata hints used by 'Use this prompt' fast-create so
|
// Optional metadata hints used by 'Use this prompt' fast-create so
|
||||||
// the resulting project mirrors the shipped example.html. Each hint
|
// the resulting project mirrors the shipped example.html. Each hint
|
||||||
@@ -63,15 +69,15 @@ export async function listSkills(skillsRoot) {
|
|||||||
// open those files via absolute paths.
|
// open those files via absolute paths.
|
||||||
function withSkillRootPreamble(body, dir) {
|
function withSkillRootPreamble(body, dir) {
|
||||||
const preamble = [
|
const preamble = [
|
||||||
'> **Skill root (absolute):** `' + dir + '`',
|
"> **Skill root (absolute):** `" + dir + "`",
|
||||||
'>',
|
">",
|
||||||
'> This skill ships side files alongside `SKILL.md`. When the workflow',
|
"> This skill ships side files alongside `SKILL.md`. When the workflow",
|
||||||
'> below references relative paths such as `assets/template.html` or',
|
"> below references relative paths such as `assets/template.html` or",
|
||||||
'> `references/layouts.md`, resolve them against the skill root above and',
|
"> `references/layouts.md`, resolve them against the skill root above and",
|
||||||
'> open them via their full absolute path.',
|
"> open them via their full absolute path.",
|
||||||
'',
|
"",
|
||||||
'',
|
"",
|
||||||
].join('\n');
|
].join("\n");
|
||||||
return preamble + body;
|
return preamble + body;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -79,7 +85,9 @@ async function dirHasAttachments(dir) {
|
|||||||
try {
|
try {
|
||||||
const entries = await readdir(dir, { withFileTypes: true });
|
const entries = await readdir(dir, { withFileTypes: true });
|
||||||
return entries.some(
|
return entries.some(
|
||||||
(e) => e.name !== 'SKILL.md' && (e.isDirectory() || /\.(md|html|css|js|json|txt)$/i.test(e.name)),
|
(e) =>
|
||||||
|
e.name !== "SKILL.md" &&
|
||||||
|
(e.isDirectory() || /\.(md|html|css|js|json|txt)$/i.test(e.name))
|
||||||
);
|
);
|
||||||
} catch {
|
} catch {
|
||||||
return false;
|
return false;
|
||||||
@@ -96,7 +104,7 @@ function normalizeDefaultFor(value) {
|
|||||||
// 'high-fidelity' are meaningful — anything else collapses to null so the
|
// 'high-fidelity' are meaningful — anything else collapses to null so the
|
||||||
// caller falls back to the form default ('high-fidelity').
|
// caller falls back to the form default ('high-fidelity').
|
||||||
function normalizeFidelity(value) {
|
function normalizeFidelity(value) {
|
||||||
if (value === 'wireframe' || value === 'high-fidelity') return value;
|
if (value === "wireframe" || value === "high-fidelity") return value;
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -104,11 +112,11 @@ function normalizeFidelity(value) {
|
|||||||
// to a real boolean. Returns null for anything we can't interpret so the
|
// to a real boolean. Returns null for anything we can't interpret so the
|
||||||
// caller knows to fall back to the form default.
|
// caller knows to fall back to the form default.
|
||||||
function normalizeBoolHint(value) {
|
function normalizeBoolHint(value) {
|
||||||
if (typeof value === 'boolean') return value;
|
if (typeof value === "boolean") return value;
|
||||||
if (typeof value === 'string') {
|
if (typeof value === "string") {
|
||||||
const v = value.trim().toLowerCase();
|
const v = value.trim().toLowerCase();
|
||||||
if (v === 'true' || v === 'yes' || v === '1') return true;
|
if (v === "true" || v === "yes" || v === "1") return true;
|
||||||
if (v === 'false' || v === 'no' || v === '0') return false;
|
if (v === "false" || v === "no" || v === "0") return false;
|
||||||
}
|
}
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
@@ -119,8 +127,8 @@ function normalizeBoolHint(value) {
|
|||||||
// natural alphabetical order.
|
// natural alphabetical order.
|
||||||
function normalizeFeatured(value) {
|
function normalizeFeatured(value) {
|
||||||
if (value === true) return 1;
|
if (value === true) return 1;
|
||||||
if (typeof value === 'number' && Number.isFinite(value)) return value;
|
if (typeof value === "number" && Number.isFinite(value)) return value;
|
||||||
if (typeof value === 'string' && value.trim()) {
|
if (typeof value === "string" && value.trim()) {
|
||||||
const n = Number(value);
|
const n = Number(value);
|
||||||
if (Number.isFinite(n)) return n;
|
if (Number.isFinite(n)) return n;
|
||||||
}
|
}
|
||||||
@@ -133,66 +141,70 @@ function normalizeFeatured(value) {
|
|||||||
// serves as a passable starter prompt.
|
// serves as a passable starter prompt.
|
||||||
function derivePrompt(data) {
|
function derivePrompt(data) {
|
||||||
const explicit = data.od?.example_prompt;
|
const explicit = data.od?.example_prompt;
|
||||||
if (typeof explicit === 'string' && explicit.trim()) return explicit.trim();
|
if (typeof explicit === "string" && explicit.trim()) return explicit.trim();
|
||||||
const desc = typeof data.description === 'string' ? data.description.trim() : '';
|
const desc =
|
||||||
if (!desc) return '';
|
typeof data.description === "string" ? data.description.trim() : "";
|
||||||
const collapsed = desc.replace(/\s+/g, ' ').trim();
|
if (!desc) return "";
|
||||||
|
const collapsed = desc.replace(/\s+/g, " ").trim();
|
||||||
const firstSentence = collapsed.match(/^.+?[.!?。!?](?:\s|$)/)?.[0]?.trim();
|
const firstSentence = collapsed.match(/^.+?[.!?。!?](?:\s|$)/)?.[0]?.trim();
|
||||||
return (firstSentence || collapsed).slice(0, 320);
|
return (firstSentence || collapsed).slice(0, 320);
|
||||||
}
|
}
|
||||||
|
|
||||||
function inferMode(body, description) {
|
function inferMode(body, description) {
|
||||||
const hay = `${description ?? ''}\n${body ?? ''}`.toLowerCase();
|
const hay = `${description ?? ""}\n${body ?? ""}`.toLowerCase();
|
||||||
if (/\bppt|deck|slide|presentation|幻灯|投影/.test(hay)) return 'deck';
|
if (/\bppt|deck|slide|presentation|幻灯|投影/.test(hay)) return "deck";
|
||||||
if (/\bdesign[- ]system|\bdesign\.md|\bdesign tokens/.test(hay)) return 'design-system';
|
if (/\bdesign[- ]system|\bdesign\.md|\bdesign tokens/.test(hay))
|
||||||
if (/\btemplate\b/.test(hay)) return 'template';
|
return "design-system";
|
||||||
return 'prototype';
|
if (/\btemplate\b/.test(hay)) return "template";
|
||||||
|
return "prototype";
|
||||||
}
|
}
|
||||||
|
|
||||||
// Validate platform tag — only desktop / mobile are meaningful for the
|
// Validate platform tag — only desktop / mobile are meaningful for the
|
||||||
// Examples gallery. Falls back to autodetecting "mobile" from descriptions
|
// Examples gallery. Falls back to autodetecting "mobile" from descriptions
|
||||||
// so legacy skills sort under the right pill without authoring changes.
|
// so legacy skills sort under the right pill without authoring changes.
|
||||||
function normalizePlatform(value, mode, body, description) {
|
function normalizePlatform(value, mode, body, description) {
|
||||||
if (value === 'desktop' || value === 'mobile') return value;
|
if (value === "desktop" || value === "mobile") return value;
|
||||||
if (mode !== 'prototype') return null;
|
if (mode !== "prototype") return null;
|
||||||
const hay = `${description ?? ''}\n${body ?? ''}`.toLowerCase();
|
const hay = `${description ?? ""}\n${body ?? ""}`.toLowerCase();
|
||||||
if (/mobile|phone|ios|android|手机|移动端/.test(hay)) return 'mobile';
|
if (/mobile|phone|ios|android|手机|移动端/.test(hay)) return "mobile";
|
||||||
return 'desktop';
|
return "desktop";
|
||||||
}
|
}
|
||||||
|
|
||||||
// Normalise a scenario tag to a small fixed vocabulary so the filter pills
|
// Normalise a scenario tag to a small fixed vocabulary so the filter pills
|
||||||
// stay tidy. Unknown values pass through verbatim so authors can experiment;
|
// stay tidy. Unknown values pass through verbatim so authors can experiment;
|
||||||
// missing values default to "general".
|
// missing values default to "general".
|
||||||
const KNOWN_SCENARIOS = new Set([
|
const KNOWN_SCENARIOS = new Set([
|
||||||
'general',
|
"general",
|
||||||
'engineering',
|
"engineering",
|
||||||
'product',
|
"product",
|
||||||
'design',
|
"design",
|
||||||
'marketing',
|
"marketing",
|
||||||
'sales',
|
"sales",
|
||||||
'finance',
|
"finance",
|
||||||
'hr',
|
"hr",
|
||||||
'operations',
|
"operations",
|
||||||
'support',
|
"support",
|
||||||
'legal',
|
"legal",
|
||||||
'education',
|
"education",
|
||||||
'personal',
|
"personal",
|
||||||
]);
|
]);
|
||||||
function normalizeScenario(value, body, description) {
|
function normalizeScenario(value, body, description) {
|
||||||
if (typeof value === 'string') {
|
if (typeof value === "string") {
|
||||||
const v = value.trim().toLowerCase();
|
const v = value.trim().toLowerCase();
|
||||||
if (v) return v;
|
if (v) return v;
|
||||||
}
|
}
|
||||||
const hay = `${description ?? ''}\n${body ?? ''}`.toLowerCase();
|
const hay = `${description ?? ""}\n${body ?? ""}`.toLowerCase();
|
||||||
if (/finance|invoice|expense|budget|p&l|revenue/.test(hay)) return 'finance';
|
if (/finance|invoice|expense|budget|p&l|revenue/.test(hay)) return "finance";
|
||||||
if (/\bhr\b|onboarding|payroll|employee|人事/.test(hay)) return 'hr';
|
if (/\bhr\b|onboarding|payroll|employee|人事/.test(hay)) return "hr";
|
||||||
if (/marketing|campaign|brand|landing/.test(hay)) return 'marketing';
|
if (/marketing|campaign|brand|landing/.test(hay)) return "marketing";
|
||||||
if (/runbook|incident|deploy|engineering|sre|api/.test(hay)) return 'engineering';
|
if (/runbook|incident|deploy|engineering|sre|api/.test(hay))
|
||||||
if (/spec|prd|roadmap|product manager|product team/.test(hay)) return 'product';
|
return "engineering";
|
||||||
if (/design system|moodboard|mockup|ui kit/.test(hay)) return 'design';
|
if (/spec|prd|roadmap|product manager|product team/.test(hay))
|
||||||
if (/sales|quote|proposal|lead/.test(hay)) return 'sales';
|
return "product";
|
||||||
if (/operations|ops|logistics|inventory/.test(hay)) return 'operations';
|
if (/design system|moodboard|mockup|ui kit/.test(hay)) return "design";
|
||||||
return 'general';
|
if (/sales|quote|proposal|lead/.test(hay)) return "sales";
|
||||||
|
if (/operations|ops|logistics|inventory/.test(hay)) return "operations";
|
||||||
|
return "general";
|
||||||
}
|
}
|
||||||
// Surface the vocabulary so callers (frontend filter UI) could mirror it
|
// Surface the vocabulary so callers (frontend filter UI) could mirror it
|
||||||
// later if they want to. Not exported today, kept here for documentation.
|
// later if they want to. Not exported today, kept here for documentation.
|
||||||
|
|||||||
+11
-8
@@ -16,10 +16,10 @@
|
|||||||
*/
|
*/
|
||||||
export function buildSrcdoc(
|
export function buildSrcdoc(
|
||||||
html: string,
|
html: string,
|
||||||
options: { deck?: boolean } = {},
|
options: { deck?: boolean } = {}
|
||||||
): string {
|
): string {
|
||||||
const head = html.trimStart().slice(0, 64).toLowerCase();
|
const head = html.trimStart().slice(0, 64).toLowerCase();
|
||||||
const isFullDoc = head.startsWith('<!doctype') || head.startsWith('<html');
|
const isFullDoc = head.startsWith("<!doctype") || head.startsWith("<html");
|
||||||
const wrapped = isFullDoc
|
const wrapped = isFullDoc
|
||||||
? html
|
? html
|
||||||
: `<!doctype html>
|
: `<!doctype html>
|
||||||
@@ -68,8 +68,10 @@ function injectSandboxShim(doc: string): string {
|
|||||||
tryShim('localStorage');
|
tryShim('localStorage');
|
||||||
tryShim('sessionStorage');
|
tryShim('sessionStorage');
|
||||||
})();</script>`;
|
})();</script>`;
|
||||||
if (/<head[^>]*>/i.test(doc)) return doc.replace(/<head[^>]*>/i, (m) => `${m}${shim}`);
|
if (/<head[^>]*>/i.test(doc))
|
||||||
if (/<body[^>]*>/i.test(doc)) return doc.replace(/<body[^>]*>/i, (m) => `${m}${shim}`);
|
return doc.replace(/<head[^>]*>/i, (m) => `${m}${shim}`);
|
||||||
|
if (/<body[^>]*>/i.test(doc))
|
||||||
|
return doc.replace(/<body[^>]*>/i, (m) => `${m}${shim}`);
|
||||||
return shim + doc;
|
return shim + doc;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -101,10 +103,10 @@ function injectDeckBridge(doc: string): string {
|
|||||||
.stage, .deck-stage, .deck-shell { place-content: center !important; }
|
.stage, .deck-stage, .deck-shell { place-content: center !important; }
|
||||||
</style>`;
|
</style>`;
|
||||||
const docWithStyle = /<\/head>/i.test(doc)
|
const docWithStyle = /<\/head>/i.test(doc)
|
||||||
? doc.replace(/<\/head>/i, styleFix + '</head>')
|
? doc.replace(/<\/head>/i, styleFix + "</head>")
|
||||||
: /<head[^>]*>/i.test(doc)
|
: /<head[^>]*>/i.test(doc)
|
||||||
? doc.replace(/<head[^>]*>/i, (m) => m + styleFix)
|
? doc.replace(/<head[^>]*>/i, (m) => m + styleFix)
|
||||||
: styleFix + doc;
|
: styleFix + doc;
|
||||||
doc = docWithStyle;
|
doc = docWithStyle;
|
||||||
const script = `<script>(function(){
|
const script = `<script>(function(){
|
||||||
function slides(){ return document.querySelectorAll('.slide'); }
|
function slides(){ return document.querySelectorAll('.slide'); }
|
||||||
@@ -265,6 +267,7 @@ function injectDeckBridge(doc: string): string {
|
|||||||
}
|
}
|
||||||
observeSlides();
|
observeSlides();
|
||||||
})();</script>`;
|
})();</script>`;
|
||||||
if (/<\/body>/i.test(doc)) return doc.replace(/<\/body>/i, `${script}</body>`);
|
if (/<\/body>/i.test(doc))
|
||||||
|
return doc.replace(/<\/body>/i, `${script}</body>`);
|
||||||
return doc + script;
|
return doc + script;
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user