ai-slash-commands 2026.1.3

package/README.md

@@ -0,0 +1,71 @@
+# ai-slash-commands
+
+Один набор markdown-промптов в `./prompts/*.md`, генерация в `./dist/**` и установка в домашние папки для:
+- Claude Code
+- Cursor
+- Windsurf (через линк в текущий workspace)
+- Codex (custom prompts)
+
+## Почему так
+- Источник истины - только prompt (markdown).  
+- `id`/имя команды вычисляется из имени файла (`prompts/<name>.md`).
+- Всё сгенерированное лежит только в `dist/`.
+
+## Требования
+- Node.js 18+ (Windows / Ubuntu)
+
+## Быстрый старт
+1) Добавь промпты в `prompts/*.md`
+
+2) Сгенерируй в dist:
+```bash
+npm run gen
+```
+
+3) Установи в домашние папки:
+```bash
+npm run install
+```
+
+## NPX
+Можно установить команды из любой папки с `*.md` файлами:
+```bash
+npx ai-slash-commands ./path/to/commands
+```
+
+Опционально можно ограничить список целей:
+```bash
+npx ai-slash-commands ./path/to/commands --targets claude,cursor
+```
+
+## Windsurf: важный момент
+Официально workflows подхватываются из `.windsurf/workflows` внутри workspace.  
+Глобальная папка workflows в home в доках не описана, поэтому тут используется компромисс:
+- хранение в `~/.windsurf/workflows`
+- линк в конкретный репозиторий/папку workspace
+
+Сделать линк для текущей папки:
+```bash
+npm run link:windsurf
+```
+
+## Скрипты
+- `npm run gen` - копирует `prompts/*.md` в:
+  - `dist/claude/commands/*.md`
+  - `dist/cursor/commands/*.md`
+  - `dist/windsurf/workflows/*.md`
+  - `dist/codex/prompts/*.md`
+
+- `npm run install` - копирует из `dist/**` в:
+  - `~/.claude/commands`
+  - `~/.cursor/commands`
+  - `~/.windsurf/workflows` (хранилище, дальше линк)
+  - `${CODEX_HOME:-~/.codex}/prompts`
+
+- `npm run link:windsurf` - делает `.windsurf/workflows` -> `~/.windsurf/workflows` (symlink/junction)
+
+## Примечания по папкам (ссылки на доки)
+- Claude Code personal commands: `~/.claude/commands`
+- Cursor global commands: `~/.cursor/commands`
+- Codex custom prompts: `~/.codex/prompts` (или `$CODEX_HOME/prompts`)
+- Windsurf workflows: `.windsurf/workflows` (workspace-level)

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "ai-slash-commands",
+  "version": "2026.1.3",
+  "type": "module",
+  "bin": {
+    "ai-slash-commands": "scripts/cli.mjs"
+  },
+  "scripts": {
+    "gen": "node scripts/gen.mjs",
+    "install": "node scripts/install.mjs",
+    "link:windsurf": "node scripts/link-windsurf.mjs"
+  }
+}

package/prompts/commit.md

@@ -0,0 +1,6 @@
+Собери один аккуратный коммит по текущим изменениям.
+
+Требования:
+- Один коммит, не несколько.
+- Сообщение коммита короткое, но информативное. Angular commit message style: feat(component), fix, test, docs, refactor, style, chore.
+- Если есть тесты - запусти их.

package/scripts/cli.mjs

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+import fs from "node:fs/promises";
+import path from "node:path";
+import { generate } from "./gen.mjs";
+import { install } from "./install.mjs";
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  let targetsRaw = null;
+  let commandsDir = null;
+
+  for (let i = 0; i < args.length; i += 1) {
+    const a = args[i];
+    if (a === "--targets") {
+      targetsRaw = args[i + 1];
+      i += 1;
+      continue;
+    }
+    if (a.startsWith("-")) {
+      console.error(`Unknown option: ${a}`);
+      process.exit(1);
+    }
+    if (commandsDir) {
+      console.error("Only one commands directory is allowed.");
+      process.exit(1);
+    }
+    commandsDir = a;
+  }
+
+  if (!commandsDir) {
+    console.error("Usage: ai-slash-commands <commands-dir> [--targets claude,cursor,windsurf,codex]");
+    process.exit(1);
+  }
+
+  const targets = (targetsRaw ?? "claude,cursor,windsurf,codex")
+    .split(",")
+    .map(s => s.trim())
+    .filter(Boolean);
+
+  return { commandsDir: path.resolve(commandsDir), targets };
+}
+
+async function ensureCommandsDir(commandsDir) {
+  let stat;
+  try {
+    stat = await fs.stat(commandsDir);
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      console.error(`Commands directory not found: ${commandsDir}`);
+      process.exit(1);
+    }
+    throw err;
+  }
+
+  if (!stat.isDirectory()) {
+    console.error(`Not a directory: ${commandsDir}`);
+    process.exit(1);
+  }
+
+  const entries = await fs.readdir(commandsDir, { withFileTypes: true });
+  const hasMd = entries.some(e => e.isFile() && e.name.toLowerCase().endsWith(".md"));
+  if (!hasMd) {
+    console.error(`No .md files found in ${commandsDir}`);
+    process.exit(1);
+  }
+}
+
+async function main() {
+  const { commandsDir, targets } = parseArgs();
+  await ensureCommandsDir(commandsDir);
+  await generate({ targets, promptsDir: commandsDir });
+  await install({ targets });
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/scripts/gen.mjs

@@ -0,0 +1,84 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const repoRoot = path.resolve(__dirname, "..");
+const defaultPromptsDir = path.join(repoRoot, "prompts");
+const distDir = path.join(repoRoot, "dist");
+
+const TARGETS = {
+  claude:   { out: "claude/commands" },
+  cursor:   { out: "cursor/commands" },
+  windsurf: { out: "windsurf/workflows" },
+  codex:    { out: "codex/prompts" },
+};
+
+function parseArgs() {
+  const idxTargets = process.argv.indexOf("--targets");
+  const rawTargets = idxTargets >= 0 ? process.argv[idxTargets + 1] : "claude,cursor,windsurf,codex";
+  const targets = rawTargets.split(",").map(s => s.trim()).filter(Boolean);
+
+  const idxSrc = process.argv.indexOf("--src");
+  const rawSrc = idxSrc >= 0 ? process.argv[idxSrc + 1] : null;
+
+  return { targets, promptsDir: rawSrc ? path.resolve(rawSrc) : defaultPromptsDir };
+}
+
+async function ensureDir(p) {
+  await fs.mkdir(p, { recursive: true });
+}
+
+async function listPromptFiles(promptsDir) {
+  const entries = await fs.readdir(promptsDir, { withFileTypes: true });
+  return entries
+    .filter(e => e.isFile() && e.name.toLowerCase().endsWith(".md"))
+    .map(e => e.name);
+}
+
+export async function generate({ targets, promptsDir }) {
+  const promptFiles = await listPromptFiles(promptsDir);
+  if (promptFiles.length === 0) {
+    console.error(`No prompts found in ${promptsDir} (expected *.md).`);
+    process.exit(1);
+  }
+
+  for (const t of targets) {
+    if (!TARGETS[t]) {
+      console.error(`Unknown target: ${t}. Allowed: ${Object.keys(TARGETS).join(", ")}`);
+      process.exit(1);
+    }
+    await ensureDir(path.join(distDir, TARGETS[t].out));
+  }
+
+  for (const name of promptFiles) {
+    const srcPath = path.join(promptsDir, name);
+    const content = await fs.readFile(srcPath, "utf8");
+
+    for (const t of targets) {
+      const outPath = path.join(distDir, TARGETS[t].out, name);
+      await fs.writeFile(outPath, content.endsWith("\n") ? content : content + "\n", "utf8");
+    }
+  }
+
+  console.log("Generated:");
+  for (const t of targets) {
+    console.log(`- dist/${TARGETS[t].out}/`);
+  }
+}
+
+async function main() {
+  const { targets, promptsDir } = parseArgs();
+
+  await generate({ targets, promptsDir });
+}
+
+const isMain = process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1]);
+if (isMain) {
+  main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+  });
+}

package/scripts/install.mjs

@@ -0,0 +1,93 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const repoRoot = path.resolve(__dirname, "..");
+const distDir = path.join(repoRoot, "dist");
+
+const home = os.homedir();
+
+// Install locations (home-based)
+const DEST = {
+  claude:   path.join(home, ".claude", "commands"),
+  cursor:   path.join(home, ".cursor", "commands"),
+  // Windsurf does not (currently) document a global workflows directory.
+  // We install to ~/.windsurf/workflows and provide a separate link script
+  // to link this folder into the current workspace as .windsurf/workflows.
+  windsurf: path.join(home, ".windsurf", "workflows"),
+  // Codex supports CODEX_HOME (defaults to ~/.codex). Prompts live under $CODEX_HOME/prompts.
+  codex:    path.join(process.env.CODEX_HOME ?? path.join(home, ".codex"), "prompts"),
+};
+
+const SRC = {
+  claude:   path.join(distDir, "claude", "commands"),
+  cursor:   path.join(distDir, "cursor", "commands"),
+  windsurf: path.join(distDir, "windsurf", "workflows"),
+  codex:    path.join(distDir, "codex", "prompts"),
+};
+
+async function ensureDir(p) {
+  await fs.mkdir(p, { recursive: true });
+}
+
+async function listMd(dir) {
+  try {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    return entries
+      .filter(e => e.isFile() && e.name.toLowerCase().endsWith(".md"))
+      .map(e => e.name);
+  } catch (err) {
+    if (err.code === 'ENOENT') {
+      return [];
+    }
+    throw err;
+  }
+}
+
+async function copyAll(srcDir, dstDir) {
+  await ensureDir(dstDir);
+
+  const files = await listMd(srcDir);
+  for (const f of files) {
+    await fs.copyFile(path.join(srcDir, f), path.join(dstDir, f));
+  }
+  return files.length;
+}
+
+function parseArgs() {
+  const idx = process.argv.indexOf("--targets");
+  const raw = idx >= 0 ? process.argv[idx + 1] : "claude,cursor,windsurf,codex";
+  const targets = raw.split(",").map(s => s.trim()).filter(Boolean);
+  return { targets };
+}
+
+export async function install({ targets }) {
+  for (const t of targets) {
+    if (!SRC[t] || !DEST[t]) {
+      console.error(`Unknown target: ${t}. Allowed: ${Object.keys(SRC).join(", ")}`);
+      process.exit(1);
+    }
+  }
+
+  for (const t of targets) {
+    const count = await copyAll(SRC[t], DEST[t]);
+    console.log(`${t}: installed ${count} prompt(s) -> ${DEST[t]}`);
+  }
+}
+
+async function main() {
+  const { targets } = parseArgs();
+  await install({ targets });
+}
+
+const isMain = process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1]);
+if (isMain) {
+  main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+  });
+}

package/scripts/link-windsurf.mjs

@@ -0,0 +1,43 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+
+const home = os.homedir();
+const globalWorkflows = path.join(home, ".windsurf", "workflows");
+
+const workspaceRoot = process.cwd();
+const workspaceWindsurfDir = path.join(workspaceRoot, ".windsurf");
+const workspaceWorkflows = path.join(workspaceWindsurfDir, "workflows");
+
+async function ensureDir(p) {
+  await fs.mkdir(p, { recursive: true });
+}
+
+async function exists(p) {
+  try { await fs.lstat(p); return true; } catch { return false; }
+}
+
+async function main() {
+  await ensureDir(globalWorkflows);
+  await ensureDir(workspaceWindsurfDir);
+
+  if (await exists(workspaceWorkflows)) {
+    console.error(`Already exists: ${workspaceWorkflows}`);
+    console.error("Remove it first if you want to re-link.");
+    process.exit(1);
+  }
+
+  // On Windows, use 'junction' to avoid admin rights requirement for symlinks.
+  const type = process.platform === "win32" ? "junction" : "dir";
+  await fs.symlink(globalWorkflows, workspaceWorkflows, type);
+
+  console.log("Linked Windsurf workflows:");
+  console.log(`- global:   ${globalWorkflows}`);
+  console.log(`- workspace:${workspaceWorkflows}`);
+  console.log("Now the workspace will see workflows from your home folder.");
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});