growork 1.0.1 → 1.1.2

package/dist/index.js

@@ -19,7 +19,83 @@ function getConfigPath() {
 function configExists() {
   return fs.existsSync(getConfigPath());
 }
-function loadConfig() {
+function inferDocType(url) {
+  if (url.includes("feishu.cn") || url.includes("larksuite.com")) {
+    return "feishu";
+  }
+  if (url.includes("notion.so") || url.includes("notion.site")) {
+    return "notion";
+  }
+  if (url.includes("figma.com")) {
+    return "figma";
+  }
+  throw new Error(`\u65E0\u6CD5\u4ECE URL \u63A8\u65AD\u6587\u6863\u7C7B\u578B: ${url}`);
+}
+function sanitizeFileName(title) {
+  return title.replace(/[\/\\:*?"<>|]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+function parseDocInput(input) {
+  if (typeof input === "string") {
+    return { url: input };
+  }
+  return input;
+}
+function isTypedFeature(value) {
+  return !Array.isArray(value);
+}
+function normalizeConfig(config, options = {}) {
+  const docs = [];
+  const outputDir = config.outputDir || "docs";
+  if (config.custom && (options.custom || !options.version && !options.feature)) {
+    for (const input of config.custom) {
+      const { url, name } = parseDocInput(input);
+      docs.push({
+        url,
+        name,
+        type: inferDocType(url),
+        outputPath: `${outputDir}/custom/{title}.md`
+      });
+    }
+  }
+  if (options.custom) {
+    return docs;
+  }
+  if (config.versions) {
+    for (const [version, features] of Object.entries(config.versions)) {
+      if (options.version && options.version !== version) continue;
+      for (const [feature, value] of Object.entries(features)) {
+        if (options.feature && options.feature !== feature) continue;
+        if (isTypedFeature(value)) {
+          for (const docType of ["prd", "design", "api", "test"]) {
+            const docInputs = value[docType];
+            if (!docInputs) continue;
+            for (const input of docInputs) {
+              const { url, name } = parseDocInput(input);
+              docs.push({
+                url,
+                name,
+                type: inferDocType(url),
+                outputPath: `${outputDir}/${version}/${feature}/${docType}/{title}.md`
+              });
+            }
+          }
+        } else {
+          for (const input of value) {
+            const { url, name } = parseDocInput(input);
+            docs.push({
+              url,
+              name,
+              type: inferDocType(url),
+              outputPath: `${outputDir}/${version}/${feature}/{title}.md`
+            });
+          }
+        }
+      }
+    }
+  }
+  return docs;
+}
+function loadConfigV2() {
   const configPath = getConfigPath();
   if (!fs.existsSync(configPath)) {
     throw new Error(`\u914D\u7F6E\u6587\u4EF6\u4E0D\u5B58\u5728: ${configPath}
@@ -27,21 +103,13 @@ function loadConfig() {
   }
   const content = fs.readFileSync(configPath, "utf-8");
   const config = yaml.parse(content);
-  if (!config.docs || config.docs.length === 0) {
-    throw new Error("\u914D\u7F6E\u6587\u4EF6\u4E2D\u6CA1\u6709\u914D\u7F6E\u4EFB\u4F55\u6587\u6863");
-  }
-  const hasFeishuDocs = config.docs.some((d) => d.type === "feishu");
-  const hasNotionDocs = config.docs.some((d) => d.type === "notion");
-  if (hasFeishuDocs && (!config.feishu?.appId || !config.feishu?.appSecret)) {
-    throw new Error("\u914D\u7F6E\u6587\u4EF6\u7F3A\u5C11\u98DE\u4E66\u51ED\u8BC1 (feishu.appId, feishu.appSecret)");
-  }
-  if (hasNotionDocs && !config.notion?.token) {
-    throw new Error("\u914D\u7F6E\u6587\u4EF6\u7F3A\u5C11 Notion \u51ED\u8BC1 (notion.token)");
+  if (!config.custom && !config.versions) {
+    throw new Error("\u914D\u7F6E\u6587\u4EF6\u4E2D\u6CA1\u6709\u914D\u7F6E\u4EFB\u4F55\u6587\u6863\uFF08custom \u6216 versions\uFF09");
   }
   return config;
 }
 function getDefaultConfig() {
-  return `# Growork \u914D\u7F6E\u6587\u4EF6
+  return `# Growork v2.0 \u914D\u7F6E\u6587\u4EF6
 
 # \u98DE\u4E66\u5E94\u7528\u51ED\u8BC1 (\u4F7F\u7528\u98DE\u4E66\u6587\u6863\u65F6\u9700\u8981)
 feishu:
@@ -53,29 +121,37 @@ feishu:
 notion:
   token: "ntn_xxxx"  # Notion Integration Token
 
-# \u6587\u6863\u540C\u6B65\u914D\u7F6E
-docs:
-  # \u98DE\u4E66\u6587\u6863\u793A\u4F8B
-  - name: prd
-    type: feishu
-    url: "https://xxx.feishu.cn/docx/xxxxx"
-    output: "docs/product/prd.md"
+# \u8F93\u51FA\u6839\u76EE\u5F55\uFF08\u9ED8\u8BA4 "docs"\uFF09
+outputDir: "docs"
+
+# \u5168\u5C40\u6587\u6863\uFF08\u4E0D\u8DDF\u7248\u672C\uFF09
+custom:
+  - "https://xxx.feishu.cn/docx/xxxxx"        # \u6700\u7B80\u5199\u6CD5
+  # - url: "https://www.notion.so/xxxxx"
+  #   name: "\u6280\u672F\u67B6\u6784"                          # \u53EF\u9009\uFF1A\u81EA\u5B9A\u4E49\u540D\u79F0
+
+# \u7248\u672C\u5316\u6587\u6863
+versions:
+  v1.0:
+    \u7528\u6237\u767B\u5F55:
+      prd:
+        - "https://xxx.feishu.cn/docx/xxxxx"
+      # design:
+      #   - "https://xxx.feishu.cn/docx/yyyyy"
+      # api:
+      #   - "https://xxx.feishu.cn/docx/zzzzz"
+      # test:
+      #   - "https://xxx.feishu.cn/docx/aaaaa"
 
-  # Notion \u6587\u6863\u793A\u4F8B
-  - name: notion-prd
-    type: notion
-    url: "https://www.notion.so/xxxxx"
-    output: "docs/product/notion-prd.md"
+    # \u7B80\u5355 feature \u53EF\u4E0D\u5206\u7C7B
+    # \u5C0F\u4F18\u5316:
+    #   - "https://xxx.feishu.cn/docx/bbbbb"
 `;
 }
 
 // src/commands/init.ts
 var DIRS_TO_CREATE = [
-  "docs/product",
-  "docs/design",
-  "docs/api",
-  "docs/tech",
-  "docs/test"
+  "docs/custom"
 ];
 async function initCommand() {
   console.log(chalk.blue("\u{1F4C1} \u521D\u59CB\u5316 Growork \u9879\u76EE...\n"));
@@ -593,89 +669,153 @@ function clearLine() {
     console.log("");
   }
 }
-async function syncCommand(docName) {
-  const config = loadConfig();
+function extractTitleFromMarkdown(content) {
+  const match = content.match(/^#\s+(.+)$/m);
+  return match ? match[1].trim() : "\u672A\u547D\u540D\u6587\u6863";
+}
+async function syncCommand(options = {}) {
+  const config = loadConfigV2();
+  const docs = normalizeConfig(config, options);
+  if (docs.length === 0) {
+    console.log(chalk2.yellow("\u26A0\uFE0F  \u6CA1\u6709\u627E\u5230\u5339\u914D\u7684\u6587\u6863"));
+    return;
+  }
+  const normalDocs = docs.filter((d) => d.type !== "figma");
+  const figmaDocs = docs.filter((d) => d.type === "figma");
   const feishuService = config.feishu ? new FeishuService(config.feishu) : null;
   const notionService = config.notion ? new NotionService(config.notion) : null;
-  let docsToSync = config.docs;
-  if (docName) {
-    const doc = config.docs.find((d) => d.name === docName);
-    if (!doc) {
-      console.log(chalk2.red(`\u274C \u672A\u627E\u5230\u540D\u4E3A "${docName}" \u7684\u6587\u6863\u914D\u7F6E`));
-      console.log(chalk2.gray(`\u53EF\u7528\u7684\u6587\u6863: ${config.docs.map((d) => d.name).join(", ")}`));
-      process.exit(1);
-    }
-    docsToSync = [doc];
+  const hasFeishuDocs = normalDocs.some((d) => d.type === "feishu");
+  const hasNotionDocs = normalDocs.some((d) => d.type === "notion");
+  if (hasFeishuDocs && !feishuService) {
+    throw new Error("\u914D\u7F6E\u6587\u4EF6\u7F3A\u5C11\u98DE\u4E66\u51ED\u8BC1 (feishu.appId, feishu.appSecret)");
+  }
+  if (hasNotionDocs && !notionService) {
+    throw new Error("\u914D\u7F6E\u6587\u4EF6\u7F3A\u5C11 Notion \u51ED\u8BC1 (notion.token)");
   }
   console.log(chalk2.blue("\u{1F4C4} \u5F00\u59CB\u540C\u6B65\u6587\u6863...\n"));
   let successCount = 0;
-  for (const doc of docsToSync) {
-    process.stdout.write(chalk2.gray(`  \u23F3 ${doc.name.padEnd(15)} \u2192 ${doc.output}`));
+  const figmaGroups = /* @__PURE__ */ new Map();
+  for (const doc of figmaDocs) {
+    const dir = path3.dirname(doc.outputPath);
+    const feature = path3.basename(path3.dirname(dir));
+    if (!figmaGroups.has(dir)) {
+      figmaGroups.set(dir, { feature, urls: [] });
+    }
+    figmaGroups.get(dir).urls.push(doc.url);
+  }
+  for (const doc of normalDocs) {
+    const displayName = doc.name || doc.url.slice(-20);
+    process.stdout.write(chalk2.gray(`  \u23F3 ${displayName}`));
     try {
       let content;
       if (doc.type === "feishu") {
-        if (!feishuService) throw new Error("\u98DE\u4E66\u670D\u52A1\u672A\u914D\u7F6E");
         content = await feishuService.getDocumentAsMarkdown(doc.url);
-      } else if (doc.type === "notion") {
-        if (!notionService) throw new Error("Notion \u670D\u52A1\u672A\u914D\u7F6E");
-        content = await notionService.getPageAsMarkdown(doc.url);
       } else {
-        throw new Error(`\u4E0D\u652F\u6301\u7684\u6587\u6863\u7C7B\u578B: ${doc.type}`);
+        content = await notionService.getPageAsMarkdown(doc.url);
       }
-      const outputPath = path3.join(process.cwd(), doc.output);
+      const title = doc.name || extractTitleFromMarkdown(content);
+      const safeTitle = sanitizeFileName(title);
+      const outputPath = path3.join(process.cwd(), doc.outputPath.replace("{title}", safeTitle));
       const outputDir = path3.dirname(outputPath);
       if (!fs3.existsSync(outputDir)) {
         fs3.mkdirSync(outputDir, { recursive: true });
       }
       fs3.writeFileSync(outputPath, content, "utf-8");
       clearLine();
-      console.log(chalk2.green(`  \u2713 ${doc.name.padEnd(15)} \u2192 ${doc.output}`));
+      console.log(chalk2.green(`  \u2713 ${safeTitle.padEnd(25)} \u2192 ${path3.relative(process.cwd(), outputPath)}`));
       successCount++;
     } catch (error) {
       clearLine();
       const errorMessage = error instanceof Error ? error.message : String(error);
-      console.log(chalk2.red(`  \u2717 ${doc.name.padEnd(15)} \u2192 ${errorMessage}`));
+      console.log(chalk2.red(`  \u2717 ${displayName.padEnd(25)} \u2192 ${errorMessage}`));
     }
   }
+  for (const [dir, { feature, urls }] of figmaGroups) {
+    const content = `# ${feature} \u8BBE\u8BA1\u7A3F
+
+${urls.map((u) => `- ${u}`).join("\n")}
+`;
+    const outputPath = path3.join(process.cwd(), dir, "design.md");
+    fs3.mkdirSync(path3.dirname(outputPath), { recursive: true });
+    fs3.writeFileSync(outputPath, content, "utf-8");
+    console.log(chalk2.green(`  \u2713 design.md \u2192 ${path3.relative(process.cwd(), outputPath)}`));
+    successCount++;
+  }
   console.log("");
-  if (successCount === docsToSync.length) {
-    console.log(chalk2.green(`\u2705 \u540C\u6B65\u5B8C\u6210\uFF0C\u5171 ${docsToSync.length} \u4E2A\u6587\u6863`));
+  const totalCount = normalDocs.length + figmaGroups.size;
+  if (successCount === totalCount) {
+    console.log(chalk2.green(`\u2705 \u540C\u6B65\u5B8C\u6210\uFF0C\u5171 ${totalCount} \u4E2A\u6587\u6863`));
   } else {
-    console.log(chalk2.yellow(`\u26A0\uFE0F  \u540C\u6B65\u5B8C\u6210: ${successCount}/${docsToSync.length} \u4E2A\u6587\u6863\u6210\u529F`));
+    console.log(chalk2.yellow(`\u26A0\uFE0F  \u540C\u6B65\u5B8C\u6210: ${successCount}/${totalCount} \u4E2A\u6587\u6863\u6210\u529F`));
   }
 }
 
 // src/commands/list.ts
-import * as fs4 from "fs";
-import * as path4 from "path";
 import chalk3 from "chalk";
+function shortenUrl(url, maxLen = 40) {
+  if (url.length <= maxLen) return url;
+  return url.slice(0, maxLen - 3) + "...";
+}
 async function listCommand() {
   if (!configExists()) {
     console.log(chalk3.red("\u274C \u914D\u7F6E\u6587\u4EF6\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u8FD0\u884C growork init"));
     process.exit(1);
   }
-  const config = loadConfig();
-  const cwd = process.cwd();
+  const config = loadConfigV2();
   console.log(chalk3.blue("\u{1F4CB} \u6587\u6863\u5217\u8868\n"));
-  console.log(chalk3.gray("  \u540D\u79F0".padEnd(18) + "\u7C7B\u578B".padEnd(10) + "\u8F93\u51FA\u8DEF\u5F84".padEnd(30) + "\u72B6\u6001"));
-  console.log(chalk3.gray("  " + "-".repeat(70)));
-  for (const doc of config.docs) {
-    const outputPath = path4.join(cwd, doc.output);
-    const exists = fs4.existsSync(outputPath);
-    const status = exists ? chalk3.green("\u5DF2\u540C\u6B65") : chalk3.yellow("\u672A\u540C\u6B65");
-    const name = `  ${doc.name}`.padEnd(18);
-    const type = doc.type.padEnd(10);
-    const output = doc.output.padEnd(30);
-    console.log(`${name}${chalk3.gray(type)}${output}${status}`);
+  let totalCount = 0;
+  if (config.custom && config.custom.length > 0) {
+    console.log(chalk3.cyan("\u{1F4C1} custom (\u5168\u5C40\u6587\u6863)"));
+    for (const input of config.custom) {
+      const { url, name } = parseDocInput(input);
+      const displayName = name || shortenUrl(url);
+      console.log(chalk3.gray(`    - ${displayName}`));
+      totalCount++;
+    }
+    console.log("");
   }
-  console.log("");
-  console.log(chalk3.gray(`\u5171 ${config.docs.length} \u4E2A\u6587\u6863\u914D\u7F6E`));
+  if (config.versions) {
+    for (const [version, features] of Object.entries(config.versions)) {
+      console.log(chalk3.cyan(`\u{1F4C1} ${version}`));
+      for (const [feature, value] of Object.entries(features)) {
+        if (Array.isArray(value)) {
+          console.log(chalk3.white(`  \u2514\u2500 ${feature}`));
+          for (const input of value) {
+            const { url, name } = parseDocInput(input);
+            const displayName = name || shortenUrl(url, 30);
+            console.log(chalk3.gray(`       - ${displayName}`));
+            totalCount++;
+          }
+        } else {
+          console.log(chalk3.white(`  \u2514\u2500 ${feature}`));
+          for (const docType of ["prd", "design", "api", "test"]) {
+            const docInputs = value[docType];
+            if (!docInputs || docInputs.length === 0) continue;
+            console.log(chalk3.yellow(`       ${docType}:`));
+            for (const input of docInputs) {
+              const { url, name } = parseDocInput(input);
+              const displayName = name || shortenUrl(url, 25);
+              console.log(chalk3.gray(`         - ${displayName}`));
+              totalCount++;
+            }
+          }
+        }
+      }
+      console.log("");
+    }
+  }
+  console.log(chalk3.gray(`\u5171 ${totalCount} \u4E2A\u6587\u6863\u914D\u7F6E`));
 }
 
 // src/index.ts
 var program = new Command();
-program.name("growork").description("\u5C06\u98DE\u4E66\u6587\u6863\u540C\u6B65\u5230\u672C\u5730\uFF0C\u4E3A AI Agent \u63D0\u4F9B\u5B8C\u6574\u4E0A\u4E0B\u6587").version("1.0.0");
+program.name("growork").description("\u5C06\u98DE\u4E66\u6587\u6863\u540C\u6B65\u5230\u672C\u5730\uFF0C\u4E3A AI Agent \u63D0\u4F9B\u5B8C\u6574\u4E0A\u4E0B\u6587").version("2.0.0");
 program.command("init").description("\u521D\u59CB\u5316 Growork \u914D\u7F6E\u548C\u76EE\u5F55\u7ED3\u6784").action(initCommand);
-program.command("sync [name]").description("\u540C\u6B65\u6587\u6863\uFF0C\u53EF\u9009\u6307\u5B9A\u6587\u6863\u540D\u79F0").action(syncCommand);
+program.command("sync").description("\u540C\u6B65\u6587\u6863").option("--ver <version>", "\u53EA\u540C\u6B65\u6307\u5B9A\u7248\u672C").option("-f, --feature <feature>", "\u53EA\u540C\u6B65\u6307\u5B9A feature").option("-c, --custom", "\u53EA\u540C\u6B65\u5168\u5C40\u6587\u6863").action((options) => {
+  if (options.ver) {
+    options.version = options.ver;
+  }
+  syncCommand(options);
+});
 program.command("list").description("\u5217\u51FA\u6240\u6709\u914D\u7F6E\u7684\u6587\u6863").action(listCommand);
 program.parse();

package/docs/architecture.md

@@ -0,0 +1,175 @@
+# GroWork 技术架构
+
+## 概述
+
+GroWork 是一个文档同步 CLI 工具，将飞书文档、Notion 页面和 Figma 设计稿同步到本地 Markdown 文件。
+
+## 项目结构
+
+```
+src/
+├── index.ts           # CLI 入口
+├── commands/
+│   ├── init.ts        # growork init
+│   ├── sync.ts        # growork sync
+│   └── list.ts        # growork list
+├── services/
+│   ├── feishu.ts      # 飞书 API 服务
+│   └── notion.ts      # Notion API 服务
+└── utils/
+    └── config.ts      # 配置解析
+```
+
+## 核心模块
+
+### 1. CLI 入口 (`src/index.ts`)
+
+使用 `commander` 定义命令：
+
+- `growork init` - 初始化配置文件
+- `growork sync` - 同步文档，支持 `--ver`、`-f`、`-c` 过滤
+- `growork list` - 列出所有文档
+
+### 2. 配置模块 (`src/utils/config.ts`)
+
+**核心类型：**
+
+```typescript
+// 文档输入格式
+type DocInput = string | { url: string; name?: string };
+
+// 标准化后的文档
+interface NormalizedDoc {
+  url: string;
+  name?: string;
+  type: 'feishu' | 'notion' | 'figma';
+  outputPath: string;  // 含 {title} 占位符
+}
+```
+
+**核心函数：**
+
+| 函数 | 作用 |
+|-----|------|
+| `loadConfigV2()` | 加载并解析 YAML 配置文件 |
+| `normalizeConfig()` | 将配置转为标准化的 `NormalizedDoc[]` |
+| `inferDocType()` | 根据 URL 推断文档类型 |
+| `sanitizeFileName()` | 处理文件名特殊字符 |
+
+### 3. 同步命令 (`src/commands/sync.ts`)
+
+**处理流程：**
+
+```
+loadConfigV2() → normalizeConfig() → 分组处理
+                                        ├── 飞书文档 → FeishuService.getDocumentAsMarkdown()
+                                        ├── Notion 页面 → NotionService.getPageAsMarkdown()
+                                        └── Figma 链接 → 直接生成 design.md
+```
+
+**Figma 处理逻辑：**
+
+同一 feature 下的多个 Figma URL 会合并到一个 `design.md` 文件：
+
+```typescript
+// 按目录分组
+const figmaGroups = new Map<string, { feature: string; urls: string[] }>();
+
+// 生成内容
+const content = `# ${feature} 设计稿\n\n${urls.map(u => `- ${u}`).join('\n')}\n`;
+```
+
+### 4. 飞书服务 (`src/services/feishu.ts`)
+
+**职责：** 调用飞书 API 获取文档内容，转换为 Markdown。
+
+**核心方法：**
+
+| 方法 | 作用 |
+|-----|------|
+| `getDocumentAsMarkdown(url)` | 主入口，返回完整 Markdown |
+| `parseDocumentId(url)` | 解析 URL 中的文档 ID |
+| `resolveDocumentId(url)` | Wiki 链接需要额外解析真实 ID |
+| `getAllBlocks(docId)` | 分页获取所有 block |
+| `blockToMarkdown(block)` | 将单个 block 转为 Markdown |
+
+**支持的 block 类型：**
+
+| blockType | 类型 | 输出 |
+|-----------|------|------|
+| 2 | Text | 普通文本 |
+| 3-11 | Heading1-9 | `#` ~ `######` |
+| 12 | Bullet | `- item` |
+| 13 | Ordered | `1. item` |
+| 14 | Code | ` ```lang ``` ` |
+| 15 | Quote | `> text` |
+| 17 | TodoList | `- [ ] task` |
+| 18 | Divider | `---` |
+| 19 | Image | `![image](token)` |
+| 31 | Table | Markdown 表格 |
+
+### 5. Notion 服务 (`src/services/notion.ts`)
+
+**职责：** 调用 Notion API 获取页面内容，使用 `notion-to-md` 库转换。
+
+**核心方法：**
+
+| 方法 | 作用 |
+|-----|------|
+| `getPageAsMarkdown(url)` | 主入口，返回完整 Markdown |
+| `parsePageId(url)` | 从 URL 提取 page ID |
+| `setupCustomTransformers()` | 自定义 child_database 转换 |
+
+**数据库处理：**
+
+内嵌数据库（child_database）会自动转为 Markdown 表格，支持的字段类型：
+
+- title, rich_text, select, multi_select
+- number, checkbox, date, url, files
+
+## 数据流
+
+```
+┌─────────────────┐
+│ growork.config  │  YAML 配置文件
+│     .yaml       │
+└────────┬────────┘
+         │ loadConfigV2()
+         ▼
+┌─────────────────┐
+│ GroworkConfigV2 │  原始配置对象
+└────────┬────────┘
+         │ normalizeConfig(options)
+         ▼
+┌─────────────────┐
+│ NormalizedDoc[] │  标准化文档列表
+└────────┬────────┘
+         │
+    ┌────┴────┬──────────┐
+    ▼         ▼          ▼
+ Feishu    Notion     Figma
+    │         │          │
+    ▼         ▼          ▼
+┌─────────────────────────────┐
+│     Markdown 文件写入本地     │
+└─────────────────────────────┘
+```
+
+## 技术栈
+
+| 用途 | 依赖 |
+|-----|------|
+| CLI 框架 | commander |
+| 飞书 API | @larksuiteoapi/node-sdk |
+| Notion API | @notionhq/client |
+| Notion 转 MD | notion-to-md |
+| YAML 解析 | yaml |
+| 终端颜色 | chalk |
+| 构建工具 | tsup |
+
+## 设计原则
+
+1. **最少代码** - 不提前抽象，只实现当前需求
+2. **扁平结构** - 目录层级不超过 2 层
+3. **错误自然抛出** - 在顶层统一处理，不过度防御
+4. **依赖成熟库** - 不重复造轮子

package/docs/developer-notes.md

@@ -0,0 +1,67 @@
+# 开发者说
+
+## AI 时代的开发范式
+
+GroWork 是一个 **零手写代码** 的项目。从第一行代码到现在，所有实现都由 AI 完成，人只负责写文档和提示词。
+
+## 核心洞察：后端最贴合 AI
+
+后端开发是目前最适合 AI 全流程接管的领域：
+
+- **输入输出明确** - API 契约清晰，不涉及主观审美
+- **逻辑可验证** - 单元测试可以客观判断对错
+- **文档驱动** - PRD、API 文档天然适合作为 AI 的上下文
+
+相比之下，前端涉及 UI/UX 审美判断，AI 难以完全替代人的决策。
+
+## AI All-in-One 闭环
+
+```
+PRD 文档 → 架构设计 → 测试用例 → 代码实现 → Code Review → 发布
+   ↑                                                      │
+   └──────────────────── 迭代反馈 ←────────────────────────┘
+```
+
+每个环节都由 AI 执行，人只在关键节点做决策。
+
+## 多 Tab 工作流
+
+将 Claude Code 分为多个独立 Tab，各司其职：
+
+| Tab              | 职责                               |
+| ---------------- | ---------------------------------- |
+| **doc**    | 生成/更新文档（PRD、架构、README） |
+| **code**   | 编写实现代码                       |
+| **test**   | 编写和运行测试用例                 |
+| **review** | 代码审查，检查规范和潜在问题       |
+| **git**    | 提交、推送、PR 管理                |
+
+这种分离让每个 Tab 保持专注的上下文，避免单一会话过载。
+
+## 人的角色转变
+
+在这个模式下，开发者的工作变成了：
+
+1. **写文档** - PRD 描述需求，架构文档描述设计
+2. **写提示词** - 精准表达意图，引导 AI 输出
+3. **做决策** - 在多个方案中选择，把控方向
+4. **验收成果** - 确认 AI 的输出符合预期
+
+代码不再是手写的，而是「生成」的。
+
+## 实践心得
+
+1. **文档质量决定代码质量** - 垃圾文档进，垃圾代码出
+2. **小步快跑** - 每次只让 AI 做一件小事，而不是一次性生成大量代码
+3. **测试先行** - 先让 AI 写测试用例，再写实现，AI 更容易做对
+4. **持续 Review** - AI 会犯错，定期审查避免技术债累积
+
+## 展望
+
+这只是开始。随着 AI 能力提升，未来的开发模式会更加极致：
+
+- 需求直接生成可运行的代码
+- 自动修复 bug，自动优化性能
+- 人只需要描述「想要什么」，而不是「怎么做」
+
+GroWork 本身就是这个未来的一个小小实验。

package/docs/prd-1.0.0.md

@@ -0,0 +1,86 @@
+# GroWork 1.0.0 PRD
+
+## 概述
+
+| 项目 | 内容 |
+|-----|-----|
+| 产品名称 | GroWork |
+| 版本 | 1.0.0 |
+| 产品形态 | CLI 命令行工具 |
+| 技术栈 | Node.js / TypeScript |
+
+## 背景与目标
+
+### 背景
+
+AI Agent 开发时代，PRD、设计稿、接口文档、技术方案分散在 Lark/Notion/Figma 等平台，无法在一个工程内闭环。
+
+### 目标
+
+实现产品开发全流程文档在一个文件夹下闭环，让 AI Agent 一次性获取完整上下文。
+
+## 用户场景
+
+使用 Claude Code 等 Agent 工具的开发者，希望同步远程文档到本地，让 AI 直接读取进行开发。
+
+## 功能需求
+
+### 功能列表
+
+| 命令 | 说明 | 状态 |
+|-----|-----|-----|
+| `growork init` | 生成配置文件和目录结构 | ✅ |
+| `growork sync` | 同步所有配置的文档 | ✅ |
+| `growork sync <name>` | 同步指定文档 | ✅ |
+| `growork list` | 列出所有文档及状态 | ✅ |
+
+### 支持的文档类型
+
+| 类型 | 说明 |
+|-----|-----|
+| `feishu` | Lark 文档和知识库 |
+| `notion` | Notion 页面（含内嵌数据库） |
+
+### 核心流程
+
+```
+growork init → 编辑配置文件 → growork sync → AI 读取 docs/ 目录
+```
+
+## 技术设计
+
+### 技术选型
+
+| 用途 | 选择 |
+|-----|-----|
+| CLI 框架 | Commander.js |
+| Lark SDK | @larksuiteoapi/node-sdk |
+| Notion SDK | @notionhq/client + notion-to-md |
+| 配置解析 | yaml |
+| 构建工具 | tsup |
+
+### 项目结构
+
+```
+src/
+├── index.ts           # CLI 入口
+├── commands/          # 命令实现
+├── services/          # Lark/Notion API
+└── utils/             # 配置解析
+```
+
+## 验收标准
+
+- [x] 能同步 Lark 文档和知识库到本地 Markdown
+- [x] 能同步 Notion 页面到本地 Markdown
+- [x] 支持批量同步和单个同步
+- [x] 单文档同步 < 5 秒
+
+## 开放问题
+
+- [ ] 是否支持增量同步？
+- [ ] 凭证是否改用环境变量？
+
+## 后续版本
+
+1.1.0 已发布，引入版本和 feature 层级结构，详见 [prd-1.1.0.md](./prd-1.1.0.md)