@captain_z/zsk 0.1.0

package/dist/core/manifest.d.ts

@@ -0,0 +1,39 @@
+export declare const MANIFEST_FILENAME = "zsk-manifest.json";
+export declare const MANIFEST_SCHEMA_VERSION = 1;
+export type ManifestSkill = {
+    name: string;
+    version: string;
+    sha256: string;
+    relPath: string;
+};
+export type Manifest = {
+    $schema: string;
+    version: typeof MANIFEST_SCHEMA_VERSION;
+    zskVersion: string;
+    installedAt: string;
+    bundle: string | null;
+    skills: ManifestSkill[];
+};
+export type DriftKind = "clean" | "modified" | "missing";
+export type DriftEntry = {
+    name: string;
+    relPath: string;
+    kind: DriftKind;
+};
+export declare function readManifest(target: string): Promise<Manifest | null>;
+export declare function writeManifest(target: string, manifest: Manifest): Promise<void>;
+export declare function sha256File(content: Buffer | string): string;
+export declare function buildManifest(params: {
+    zskVersion: string;
+    bundle: string | null;
+    skills: ManifestSkill[];
+}): Manifest;
+/**
+ * Compare manifest-recorded skills against on-disk files.
+ * Returns per-skill drift classification:
+ *   clean    — disk matches manifest sha256
+ *   modified — file exists but sha256 differs (hand-edited)
+ *   missing  — file removed
+ */
+export declare function detectDrift(target: string, manifest: Manifest): Promise<DriftEntry[]>;
+export declare function hasManifest(target: string): Promise<boolean>;

package/dist/core/manifest.js

@@ -0,0 +1,89 @@
+// zsk-manifest.json — install-state contract for a target directory.
+//
+// Written by `zsk add`, consumed by `zsk add` (refresh path) / `zsk remove` /
+// `zsk doctor`. Schema v1 is intentionally minimal; see ARCHITECTURE.md §6.4.4.
+import { createHash } from "node:crypto";
+import { readFile, writeFile, access } from "node:fs/promises";
+import { join } from "node:path";
+export const MANIFEST_FILENAME = "zsk-manifest.json";
+export const MANIFEST_SCHEMA_VERSION = 1;
+export async function readManifest(target) {
+    const p = join(target, MANIFEST_FILENAME);
+    try {
+        const raw = await readFile(p, "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed.version !== MANIFEST_SCHEMA_VERSION) {
+            throw new Error(`Manifest schema mismatch at ${p} (expected v${MANIFEST_SCHEMA_VERSION}, got v${parsed.version})`);
+        }
+        return parsed;
+    }
+    catch (err) {
+        if (isENOENT(err))
+            return null;
+        throw err;
+    }
+}
+export async function writeManifest(target, manifest) {
+    const p = join(target, MANIFEST_FILENAME);
+    const body = `${JSON.stringify(manifest, null, 2)}\n`;
+    await writeFile(p, body, "utf8");
+}
+export function sha256File(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+export function buildManifest(params) {
+    return {
+        $schema: "https://zsk.codeshareman.dev/manifest.v1.json",
+        version: MANIFEST_SCHEMA_VERSION,
+        zskVersion: params.zskVersion,
+        installedAt: new Date().toISOString(),
+        bundle: params.bundle,
+        skills: params.skills,
+    };
+}
+/**
+ * Compare manifest-recorded skills against on-disk files.
+ * Returns per-skill drift classification:
+ *   clean    — disk matches manifest sha256
+ *   modified — file exists but sha256 differs (hand-edited)
+ *   missing  — file removed
+ */
+export async function detectDrift(target, manifest) {
+    const out = [];
+    for (const s of manifest.skills) {
+        const p = join(target, s.relPath);
+        try {
+            const buf = await readFile(p);
+            const digest = sha256File(buf);
+            out.push({
+                name: s.name,
+                relPath: s.relPath,
+                kind: digest === s.sha256 ? "clean" : "modified",
+            });
+        }
+        catch (err) {
+            if (isENOENT(err)) {
+                out.push({ name: s.name, relPath: s.relPath, kind: "missing" });
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    return out;
+}
+export async function hasManifest(target) {
+    try {
+        await access(join(target, MANIFEST_FILENAME));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isENOENT(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        err.code === "ENOENT");
+}
+//# sourceMappingURL=manifest.js.map

package/dist/core/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/core/manifest.ts"],"names":[],"mappings":"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"}

package/dist/core/scaffolder.d.ts

@@ -0,0 +1,14 @@
+export type ScaffoldResult = {
+    written: string[];
+    skipped: string[];
+};
+export declare function resolveTemplatesRoot(): Promise<string>;
+/**
+ * Recursively copy a template subtree into target dir.
+ * By default skips files that already exist (non-destructive).
+ */
+export declare function scaffoldTemplate(templateSubpath: string, target: string, opts?: {
+    overwrite?: boolean;
+}): Promise<ScaffoldResult>;
+declare function fileExists(p: string): Promise<boolean>;
+export { fileExists };

package/dist/core/scaffolder.js

@@ -0,0 +1,71 @@
+// Project scaffolder: copy templates into a target project directory.
+// Used by `zsk project-init` to bootstrap project-config.md / .raws/ / CLAUDE.md.
+import { readFile, writeFile, mkdir, readdir, access } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
+let templatesRootCache = null;
+export async function resolveTemplatesRoot() {
+    if (templatesRootCache)
+        return templatesRootCache;
+    // Dev (monorepo): packages/cli/src/core/scaffolder.ts → packages/cli/templates/
+    const thisDir = dirname(fileURLToPath(import.meta.url));
+    const devPath = resolve(thisDir, "../../templates");
+    try {
+        await access(devPath);
+        templatesRootCache = devPath;
+        return devPath;
+    }
+    catch {
+        // fall through
+    }
+    // Production: @captain_z/zsk/templates (bundled)
+    const require = createRequire(import.meta.url);
+    const pkgPath = require.resolve("@captain_z/zsk/package.json");
+    const templates = resolve(dirname(pkgPath), "templates");
+    templatesRootCache = templates;
+    return templates;
+}
+/**
+ * Recursively copy a template subtree into target dir.
+ * By default skips files that already exist (non-destructive).
+ */
+export async function scaffoldTemplate(templateSubpath, target, opts = {}) {
+    const root = await resolveTemplatesRoot();
+    const src = join(root, templateSubpath);
+    const result = { written: [], skipped: [] };
+    await mkdir(target, { recursive: true });
+    await copyRecursive(src, target, opts.overwrite === true, result);
+    return result;
+}
+async function copyRecursive(src, dst, overwrite, result) {
+    const entries = await readdir(src, { withFileTypes: true });
+    await mkdir(dst, { recursive: true });
+    for (const e of entries) {
+        const srcPath = join(src, e.name);
+        const dstPath = join(dst, e.name);
+        if (e.isDirectory()) {
+            await copyRecursive(srcPath, dstPath, overwrite, result);
+        }
+        else {
+            if (!overwrite && (await fileExists(dstPath))) {
+                result.skipped.push(dstPath);
+                continue;
+            }
+            const content = await readFile(srcPath, "utf8");
+            await writeFile(dstPath, content, "utf8");
+            result.written.push(dstPath);
+        }
+    }
+}
+async function fileExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export { fileExists };
+//# sourceMappingURL=scaffolder.js.map

package/dist/core/scaffolder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffolder.js","sourceRoot":"","sources":["../../src/core/scaffolder.ts"],"names":[],"mappings":"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"}

package/dist/core/skills.d.ts

@@ -0,0 +1,17 @@
+declare const DOMAINS: readonly ["sdlc", "frontend", "quality", "design-handoff", "system", "meta"];
+export type Domain = (typeof DOMAINS)[number];
+export type Skill = {
+    name: string;
+    domain: Domain;
+    slug: string;
+    file: string;
+};
+export declare function resolveSkillsRoot(): Promise<string>;
+export declare function loadSkill(skillName: string): Promise<Skill>;
+/**
+ * Enumerate every installable skill by walking the skills root directly.
+ * Returns names in `zsk:<slug>` form, sorted by domain then slug, so UI
+ * groupings are stable across runs.
+ */
+export declare function enumerateSkills(): Promise<Skill[]>;
+export { DOMAINS };

package/dist/core/skills.js

@@ -0,0 +1,89 @@
+// Skill resolution: zsk:<slug> → filesystem SKILL.md path + domain metadata.
+//
+// Dev (monorepo): resolves via ../../../../capabilities/skills/
+// Production:      resolves via @captain_z/zsk-skills/skills/
+import { access, readdir } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
+const DOMAINS = [
+    "sdlc",
+    "frontend",
+    "quality",
+    "design-handoff",
+    "system",
+    "meta",
+];
+let skillsRootCache = null;
+export async function resolveSkillsRoot() {
+    if (skillsRootCache)
+        return skillsRootCache;
+    const thisDir = dirname(fileURLToPath(import.meta.url));
+    // Dev: packages/cli/src/core/skills.ts → capabilities/skills/
+    const devPath = resolve(thisDir, "../../../../capabilities/skills");
+    try {
+        await access(devPath);
+        skillsRootCache = devPath;
+        return devPath;
+    }
+    catch {
+        // fall through
+    }
+    // Production: @captain_z/zsk-skills package (flat layout, no /skills/ wrapper)
+    const require = createRequire(import.meta.url);
+    const pkgPath = require.resolve("@captain_z/zsk-skills/package.json");
+    const skillsDir = dirname(pkgPath);
+    skillsRootCache = skillsDir;
+    return skillsDir;
+}
+export async function loadSkill(skillName) {
+    const slug = skillName.replace(/^zsk:/, "");
+    const root = await resolveSkillsRoot();
+    for (const domain of DOMAINS) {
+        const file = resolve(root, domain, slug, "SKILL.md");
+        try {
+            await access(file);
+            return { name: skillName, domain, slug, file };
+        }
+        catch {
+            // try next domain
+        }
+    }
+    throw new Error(`Skill not found in any domain: ${skillName}`);
+}
+/**
+ * Enumerate every installable skill by walking the skills root directly.
+ * Returns names in `zsk:<slug>` form, sorted by domain then slug, so UI
+ * groupings are stable across runs.
+ */
+export async function enumerateSkills() {
+    const root = await resolveSkillsRoot();
+    const out = [];
+    for (const domain of DOMAINS) {
+        const domainDir = resolve(root, domain);
+        let entries;
+        try {
+            entries = await readdir(domainDir, { withFileTypes: true });
+        }
+        catch {
+            continue; // domain dir may not exist in partial installs
+        }
+        for (const e of entries) {
+            if (!e.isDirectory())
+                continue;
+            const file = resolve(domainDir, e.name, "SKILL.md");
+            try {
+                await access(file);
+            }
+            catch {
+                continue; // directory without SKILL.md → not a skill
+            }
+            out.push({ name: `zsk:${e.name}`, domain, slug: e.name, file });
+        }
+    }
+    out.sort((a, b) => DOMAINS.indexOf(a.domain) - DOMAINS.indexOf(b.domain) ||
+        a.slug.localeCompare(b.slug));
+    return out;
+}
+export { DOMAINS };
+//# sourceMappingURL=skills.js.map

package/dist/core/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/core/skills.ts"],"names":[],"mappings":"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"}

package/dist/core/targets.d.ts

@@ -0,0 +1,9 @@
+export type TargetKind = "claude-global" | "claude-project" | "claude-plugin" | "codex-global" | "codex-project" | "custom";
+export type TargetOption = {
+    kind: TargetKind;
+    label: string;
+    hint: string;
+    resolve: () => string;
+};
+export declare const TARGET_OPTIONS: TargetOption[];
+export declare function resolvePath(input: string): string;

package/dist/core/targets.js

@@ -0,0 +1,50 @@
+// Install target resolution.
+// Each TargetKind resolves to a concrete filesystem path.
+import { homedir } from "node:os";
+import { resolve, isAbsolute } from "node:path";
+export const TARGET_OPTIONS = [
+    {
+        kind: "claude-global",
+        label: "~/.claude/skills/",
+        hint: "Claude 全局",
+        resolve: () => resolve(homedir(), ".claude/skills"),
+    },
+    {
+        kind: "claude-project",
+        label: "./.claude/skills/",
+        hint: "Claude 项目（当前目录）",
+        resolve: () => resolve(process.cwd(), ".claude/skills"),
+    },
+    {
+        kind: "claude-plugin",
+        label: "./.claude-plugin/",
+        hint: "Claude 插件形态（生成 manifest.json）",
+        resolve: () => resolve(process.cwd(), ".claude-plugin"),
+    },
+    {
+        kind: "codex-global",
+        label: "~/.codex/skills/",
+        hint: "Codex 全局",
+        resolve: () => resolve(homedir(), ".codex/skills"),
+    },
+    {
+        kind: "codex-project",
+        label: "./.codex/skills/",
+        hint: "Codex 项目",
+        resolve: () => resolve(process.cwd(), ".codex/skills"),
+    },
+    {
+        kind: "custom",
+        label: "自定义路径",
+        hint: "手动输入绝对或相对路径",
+        resolve: () => "",
+    },
+];
+export function resolvePath(input) {
+    const trimmed = input.trim();
+    if (trimmed.startsWith("~/")) {
+        return resolve(homedir(), trimmed.slice(2));
+    }
+    return isAbsolute(trimmed) ? trimmed : resolve(process.cwd(), trimmed);
+}
+//# sourceMappingURL=targets.js.map

package/dist/core/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../src/core/targets.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,0DAA0D;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAiBhD,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC;KACpD;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC;KACxD;IACD;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC;KACxD;IACD;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC;KACnD;IACD;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,kBAAkB;QACzB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC;KACvD;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;KAClB;CACF,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC"}

package/dist/ui/prompts.d.ts

@@ -0,0 +1,10 @@
+import { intro as clackIntro, outro as clackOutro, spinner as clackSpinner, note as clackNote, log, type Option } from "@clack/prompts";
+type Primitive = Readonly<string | boolean | number>;
+export declare function select<T extends Primitive>(message: string, options: Option<T>[], initialValue?: T): Promise<T>;
+export declare function groupMultiselect<T extends Primitive>(message: string, options: Record<string, Option<T>[]>, initialValues?: T[]): Promise<T[]>;
+export declare function text(message: string, opts?: {
+    placeholder?: string;
+    validate?: (v: string) => string | undefined;
+}): Promise<string>;
+export declare function confirm(message: string, initialValue?: boolean): Promise<boolean>;
+export { clackIntro as intro, clackOutro as outro, clackSpinner as spinner, clackNote as note, log, };

package/dist/ui/prompts.js

@@ -0,0 +1,40 @@
+// @clack/prompts wrappers with centralized isCancel handling.
+// All CLI interactive prompts go through this module so Ctrl+C is handled once.
+import { intro as clackIntro, outro as clackOutro, select as clackSelect, groupMultiselect as clackGroupMultiselect, confirm as clackConfirm, text as clackText, spinner as clackSpinner, note as clackNote, log, cancel, isCancel, } from "@clack/prompts";
+function exitIfCancel(value) {
+    if (isCancel(value)) {
+        cancel("已取消");
+        process.exit(0);
+    }
+}
+export async function select(message, options, initialValue) {
+    const v = await clackSelect({ message, options, initialValue });
+    exitIfCancel(v);
+    return v;
+}
+export async function groupMultiselect(message, options, initialValues = []) {
+    const v = await clackGroupMultiselect({
+        message,
+        options,
+        initialValues,
+        required: false,
+    });
+    exitIfCancel(v);
+    return v;
+}
+export async function text(message, opts = {}) {
+    const v = await clackText({
+        message,
+        placeholder: opts.placeholder,
+        validate: opts.validate,
+    });
+    exitIfCancel(v);
+    return v;
+}
+export async function confirm(message, initialValue = true) {
+    const v = await clackConfirm({ message, initialValue });
+    exitIfCancel(v);
+    return v;
+}
+export { clackIntro as intro, clackOutro as outro, clackSpinner as spinner, clackNote as note, log, };
+//# sourceMappingURL=prompts.js.map

package/dist/ui/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/ui/prompts.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,gFAAgF;AAEhF,OAAO,EACL,KAAK,IAAI,UAAU,EACnB,KAAK,IAAI,UAAU,EACnB,MAAM,IAAI,WAAW,EACrB,gBAAgB,IAAI,qBAAqB,EACzC,OAAO,IAAI,YAAY,EACvB,IAAI,IAAI,SAAS,EACjB,OAAO,IAAI,YAAY,EACvB,IAAI,IAAI,SAAS,EACjB,GAAG,EACH,MAAM,EACN,QAAQ,GAET,MAAM,gBAAgB,CAAC;AAIxB,SAAS,YAAY,CAAI,KAAiB;IACxC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,CAAC,KAAK,CAAC,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAe,EACf,OAAoB,EACpB,YAAgB;IAEhB,MAAM,CAAC,GAAG,MAAM,WAAW,CAAI,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IACnE,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,OAAoC,EACpC,gBAAqB,EAAE;IAEvB,MAAM,CAAC,GAAG,MAAM,qBAAqB,CAAI;QACvC,OAAO;QACP,OAAO;QACP,aAAa;QACb,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,OAAe,EACf,OAGI,EAAE;IAEN,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC;QACxB,OAAO;QACP,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;IACH,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAe,EACf,YAAY,GAAG,IAAI;IAEnB,MAAM,CAAC,GAAG,MAAM,YAAY,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IACxD,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,OAAO,EACL,UAAU,IAAI,KAAK,EACnB,UAAU,IAAI,KAAK,EACnB,YAAY,IAAI,OAAO,EACvB,SAAS,IAAI,IAAI,EACjB,GAAG,GACJ,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@captain_z/zsk",
+  "version": "0.1.0",
+  "description": "ZNorth Standard Kit — CLI installer for zsk skill bundles (npx @captain_z/zsk add)",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "zsk": "./dist/bin.js"
+  },
+  "main": "./dist/bin.js",
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^0.9.0",
+    "commander": "^12.1.0",
+    "picocolors": "^1.1.1",
+    "yaml": "^2.7.0",
+    "@captain_z/zsk-skills": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p .",
+    "dev": "tsx src/bin.ts",
+    "typecheck": "tsc -p . --noEmit"
+  }
+}

package/templates/project-init/.raws/FIGMA-INDEX.md

@@ -0,0 +1,38 @@
+---
+title: Figma Index
+project: <fill-me>
+last_updated: <YYYY-MM-DD>
+---
+
+# Figma Index — <项目名>
+
+> **角色**：模块 → Figma URL / node-id 的权威索引。zsk skill 通过 `{{config.paths.figma_index}}` 引用。
+> **配合 skill**：`zsk:ue-mcp`（结构化快照）、`zsk:figma-to-code`（7 步工作流）。
+> **更新时机**：模块首次接入 Figma 设计时登记；设计大改时追加新 snapshot 行。
+
+## 1. 模块索引
+
+| 模块 ID | Figma URL | Node ID | 页面 / Frame | 最后确认 | 快照路径 |
+| --- | --- | --- | --- | --- | --- |
+| <module-a> | https://www.figma.com/file/... | <int:int> | <Page / Frame> | <YYYY-MM-DD> | `.raws/design-assets/module-a/<snapshot>/` |
+
+## 2. 工作流
+
+1. 模块接入 Figma 时：登记本表一行
+2. 走 `zsk:ue-mcp` skill：
+   - 创建 `.raws/design-assets/{module}/{YYYY-MM-DD}-{描述}/` 目录
+   - 落盘 `description.md`（结构化 YAML frontmatter + 人读章节）
+   - 落盘 `screenshot-*.png`（每状态一张）
+   - 可选：`raw/mcp-response.json`（`.gitignore`）
+3. 走 `zsk:figma-to-code`：按 7 步从快照产出生产级代码
+
+## 3. 变更纪律
+
+- **新 snapshot**：设计大改 → 新目录，**不覆盖历史**（历史用于回溯）
+- **本表改写**：指向新 snapshot 目录，旧行转入"归档"小节（保留追溯）
+- **node-id 废弃**：Figma 重绘导致 node-id 失效 → 旧行标 `[deprecated]`，新 node-id 新行
+
+## 归档（历史 snapshot）
+
+| 模块 ID | 旧 snapshot | 归档原因 | 归档日期 |
+| --- | --- | --- | --- |

package/templates/project-init/.raws/README.md

@@ -0,0 +1,37 @@
+# .raws/ — 项目原始事实源
+
+本目录是项目的**原始事实源层**，存放由人类或外部系统维护、不由 LLM 自由改写的原始文档。
+
+## 推荐内容
+
+| 文件 / 子目录 | 用途 | zsk skill 引用 |
+| --- | --- | --- |
+| `SRS.md` | 原始需求文档（Software Requirements Spec） | `{{config.paths.srs}}` |
+| `FIGMA-INDEX.md` | 模块 → Figma URL / node-id 索引 | `{{config.paths.figma_index}}` |
+| `api-contracts/` | 后端 API 契约（OpenAPI / GraphQL schema） | `{{config.paths.api_contracts}}` |
+| `design-assets/{module}/{snapshot}/` | Figma 快照（由 `zsk:ue-mcp` 产出） | `{{config.paths.design_assets}}` |
+
+## 消费路径
+
+skill 通过 `project-config.md` frontmatter 的 `paths.*` 键找到本目录文件：
+
+```
+project-config.md:
+  paths:
+    srs: .raws/SRS.md
+    figma_index: .raws/FIGMA-INDEX.md
+    api_contracts: .raws/api-contracts
+    design_assets: .raws/design-assets
+```
+
+## Git 状态建议
+
+- `SRS.md` / `FIGMA-INDEX.md`：**入库**（团队共享）
+- `design-assets/{module}/{snapshot}/raw/`：可选 `.gitignore`（体积大或含敏感信息）
+- 含敏感数据的文件：在本目录加 `.gitignore` 排除
+
+## 原则
+
+- **源文件不被 LLM 随意改写**：变更走人工/流程
+- **变更即新 snapshot**：Figma 更新→新 snapshot 目录，不覆盖历史
+- **编号锚稳定**：SRS 中的 `FR-001` / `US-001` / `AC-001` 一旦发布不改（仅废弃，合并/拆分留追踪）

package/templates/project-init/.raws/SRS.md

@@ -0,0 +1,73 @@
+---
+title: Software Requirements Specification
+project: <fill-me>
+status: draft
+version: 0.1.0
+last_updated: <YYYY-MM-DD>
+---
+
+# SRS — <项目名>
+
+> **角色**：原始需求事实源。zsk skill 通过 `{{config.paths.srs}}` 引用本文件。
+> **变更流程**：走人工评审（见 `zsk:proposal` → `zsk:spec`），不由 LLM 自由改写。
+> **编号纪律**：FR / NFR / AC 只增不改，废弃用 `[deprecated]` 标记。
+
+## 1. 范围与目标
+
+### 1.1 背景
+<为什么要做此产品/模块>
+
+### 1.2 SMART 目标
+<用 zsk:proposal skill 的 G-{n} 格式>
+
+### 1.3 超出范围（Out of Scope）
+<显式列出不做什么，避免范围蔓延>
+
+## 2. 用户角色与核心场景
+
+| 角色 | 核心场景 | 优先级 |
+| --- | --- | --- |
+| <角色 A> | <场景描述> | P0 |
+
+## 3. 功能需求（FR）
+
+> 编号规则见 `zsk:spec`。每条 FR 必须可被下游 Design / Task / Verify 用编号引用。
+
+- **FR-001**: <描述：做什么，不写怎么做>
+- **FR-002**: <...>
+
+## 4. 非功能需求（NFR）
+
+> 7 大类：performance / a11y / security / i18n / compat / observability / reliability
+> 项目级基线见 `project-config.md` 的 `quality.*`；模块级偏离单独声明。
+
+- **NFR-001**: <描述 + 阈值 + 验证手法>
+
+## 5. 验收条件（AC）
+
+> Gherkin（Given/When/Then）或 BDD 可执行化。每条 AC 覆盖至少 1 个 FR。
+
+- **AC-001**: Given <前置>, When <操作>, Then <期望结果> · 覆盖 `FR-001`
+
+## 6. 用户故事（US）
+
+> INVEST 原则。每个 US 关联若干 FR/AC。
+
+- **US-001**: 作为 <角色>，我想 <目标>，以便 <价值> · 覆盖 `FR-001` / `AC-001`
+
+## 7. 约束（Constraints）
+
+<业务/合规/技术约束。技术约束尽量走 `project-config.md` 与 ADR，不在此重抄>
+
+## 8. 术语表（Glossary）
+
+> 可独立维护于 `docs/system/glossary.md`（zsk:glossary skill）。
+
+| 术语 | 定义 |
+| --- | --- |
+| <Term A> | <定义> |
+
+## 9. 开放问题
+
+- [ ] <待澄清问题 1>
+- [ ] <待澄清问题 2>