Merge branch 'main' into feat/optimize-naming

This commit is contained in:
pftom
2026-04-28 16:23:44 +08:00
2 changed files with 87 additions and 72 deletions
+76 -64
View File
@@ -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
View File
@@ -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;
} }