workspace-init

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

工作空间初始化

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

初始化流程

步骤 0: 检查版本更新

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

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

如果显示有更新，提示用户：

🔄 工作空间有新版本可用

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

是否更新？[是] [否]

如果用户选择更新：

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：

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

# 如果项目已 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 模板

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

## 项目概况

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

## 文档规范

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

## 飞书集成

Wiki Space: {space_id}
Bitable: {app_token}

## 可用 Skills

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

团队配置

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

# 团队成员

| 姓名 | 角色 | 飞书 ID | 邮箱 |
|------|------|---------|------|
| 张三 | 负责人 | ou_xxx | [e-mail] |

## 角色说明

- **负责人**: 项目整体负责，审批决策
- **产品**: 负责需求、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 文件
• 如果有已批准的文档，提示用户可以同步到飞书
• 不自动执行同步，避免意外覆盖

手动安装（如需要）：

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 无效	提示用户重新获取