8808c672dc
웹 디자인 파이프라인 스킬과 이를 5개 에이전트에 설치하는 CLI 를 담은 모노레포. 스킬 (packages/skill) - SKILL.md 261줄 + 참조 문서 16개 3,349줄. progressive disclosure 로 본문은 절차와 인덱스만, 지식은 references/ 로 분리 - 0~6단계 파이프라인. 규모에 따라 전체·연장·국소 세 경로로 분기 - 하드 게이트 12개는 grep·카운트로 검증 가능한 것만. 취향 판단은 제외 - 미학 프리셋 5종, AI 슬롭 지문 목록, 한글 조판 규칙, SVG 필터·three.js·인터랙티브 모션·HTML-in-Canvas 실전 지침 설치 CLI (packages/cli, packages/core) - npx designpaca 온보딩 TUI. Claude Code · Codex · Cursor · Windsurf · AGENTS.md - 매니페스트에 설치 시점 해시를 기록해 사용자가 고친 파일은 update 가 건너뛴다 - 타깃별로 본문의 references/ 경로를 실제 설치 위치로 재작성 - AGENTS.md 는 항상 로드되므로 본문 대신 303자 포인터만 주입 - Windsurf 는 12,000자 상한 초과 시 설치를 차단 배포 (build/ci, .forgejo/workflows) - 태그 v* → 검사·테스트·빌드 → npmjs 배포 + Forgejo 레지스트리 미러 → draft 릴리스 → Cloudflare Pages. 재실행 멱등 근거 (research/) - 약 250개 웹 소스 조사 결과와 도그푸딩 검증 2건. 스킬의 모든 수치는 여기서 나온다 테스트 22개 통과 (core 16 · cli 6)
62 lines
2.1 KiB
TypeScript
62 lines
2.1 KiB
TypeScript
import type { Dirent } from "node:fs";
|
|
import fs from "node:fs/promises";
|
|
import path from "node:path";
|
|
import type { SkillSource } from "./types.ts";
|
|
|
|
/** 프론트매터를 본문과 분리한다. yaml 파서를 끌어오지 않으려고 필요한 필드만 얕게 읽는다. */
|
|
export function splitFrontmatter(md: string): { fm: Record<string, string>; body: string } {
|
|
const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(md);
|
|
if (!m) return { fm: {}, body: md };
|
|
const fm: Record<string, string> = {};
|
|
for (const line of (m[1] ?? "").split(/\r?\n/)) {
|
|
const kv = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line);
|
|
if (!kv) continue;
|
|
let v = (kv[2] ?? "").trim();
|
|
// 따옴표로 감싼 값의 따옴표만 벗긴다
|
|
if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
|
|
v = v.slice(1, -1);
|
|
}
|
|
fm[kv[1] as string] = v;
|
|
}
|
|
return { fm, body: md.slice(m[0].length) };
|
|
}
|
|
|
|
async function walk(dir: string, base = dir): Promise<string[]> {
|
|
const out: string[] = [];
|
|
let entries: Dirent[];
|
|
try {
|
|
entries = await fs.readdir(dir, { withFileTypes: true });
|
|
} catch {
|
|
return out;
|
|
}
|
|
for (const e of entries) {
|
|
const full = path.join(dir, e.name);
|
|
if (e.isDirectory()) out.push(...(await walk(full, base)));
|
|
else out.push(path.relative(base, full).split(path.sep).join("/"));
|
|
}
|
|
return out.sort();
|
|
}
|
|
|
|
/**
|
|
* 스킬 원본 디렉터리를 읽어 메모리에 올린다.
|
|
* SKILL.md 는 필수, 나머지(references/ 등)는 전부 그대로 따라간다.
|
|
*/
|
|
export async function loadSkillSource(root: string, version: string): Promise<SkillSource> {
|
|
const skillMd = await fs.readFile(path.join(root, "SKILL.md"), "utf8");
|
|
const { fm, body } = splitFrontmatter(skillMd);
|
|
|
|
const files = new Map<string, string>();
|
|
for (const rel of await walk(root)) {
|
|
if (rel === "SKILL.md") continue;
|
|
if (rel.endsWith(".orig") || rel === ".designpaca_version") continue;
|
|
files.set(rel, await fs.readFile(path.join(root, rel), "utf8"));
|
|
}
|
|
|
|
return {
|
|
version,
|
|
skillMd,
|
|
files,
|
|
body: body.trim(),
|
|
description: fm["description"] ?? "웹 디자인 파이프라인 스킬",
|
|
};
|
|
}
|