flowbook 0.1.1 → 0.1.3

package/README.zh-CN.md

@@ -12,9 +12,6 @@
 ## 快速开始
 
 ```bash
-# 安装
-npm install -D flowbook
-
 # 初始化 — 添加脚本 + 示例文件
 npx flowbook@latest init
 
@@ -92,6 +89,72 @@ Flowbook 默认扫描以下模式：
 
 忽略 `node_modules/`、`.git/` 和 `dist/`。
 
+## AI Agent Skill
+
+`flowbook init` 自动将 AI 代理技能安装到所有支持的编码代理目录中。
+当编码代理（Claude Code、OpenAI Codex、VS Code Copilot、Cursor、Gemini CLI 等）检测到你的提示中有 **"flowbook"** 关键字时，它会：
+
+1. 分析你的代码库中的逻辑流（API 路由、认证、状态管理、业务逻辑等）
+2. 如果尚未初始化，设置 Flowbook
+3. 为每个重要流程生成包含 Mermaid 图表的 `.flow.md` 文件
+4. 验证构建
+
+### 手动技能安装
+
+如果你没有使用 `flowbook init`，请手动复制技能：
+
+```bash
+# Claude Code
+mkdir -p .claude/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .claude/skills/flowbook/
+
+# OpenAI Codex
+mkdir -p .agents/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agents/skills/flowbook/
+
+# VS Code / GitHub Copilot
+mkdir -p .github/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .github/skills/flowbook/
+
+# Google Antigravity
+mkdir -p .agent/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .agent/skills/flowbook/
+
+# Gemini CLI
+mkdir -p .gemini/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .gemini/skills/flowbook/
+
+# Cursor
+mkdir -p .cursor/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .cursor/skills/flowbook/
+
+# Windsurf (Codeium)
+mkdir -p .windsurf/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .windsurf/skills/flowbook/
+
+# AmpCode
+mkdir -p .amp/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .amp/skills/flowbook/
+
+# OpenCode / oh-my-opencode
+mkdir -p .opencode/skills/flowbook
+cp node_modules/flowbook/src/skills/flowbook/SKILL.md .opencode/skills/flowbook/
+```
+
+### 兼容代理
+
+| 代理 | 技能位置 |
+|-------|---------------|
+| Claude Code | `.claude/skills/flowbook/SKILL.md` |
+| OpenAI Codex | `.agents/skills/flowbook/SKILL.md` |
+| VS Code / GitHub Copilot | `.github/skills/flowbook/SKILL.md` |
+| Google Antigravity | `.agent/skills/flowbook/SKILL.md` |
+| Gemini CLI | `.gemini/skills/flowbook/SKILL.md` |
+| Cursor | `.cursor/skills/flowbook/SKILL.md` |
+| Windsurf (Codeium) | `.windsurf/skills/flowbook/SKILL.md` |
+| AmpCode | `.amp/skills/flowbook/SKILL.md` |
+| OpenCode / oh-my-opencode | `.opencode/skills/flowbook/SKILL.md` |
+
 ## 工作原理
 
 ```

package/dist/cli.js

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
 
 // src/node/init.ts
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
-import { resolve } from "path";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync } from "fs";
+import { resolve, dirname } from "path";
 import { execSync } from "child_process";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
 var EXAMPLE_FLOW = `---
 title: Example Flow
 category: Getting Started
@@ -64,6 +66,51 @@ async function initFlowbook() {
   } else {
     console.log("  \u2713 Example flow already exists");
   }
+  const gitignorePath = resolve(cwd, ".gitignore");
+  if (existsSync(gitignorePath)) {
+    const gitignore = readFileSync(gitignorePath, "utf-8");
+    if (!gitignore.includes("flowbook-static")) {
+      writeFileSync(gitignorePath, gitignore.trimEnd() + "\nflowbook-static\n");
+      console.log("  \u2713 Added flowbook-static to .gitignore");
+    }
+  }
+  const skillSrc = resolve(__dirname, "..", "src", "skills", "flowbook", "SKILL.md");
+  const skillDirs = [
+    resolve(cwd, ".claude", "skills", "flowbook"),
+    // Claude Code
+    resolve(cwd, ".agents", "skills", "flowbook"),
+    // OpenAI Codex / cross-tool alias
+    resolve(cwd, ".github", "skills", "flowbook"),
+    // VS Code / GitHub Copilot
+    resolve(cwd, ".agent", "skills", "flowbook"),
+    // Google Antigravity
+    resolve(cwd, ".gemini", "skills", "flowbook"),
+    // Gemini CLI
+    resolve(cwd, ".cursor", "skills", "flowbook"),
+    // Cursor
+    resolve(cwd, ".windsurf", "skills", "flowbook"),
+    // Windsurf (Codeium)
+    resolve(cwd, ".amp", "skills", "flowbook"),
+    // AmpCode
+    resolve(cwd, ".opencode", "skills", "flowbook")
+    // OpenCode / oh-my-opencode
+  ];
+  if (existsSync(skillSrc)) {
+    let installed = 0;
+    for (const dir of skillDirs) {
+      const dest = resolve(dir, "SKILL.md");
+      if (!existsSync(dest)) {
+        mkdirSync(dir, { recursive: true });
+        copyFileSync(skillSrc, dest);
+        installed++;
+      }
+    }
+    if (installed > 0) {
+      console.log(`  \u2713 Installed AI agent skill to ${installed} agent directories`);
+    } else {
+      console.log("  \u2713 AI agent skills already installed");
+    }
+  }
   const run = pm === "yarn" ? "yarn" : `${pm} run`;
   console.log("");
   console.log("  Next steps:");
@@ -181,11 +228,11 @@ function flowbookPlugin(options = {}) {
 }
 
 // src/node/server.ts
-import { resolve as resolve2, dirname } from "path";
-import { fileURLToPath } from "url";
-var __dirname = dirname(fileURLToPath(import.meta.url));
+import { resolve as resolve2, dirname as dirname2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
 function getClientDir() {
-  return resolve2(__dirname, "..", "src", "client");
+  return resolve2(__dirname2, "..", "src", "client");
 }
 function createConfig(options) {
   const cwd = options.cwd ?? process.cwd();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowbook",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "bin": {
     "flowbook": "./dist/cli.js"
@@ -12,7 +12,9 @@
   "scripts": {
     "dev": "vite",
     "build": "tsup",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "flowbook": "flowbook dev",
+    "build-flowbook": "flowbook build"
   },
   "dependencies": {
     "@tailwindcss/vite": "^4.0.0",
@@ -29,6 +31,7 @@
     "@types/node": "^25.3.3",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "flowbook": "^0.1.2",
     "tsup": "^8.0.0",
     "typescript": "^5.7.0"
   }

package/src/node/init.ts

@@ -1,6 +1,9 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
-import { resolve } from "node:path";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
 import { execSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
 
 const EXAMPLE_FLOW = `---
 title: Example Flow
@@ -75,6 +78,47 @@ export async function initFlowbook() {
     console.log("  ✓ Example flow already exists");
   }
 
+  // 4. Add flowbook-static to .gitignore
+  const gitignorePath = resolve(cwd, ".gitignore");
+  if (existsSync(gitignorePath)) {
+    const gitignore = readFileSync(gitignorePath, "utf-8");
+    if (!gitignore.includes("flowbook-static")) {
+      writeFileSync(gitignorePath, gitignore.trimEnd() + "\nflowbook-static\n");
+      console.log("  ✓ Added flowbook-static to .gitignore");
+    }
+  }
+
+  // 5. Install AI agent skill to all supported agent directories
+  const skillSrc = resolve(__dirname, "..", "src", "skills", "flowbook", "SKILL.md");
+  const skillDirs = [
+    resolve(cwd, ".claude", "skills", "flowbook"),     // Claude Code
+    resolve(cwd, ".agents", "skills", "flowbook"),     // OpenAI Codex / cross-tool alias
+    resolve(cwd, ".github", "skills", "flowbook"),     // VS Code / GitHub Copilot
+    resolve(cwd, ".agent", "skills", "flowbook"),      // Google Antigravity
+    resolve(cwd, ".gemini", "skills", "flowbook"),     // Gemini CLI
+    resolve(cwd, ".cursor", "skills", "flowbook"),     // Cursor
+    resolve(cwd, ".windsurf", "skills", "flowbook"),   // Windsurf (Codeium)
+    resolve(cwd, ".amp", "skills", "flowbook"),        // AmpCode
+    resolve(cwd, ".opencode", "skills", "flowbook"),   // OpenCode / oh-my-opencode
+  ];
+
+  if (existsSync(skillSrc)) {
+    let installed = 0;
+    for (const dir of skillDirs) {
+      const dest = resolve(dir, "SKILL.md");
+      if (!existsSync(dest)) {
+        mkdirSync(dir, { recursive: true });
+        copyFileSync(skillSrc, dest);
+        installed++;
+      }
+    }
+    if (installed > 0) {
+      console.log(`  \u2713 Installed AI agent skill to ${installed} agent directories`);
+    } else {
+      console.log("  \u2713 AI agent skills already installed");
+    }
+  }
+
   const run = pm === "yarn" ? "yarn" : `${pm} run`;
   console.log("");
   console.log("  Next steps:");