# Workspace Init

> 工作空间初始化。在以下场景触发： 1. 用户说 "初始化项目"、"初始化工作空间" 2. 用户说 "新建项目"、"创建项目" 3. 用户在一个空目录中说 "开始" 4. 用户需要快速搭建项目结构 一键初始化 OpenWork Native 工作空间，支持飞书集成配置。

- Skill: `fstln-dev/workspace-init-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fstln-dev/workspace-init-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fstln-dev/workspace-init-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: fstln-dev (https://skillmd.com/u/fstln-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fstln-dev/workspace-init-2

---

# 工作空间初始化

快速初始化 OpenWork Native 工作空间，创建标准目录结构和配置文件。

## 初始化流程

### 步骤 0: 检查版本更新

首先检查本地工作空间版本：

```bash
# 如果 .opencode-workspace 已存在，检查版本
cd .opencode-workspace
git fetch origin
git status
```

如果显示有更新，提示用户：
```
🔄 工作空间有新版本可用

当前版本: 1.0.0
最新版本: x.x.x

是否更新？[是] [否]
```

如果用户选择更新：
```bash
git pull origin main
cp -r .opencode-workspace/skills/* .opencode/
echo "✅ 已更新到最新版本"
```

### 步骤 1: 选择项目类型

```
🚀 初始化 OpenWork Native 工作空间

请选择项目类型:

[1] product-dev    - 产品研发（PRD、技术方案、测试）
[2] implementation - 实施交付（需求、方案、实施、验收）
[3] operation      - 运营活动（分析、策略、SOP、复盘）
[4] it-infra       - IT 信息化（需求、方案、集成、运维）

选择: _
```

### 步骤 2: 基本信息

```
📝 项目基本信息

项目名称: my-project
项目描述: 一个示例项目
负责人: 张三

确认？[是] [修改]
```

### 步骤 3: 飞书集成配置

```
飞书集成配置

是否启用飞书集成？[是] [跳过]

如果选择 [是]：

推荐同时配置两个飞书 MCP，获得完整功能：

┌─────────────────────────────────────────────────────────────┐
│  feishu-official (飞书官方 MCP)                              │
│  → 云文档深度操作                                            │
│  → 需要先在飞书配置平台获取授权后的 MCP URL                   │
│  → 配置后立即可用                                            │
├─────────────────────────────────────────────────────────────┤
│  feishu (第三方 MCP)                                         │
│  → Wiki、多维表格、任务、日历、消息等                         │
│  → 需要在 OpenWork Extension 中手动配置                      │
│  → 配置后需要完成浏览器授权                                  │
└─────────────────────────────────────────────────────────────┘

⚠️ 注意：OpenWork 的 MCP 配置需要在 Extension 中手动添加

[同时配置两个] [仅配置 feishu-official] [仅配置 feishu] [跳过]
```

#### 选项 A: 配置 feishu-official

```
📋 配置 feishu-official (飞书官方 MCP)

请按以下步骤获取 MCP URL：

1. 打开飞书 MCP 配置平台：https://open.feishu.cn/page/mcp
2. 点击「创建 MCP 服务」
3. 在「添加工具」中选择「云文档」工具集
4. 点击「授权」完成用户授权
5. 复制生成的「服务器 URL」

⚠️ 注意：
- 服务器 URL 包含您的授权信息，请勿泄露
- MCP 服务有效期 7 天，过期需重新授权
- 如链接泄露，可在平台点击「重置链接」

获取 URL 后，请在 OpenWork Extension 中添加：

1. 打开 OpenWork Extension 设置
2. 进入 MCP 配置页面
3. 添加新的 MCP 服务器：
   - 名称：feishu-official
   - 类型：http
   - URL：<您从飞书平台获取的服务器 URL>
4. 保存配置

[已完成配置] [稍后配置]
```

#### 选项 B: 配置 feishu

```
📋 配置 feishu (第三方 MCP)

feishu MCP 提供多维表格、任务、日历等功能。
配置后需要完成浏览器授权。

请在 OpenWork Extension 中添加：

1. 打开 OpenWork Extension 设置
2. 进入 MCP 配置页面
3. 添加新的 MCP 服务器：
   - 名称：feishu
   - 类型：http
   - URL：https://feishu-mcp.fastgrowth.ai/mcp
4. 保存配置
5. 重启 OpenWork
6. 根据提示完成浏览器授权

[已完成配置] [稍后配置]
```

#### 如果选择跳过飞书集成

```
飞书集成未配置

没有飞书集成时，以下功能不可用：
- Wiki 文档同步
- 多维表格操作
- 任务管理
- 日历集成
- 云文档操作

后续可随时通过「配置飞书」重新配置。

[继续] [返回配置]
```

### 步骤 4: 知识库配置（如果已完成 MCP 配置）

```
知识库配置

是否现在配置项目关联的知识库？

→ 调用飞书 MCP 工具列出可访问的知识库

选择要关联的知识库序号: _

[配置] [跳过]
```

### 步骤 5: 生成结构

```
📁 生成项目结构...

✅ 创建 OPENWORK.md
✅ 创建 .opencode/settings.json
✅ 创建 .opencode/context/team.md
✅ 创建 .opencode/context/doc-index.md
✅ 创建 .opencode/context/feishu-config.md
✅ 创建 docs/product/.gitkeep
✅ 创建 docs/tech/.gitkeep
✅ 创建 docs/test/.gitkeep
✅ 创建 docs/meetings/.gitkeep
✅ 创建 templates/prd.md
✅ 创建 templates/tech-design.md
✅ 创建 templates/test-plan.md
✅ 创建 scripts/post-commit (Git Hook)

🔧 配置 Git Hooks...
✅ 安装 post-commit hook → .git/hooks/post-commit

🎉 初始化完成！
```

**自动安装 Git Hook：**

初始化时自动执行以下操作：

```bash
# 如果项目已 git init，自动安装 hook
if [ -d ".git/hooks" ]; then
  cp scripts/post-commit .git/hooks/post-commit
  chmod +x .git/hooks/post-commit
  echo "✅ Git post-commit hook 已安装"
fi
```

如果项目尚未初始化 git，hook 脚本会保存在 `scripts/post-commit`，用户可以在后续 `git init` 后手动安装。

## 功能对比

| 功能 | feishu-official | feishu |
| --- | --- | --- |
| 云文档深度操作 | ✅ | ❌ |
| Wiki 文档操作 | ✅ | ✅ |
| 多维表格操作 | ❌ | ✅ |
| 任务管理 | ❌ | ✅ |
| 日历集成 | ❌ | ✅ |
| 消息发送 | ❌ | ✅ |
| 配置方式 | 飞书平台获取 URL | OpenWork Extension 手动添加 |
| 有效期 | 7 天需续期 | 长期有效 |

**建议：** 同时配置两个 MCP，获得完整的飞书功能。

## 生成的目录结构

### product-dev 类型

```
project-root/
├── OPENWORK.md                 # AI 配置（自动加载）
├── .opencode/
│   ├── settings.json            # OpenWork 设置
│   └── context/
│       ├── team.md              # 团队成员
│       ├── doc-index.md         # 文档索引
│       ├── feishu-config.md     # 飞书配置
│       └── feishu-map.md        # 飞书映射
├── docs/
│   ├── product/                 # 产品文档
│   ├── tech/                    # 技术文档
│   ├── test/                    # 测试文档
│   └── meetings/                # 会议纪要
└── templates/
    ├── prd.md
    ├── tech-design.md
    └── test-plan.md
```

## OPENWORK.md 模板

生成的 `OPENWORK.md` 根据项目类型自动配置：

### product-dev 模板

```markdown
# {项目名称} - AI 协同工作空间

## 项目概况

- **项目类型**: product-dev（产品研发）
- **当前阶段**: 需求分析
- **负责人**: {负责人}
- **团队**: 见 .opencode/context/team.md

## 文档规范

[... 标准 product-dev 配置 ...]

## 飞书集成

Wiki Space: {space_id}
Bitable: {app_token}

## 可用 Skills

[... product-dev 可用 Skills 列表 ...]
```

## 团队配置

生成的 `.opencode/context/team.md`：

```markdown
# 团队成员

| 姓名 | 角色 | 飞书 ID | 邮箱 |
|------|------|---------|------|
| 张三 | 负责人 | ou_xxx | zhang@example.com |

## 角色说明

- **负责人**: 项目整体负责，审批决策
- **产品**: 负责需求、PRD
- **技术**: 负责技术方案、开发
- **测试**: 负责测试用例、质量

## 评审规则

- PRD: 需要 2 人评审通过
- 技术方案: 需要技术负责人评审通过
- 代码: 需要 1 人评审通过
```

### 步骤 6: Git Hooks 配置

```
🔧 Git Hooks 配置

检测到 Git 仓库，自动安装 post-commit hook...

✅ post-commit hook 已安装到 .git/hooks/
```

**自动安装逻辑：**

| 场景 | 操作 |
| --- | --- |
| 项目已 `git init` | 自动复制 `scripts/post-commit` → `.git/hooks/post-commit` 并添加执行权限 |
| 项目未初始化 git | 保留脚本在 `scripts/post-commit`，等待用户 `git init` 后手动安装 |

**post-commit hook 功能：**
- 检测本次提交中 `status=approved` 的 .md 文件
- 如果有已批准的文档，提示用户可以同步到飞书
- 不自动执行同步，避免意外覆盖

**手动安装（如需要）：**

```bash
cp scripts/post-commit .git/hooks/
chmod +x .git/hooks/post-commit
```

## 快速模式

支持命令行快速初始化：

```
用户: "用 product-dev 模板初始化"

AI: 直接使用 product-dev 默认配置初始化，跳过交互步骤
```

```
用户: "初始化一个研究项目，名字叫 AI-Research"

AI: 使用 research 模板，项目名 AI-Research，快速初始化
```

## 检测已存在的工作空间

如果目录中已有 `OPENWORK.md`：

```
⚠️ 检测到已有工作空间配置

当前项目: {项目名称}
类型: {项目类型}
创建时间: {创建时间}

选项:
[1] 更新配置（保留现有文件）
[2] 重新初始化（覆盖现有文件）
[3] 取消
```

## 初始化后操作

初始化完成后，AI 建议：

```
🎉 工作空间已就绪！

下一步建议:

1. 编辑 .opencode/context/team.md 添加团队成员

2. 完成飞书 MCP 配置（如果尚未配置）:
   在 OpenWork Extension 中添加 MCP 服务器：
   - feishu-official: 从 https://open.feishu.cn/page/mcp 获取 URL
   - feishu: https://feishu-mcp.fastgrowth.ai/mcp

3. 配置知识库（可选）:
   "帮我配置飞书知识库"

4. 创建第一个文档:
   "创建订单模块的 PRD"

开始工作？
```

## feishu-official URL 续期

feishu-official 的 MCP URL 有效期为 7 天。过期后：

1. 打开飞书 MCP 配置平台：https://open.feishu.cn/page/mcp
2. 找到对应的 MCP 服务
3. 点击「重新授权」
4. 复制新的服务器 URL
5. 在 OpenWork Extension 中更新 URL
6. 重启 OpenWork

## 从现有项目迁移

如果目录中已有文档：

```
📦 检测到现有文档

发现:
- 5 个 .md 文件
- 2 个 .docx 文件

选项:
[1] 导入现有文档（自动分类）
[2] 仅初始化配置（不导入）
[3] 查看文件列表

导入后文档将被移动到对应目录:
- *.md → docs/product/ 或 docs/tech/
- *.docx → 需要手动转换
```

## 错误处理

| 错误 | 处理 |
| --- | --- |
| 目录非空 | 提示用户确认是否继续 |
| 权限不足 | 提示检查目录权限 |
| 飞书连接失败 | 允许跳过，稍后配置 |
| 模板不存在 | 使用默认模板 |
| MCP URL 无效 | 提示用户重新获取 |