# CLAUDE.md — Tinbird Database AI 助手指南

本文件指导 AI 助手在 `tinbird-database`（锡鸟科技公司知识库）中如何协助团队。

---

## 项目背景

**公司名称**：广州锡鸟科技有限公司  
**英文名**：Tinbird  
**所在地**：广州市天河区  
**主营业务**：独立游戏开发  
**在研项目**：《爱与机器人维修技术》（英文名：All Our Broken Parts）

### 团队构成（4名全职 + 3名顾问）

| 姓名 | 角色 | 备注 |
|------|------|------|
| 班春晖 | 制作人、创意总监、法人 | 持股34% |
| 陈子钦 | 文案策划、音频 | 持股22% |
| 周子迁 | 美术 | 持股22% |
| 丁耘天 | 程序、财务负责人 | 持股22% |
| 江卓亚 | 玩法设计顾问 | 兼职 |
| 伍振彤 | 剧情顾问 | 兼职 |
| 小唐 | 角色美术顾问 | 笔名，兼职 |

**融资状态**：奇绩创坛准备投资30万美元换取7%股份，需预留15%期权池。

---

## 知识库结构

本仓库采用**中文文件夹 + 英文文件名**的混合命名策略，兼顾可读性与工具兼容性。

```
tinbird-database/
├── CLAUDE.md              # 本文件：AI 助手指南
├── 公司知识库指南.md      # 文档组织规范
├── 现有文档.md            # 待导入原始资料清单
├── 公司概况/
├── 组织与人员/
├── 股权与融资/
├── 法务与合规/
├── 财务与行政/
├── 知识产权与品牌/
├── 发行与市场/
├── 商务与合作/
├── 时间线与里程碑/
├── 对外话术与材料/
├── 当前重点项目/
└── 归档/                    # 可选：派生文档；非默认输出路径（见 归档/README.md）
```

### 核心文档

| 文档 | 作用 |
|------|------|
| [公司知识库指南.md](公司知识库指南.md) | 知识库组织规范、Brief 写作标准 |
| [公司概况/公司概况.md](公司概况/公司概况.md) | 公司基本信息、团队、股权、项目概述 |
| [现有文档.md](现有文档.md) | 未导入的原始资料清单及建议存放位置 |
| 各分类 `brief.md` | 该类别的摘要与索引入口 |

---

## 工作原则

### 1. Brief 优先

每个分类目录下都有 `brief.md`，这是该类别的事实入口：

- **先读 brief**：获取摘要、关键数字和索引
- **再按需深入**：通过 brief 中的索引找到原件
- **更新 brief**：添加新文档时同步更新 brief 的索引表

### 2. 单一事实源

- 关键日期、正式名称、对外数字只在**一处**写定
- 其他文档通过引用或链接指向该源头
- 发现不一致时，以最新日期的文档为准并提醒团队

### 3. 敏感信息处理

- **股权细节**：可仅存索引或注明「向丁耘天索取」
- **合同全文**：brief 中只写摘要和存放位置
- **账户信息**：控制访问范围，brief 中不写具体数字
- **身份证号等**：不在 markdown 中存放，注明原件位置

### 4. 中文回复

**必须用中文回复**，这是团队设定的规则。

---

## 常见任务指南

### 导入 Word/PDF 文档

使用仓库内置的 `.cursor/skills/docx-pdf-to-markdown/` 工具：

1. **`.docx` 文件**：使用 Pandoc 转换为 Markdown
2. **文本型 `.pdf`**：使用 Poppler `pdftotext` 提取（不用 Pandoc，因其读 PDF 不稳定）
3. 转换后放入对应分类文件夹
4. **更新该分类的 `brief.md`**：添加索引条目

### 导出为 Word 文档

使用 `.cursor/skills/markdown-to-docx/` 工具：

```powershell
# 在 PowerShell 中执行
.cursor/skills/markdown-to-docx/scripts/convert-to-docx.ps1 -InputFile "文档路径.md"
```

**输出位置**：导出或生成文件的路径**由使用者指定**；**不要**在未获明确指示时自动写入 **`归档/`**。`归档/` 的用途与边界见 [归档/README.md](归档/README.md)。

### 更新 Brief

当添加或修改文档时，按以下顺序更新 brief：

1. 更新「一句话摘要」（如有状态变化）
2. 更新「要点列表」（如有新增要点）
3. 更新「索引表」（添加新文档条目）
4. 更新「关键事实」（如有日期/数字变更）
5. 更新文末 `last_updated` 时间戳

---

## 重要术语与名称

### 公司相关

| 中文 | 英文 | 备注 |
|------|------|------|
| 广州锡鸟科技有限公司 | Tinbird / Tinbird Games | 正式公司名 |
| 爱与机器人维修技术 | All Our Broken Parts | 在研游戏 |
| 奇绩创坛 | MiraclePlus | 投资方 |
| 机核 | Gcores | 大中华地区PC发行商 |
| TapTap | - | 移动端发行平台 |

### 项目相关

| 术语 | 解释 |
|------|------|
| 大遗忘 | 游戏世界观核心设定 |
| 机体 | 被改造后的人类 |
| 主脑 | 统治世界的AI |
| 原型 | 机体视为缺陷的人类情感 |

---

## 文件模板

### 新建 Brief 模板

```markdown
# [分类名] Brief

## 一句话摘要

[本类当前状态，如：股权截至2025年X月X日，奇绩创坛投资进行中]

## 要点列表

1. [要点1]
2. [要点2]
3. [要点3]

## 索引表

| 文件名 | 类型 | 路径 | 备注 |
|--------|------|------|------|
| [文档名] | pdf/md/docx | [路径] | [是否敏感/需更新] |

## 关键事实

- 日期：[关键日期]
- 主体：[相关方名称]
- 编号：[如有编号]

---

*last_updated: YYYY-MM-DD*
```

---

## 注意事项

1. **不要重复项目知识库内容**：游戏设计、叙事设定、版本管理在另一仓库
2. **保持 brief 简洁**：每份 brief 控制在 100 行以内，方便快速浏览
3. **交叉引用时使用相对路径**：如 `[股权与融资/brief.md](股权与融资/brief.md)`
4. **日期格式统一**：使用 `YYYY-MM-DD` 格式
5. **定期同步**：建议重大变更后 24 小时内更新 brief

---

*本文档由 AI 助手根据 [公司知识库指南.md](公司知识库指南.md) 和 [公司概况/公司概况.md](公司概况/公司概况.md) 生成。*