@done-coding/cli-skills 0.1.0

package/README.md

@@ -0,0 +1,11 @@
+# @done-coding/cli-skills
+
+```
+done-coding CLI 各命令的 Agent Skills 聚合包与安装器
+```
+
+## 使用
+
+```bash
+npm install @done-coding/cli-skills
+```

package/es/cli.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { a } from "./main-BjgtGCEn.js";
+a();

package/es/index.mjs

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { S as e, c as m, h as o } from "./main-BjgtGCEn.js";
+export {
+  e as SubcommandEnum,
+  m as createAsSubcommand,
+  o as handler
+};

package/es/main-BjgtGCEn.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+import { homedir as $ } from "node:os";
+import { join as l } from "node:path";
+import { outputConsole as a, safeCwd as y, xPrompts as w, getRootScriptName as b, createSubcommand as f, createMainCommand as C } from "@done-coding/cli-utils";
+import { existsSync as m, readdirSync as L, readFileSync as I, mkdirSync as N, cpSync as v } from "node:fs";
+import { fileURLToPath as A } from "node:url";
+var d = /* @__PURE__ */ ((t) => (t.INSTALL = "install", t))(d || {});
+const u = {
+  name: "@done-coding/cli-skills",
+  version: "0.1.0",
+  description: "done-coding CLI 各命令的 Agent Skills 聚合包与安装器",
+  bin: {
+    "dc-cli-skills": "es/cli.mjs"
+  },
+  cliConfig: {
+    namespaceDir: ".${organization}",
+    moduleName: "${name}"
+  }
+}, D = () => A(new URL("../skills", import.meta.url)), x = (t) => {
+  const e = t.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (!e) return {};
+  const s = e[1], i = (r) => {
+    var o;
+    const n = s.match(new RegExp(`^${r}\\s*:\\s*(.+)$`, "m"));
+    return (o = n == null ? void 0 : n[1]) == null ? void 0 : o.trim().replace(/^["']|["']$/g, "");
+  };
+  return { name: i("name"), description: i("description") };
+}, T = (t) => m(t) ? L(t, { withFileTypes: !0 }).filter((e) => e.isDirectory()).map((e) => {
+  const s = l(t, e.name), i = l(s, "SKILL.md");
+  if (!m(i)) return;
+  const r = x(I(i, "utf-8"));
+  return {
+    name: e.name,
+    description: r.description ?? "",
+    sourceDir: s
+  };
+}).filter((e) => e !== void 0) : [], j = (t, e, { force: s = !1 } = {}) => (N(e, { recursive: !0 }), t.map((i) => {
+  const r = l(e, i.name), n = m(r);
+  return n && !s ? { name: i.name, targetDir: r, status: "skipped" } : (v(i.sourceDir, r, { recursive: !0, force: !0 }), {
+    name: i.name,
+    targetDir: r,
+    status: n ? "overwritten" : "installed"
+  });
+})), F = () => ({
+  global: {
+    type: "boolean",
+    alias: "g",
+    describe: "安装到全局 ~/.claude/skills（默认安装到项目 ./.claude/skills）",
+    default: !1
+  },
+  all: {
+    type: "boolean",
+    alias: "a",
+    describe: "安装全部内置 skill，跳过交互选择",
+    default: !1
+  },
+  skill: {
+    type: "array",
+    alias: "s",
+    describe: "指定要安装的 skill 名称（可多个），跳过交互选择"
+  },
+  force: {
+    type: "boolean",
+    alias: "f",
+    describe: "覆盖已存在的同名 skill",
+    default: !1
+  }
+}), R = async (t, e) => {
+  if (t.all)
+    return e;
+  const s = (t.skill ?? []).map(String);
+  if (s.length > 0) {
+    const n = s.filter(
+      (o) => !e.some((c) => c.name === o)
+    );
+    return n.length > 0 && a.warn(`未找到 skill: ${n.join(", ")}`), e.filter((o) => s.includes(o.name));
+  }
+  const { picked: i } = await w({
+    type: "multiselect",
+    name: "picked",
+    message: "选择要安装的 skill（空格勾选，回车确认）",
+    choices: e.map((n) => ({
+      title: n.name,
+      value: n.name,
+      description: n.description
+    })),
+    min: 1
+  }), r = i ?? [];
+  return e.filter((n) => r.includes(n.name));
+}, k = async (t) => {
+  const e = D(), s = T(e);
+  if (s.length === 0) {
+    a.warn(`未发现任何内置 skill（目录: ${e}）`);
+    return;
+  }
+  const i = await R(t, s);
+  if (i.length === 0) {
+    a.warn("未选择任何 skill，已退出");
+    return;
+  }
+  const r = t.global ? l($(), ".claude", "skills") : l(y(), ".claude", "skills"), n = j(i, r, {
+    force: t.force
+  });
+  for (const c of n) {
+    const h = c.status === "skipped" ? "跳过(已存在，--force 覆盖)" : c.status === "overwritten" ? "覆盖" : "安装";
+    a.info(`[${h}] ${c.name} → ${c.targetDir}`);
+  }
+  const o = n.filter(
+    (c) => c.status !== "skipped"
+  ).length;
+  a.success(
+    `完成：${o}/${n.length} 个 skill 已写入 ${r}`
+  );
+}, U = {
+  command: d.INSTALL,
+  describe: "把内置的 done-coding CLI skill(s) 安装到 .claude/skills",
+  options: F(),
+  handler: k
+}, O = async (t, e) => {
+  switch (t) {
+    case d.INSTALL:
+      return k(e);
+    default:
+      throw new Error(`不支持的命令 ${t}`);
+  }
+}, { version: E, description: P } = u, g = {
+  describe: P,
+  version: E,
+  subcommands: [U].map(f),
+  demandCommandCount: 1,
+  rootScriptName: b({ packageJson: u })
+}, {
+  cliConfig: { moduleName: p }
+} = u, S = (t = !1) => {
+  const e = t ? p : void 0, s = `$0${t ? ` ${p}` : ""} <command> [options]`;
+  return { command: e, usage: s };
+}, q = async () => C({
+  ...g,
+  ...S()
+}), G = () => f({
+  ...g,
+  ...S(!0)
+});
+export {
+  d as S,
+  q as a,
+  G as c,
+  O as h
+};

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@done-coding/cli-skills",
+  "version": "0.1.0",
+  "description": "done-coding CLI 各命令的 Agent Skills 聚合包与安装器",
+  "private": false,
+  "module": "es/index.mjs",
+  "types": "types/index.d.ts",
+  "type": "module",
+  "bin": {
+    "dc-cli-skills": "es/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "import": "./es/index.mjs",
+      "types": "./types/index.d.ts"
+    }
+  },
+  "files": [
+    "es",
+    "lib",
+    "types",
+    "skills"
+  ],
+  "scripts": {
+    "predev": "dc-inject",
+    "dev": "vite build -w -m hotBuild",
+    "prebuild": "dc-inject",
+    "build": "vite build",
+    "prepack": "pnpm build",
+    "test": "vitest",
+    "coverage": "vitest run --coverage"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git@gitee.com:done-coding/done-coding-cli.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "author": "JustSoSu",
+  "license": "MIT",
+  "sideEffects": false,
+  "devDependencies": {
+    "@done-coding/cli-inject": "^0.5.17",
+    "@types/node": "^18.0.0",
+    "@types/prompts": "^2.4.6",
+    "@types/yargs": "^17.0.28",
+    "@vitest/coverage-v8": "^1.6.1",
+    "typescript": "^5.8.3",
+    "vite": "^5.0.10",
+    "vite-plugin-dts": "^3.7.0",
+    "vitest": "^1.6.1"
+  },
+  "dependencies": {
+    "@done-coding/cli-utils": "0.11.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "gitHead": "d5d89297f6cf953893f2d9ceb591c96ce0114656"
+}

package/skills/create-done-coding/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: create-done-coding
+description: Use when scaffolding / creating / initializing a new done-coding project from a template（创建、初始化、新建 done-coding 项目；用 done-coding 模板生成工程）. Drives the create-done-coding CLI non-interactively via npx — no resident MCP needed.
+---
+
+# 创建 done-coding 项目（create-done-coding）
+
+用 `create-done-coding` CLI 从模板**非交互**地生成 done-coding 项目。全程经 `npx ...@latest` 现取现用，无需预装 CLI、无需常驻 MCP。
+
+## 何时用
+
+用户要：创建 / 初始化 / 新建一个 done-coding 项目；用某模板 scaffold 工程；从模板列表里挑一个生成。
+
+## 心智模型（两步）
+
+1. **查问题** `--list-questions`：拿到该模板要哪些答案（JSON，机读）。
+2. **带答案建** `--env`：把答案一次性传入，非交互生成项目。
+
+模板要么是一个 git 仓库（远端地址 / 本地绝对路径），要么是仓库内的某个子目录（用 `--templateDirectory`）。
+
+## 前置：确定模板来源（templateUrl）
+
+模板来源是 git 地址或本地 git 仓库**根路径**（`/` 开头）。两种拿法：
+
+ⓐ **用户已指明模板**（给了 git 地址 / 本地路径）→ 直接作为 `-p` 的值。
+ⓑ **从本地模板列表挑**：用户维护的模板列表是一个 JSON：
+
+```json
+{ "templateList": [
+  { "name": "...", "url": "<git 或本地仓库根路径>", "directory": "<仓库内子目录,可选>", "branch": "<分支,可选>" }
+] }
+```
+
+读这个文件，与用户确认选哪一个，取其 `url`（及 `directory` / `branch`）。
+
+> [MUST] 显式传 `-p <url>`（或 `--templateConfig <本地列表路径>`）。不要依赖「不传任何来源时静默回落远端默认列表」——来源要可见、可复述。
+> 子目录模板用 `--templateDirectory <子目录>`（如 monorepo 子包 `packages/xxx`），**不要**把子目录拼进 `url`；本地来源的 `url` 必须是 git 仓库根。
+
+## 步骤 1 — 查询模板需要哪些答案
+
+```bash
+npx create-done-coding@latest \
+  -p <templateUrl> \
+  [--templateDirectory <仓库内子目录>] \
+  [-b <分支>] \
+  --list-questions
+```
+
+仅向 **stdout** 打印 JSON（不创建项目，退出码 0）。形如：
+
+```json
+[
+  { "key": "organization", "required": false, "default": "done-coding" },
+  { "key": "name", "required": true },
+  { "key": "description", "required": true }
+]
+```
+
+判定规则：
+- `required: true`（且无 `default` 字段）→ **必填**，[MUST] 供答。
+- `required: false`（带 `default`）→ 选填，不供答则回落 `default`。
+
+## 步骤 2 — 收集答案后非交互创建
+
+答案拼成 JSON（key 对齐步骤 1 的 `key`，**是 key 不是中文 label**），经 `--env` 一次性供答：
+
+```bash
+npx create-done-coding@latest \
+  -n <projectName> \
+  -p <templateUrl> \
+  [--templateDirectory <仓库内子目录>] \
+  [-b <分支>] \
+  --env '{"name":"<projectName>","description":"...","organization":"done-coding"}'
+```
+
+答案多时可改用文件：`--env-file ./answers.json`（内容为 `{ key: value }`）。两者同给时 `--env` 浅覆盖 `--env-file`。
+
+## 完整示例
+
+从某 monorepo hub 的子包模板 `packages/npm-node-cli`（本地仓库根 `/abs/hub`，分支 master）创建名为 `my-tool` 的项目：
+
+```bash
+# 1. 先查问题
+npx create-done-coding@latest -p /abs/hub -b master \
+  --templateDirectory packages/npm-node-cli --list-questions
+# → [{"key":"organization","required":false,"default":"done-coding"},
+#    {"key":"organizationAbr","required":false,"default":"dc"},
+#    {"key":"name","required":true},{"key":"description","required":true},
+#    {"key":"repositoryUrl","required":false,"default":""}]
+
+# 2. 补必填(name/description)后创建
+npx create-done-coding@latest -n my-tool -p /abs/hub -b master \
+  --templateDirectory packages/npm-node-cli \
+  --env '{"name":"my-tool","description":"我的命令行工具","organization":"done-coding"}'
+# → 生成 ./my-tool/
+```
+
+## 行为约定（据实测）
+
+- **退出码可信**：缺必填 / 失败 → **退出码 1**，且在 **stderr** 列出缺哪些（如 `name(包名)、description(描述)`），不创建任何目录；成功 → 退出码 0。agent 可直接靠退出码判断成败。
+- **stdout 只出数据**：`--list-questions` 的 JSON 走 stdout，诊断/报错走 stderr——解析时只读 stdout。
+- **无 TTY 自动非交互**：CI / agent / 管道环境下不等终端输入，缺答案即快速失败，不会卡住。
+- **生成位置**：当前工作目录下的 `<projectName>/`（或 `--rootDir` 指定的根下）。
+- **git 行为**：默认会对新项目做 git 初始化；但若创建在**已有 git 仓库内**（如往 monorepo 的 `packages/` 下生成），会自动**跳过**嵌套 `git init`。
+- 创建后提示用户：`cd <projectName> && pnpm install`。
+
+## 选项速查（公开项）
+
+| 选项 | 别名 | 说明 |
+|---|---|---|
+| `--projectName` | `-n` | 项目名称（生成的目录名） |
+| `--templateUrl` | `-p` | 模板地址：git 地址或本地仓库根路径 |
+| `--templateGitBranch` | `-b` | 模板仓库分支 |
+| `--templateDirectory` | | 仓库内模板子目录 |
+| `--templateConfig` | | 本地模板列表配置文件路径 |
+| `--env` | | 预设答案 JSON 字符串 |
+| `--env-file` | | 预设答案 JSON 文件路径 |
+| `--list-questions` | | 仅打印模板预设问题清单(JSON)，不创建 |
+| `--gitCommitMessage` | `-m` | git 初始化的提交信息 |

package/types/cli.d.ts

@@ -0,0 +1 @@
+export { }

package/types/index.d.ts

@@ -0,0 +1,37 @@
+import { CliHandlerArgv } from '@done-coding/cli-utils';
+import { CommandModule } from 'yargs';
+
+/** 作为子命令创建 */
+export declare const createAsSubcommand: () => CommandModule<{}, {}>;
+
+/** 导出供外部 export使用， cli内部不会通过改方法调用各子命令方法 */
+export declare const handler: (command: SubcommandEnum, argv: CliHandlerArgv<any>) => Promise<void>;
+
+/** install 子命令选项 */
+export declare interface InstallOptions {
+    /** 安装到全局 ~/.claude/skills（默认安装到项目 ./.claude/skills） */
+    global?: boolean;
+    /** 安装全部内置 skill，跳过交互选择 */
+    all?: boolean;
+    /** 指定要安装的 skill 名称（可多个），跳过交互选择 */
+    skill?: string[];
+    /** 覆盖已存在的同名 skill */
+    force?: boolean;
+}
+
+/** 内置 skill 元信息（取自各 SKILL.md frontmatter） */
+export declare interface SkillMeta {
+    /** skill 名（= 目录名，作为安装目标目录名与唯一标识） */
+    name: string;
+    /** 一句话描述（取自 SKILL.md frontmatter description） */
+    description: string;
+    /** 该 skill 源目录绝对路径 */
+    sourceDir: string;
+}
+
+/** 子命令枚举 */
+export declare enum SubcommandEnum {
+    INSTALL = "install"
+}
+
+export { }