Bilibili Live Recorder 开发指南

本技能为 bililive-go 项目提供开发指导。bililive-go 是一个直播录制工具。

核心要求

语言规范

**永远使用中文进行交流**，包括：

编译和验证规则

1. **修改代码后必须验证编译**

- 运行 `make dev` 验证后端编译通过

- 如果涉及前端修改，运行 `make build-web dev`

2. **禁止直接使用 Go 命令**

- ❌ 不要使用 `go build ./...`

- ✅ 必须使用 Make 命令：`make dev` 或 `make build-web dev`

3. **提交前完整检查**

- 确保以下命令全部通过：

- `make build-web dev` — 编译前端和后端

- `make lint` — 代码检查

- `make test` — 单元测试

工作流程

当用户请求修改代码时，按以下步骤操作：

1. **理解需求**

- 用中文确认用户需求

- 如果不确定，用中文询问细节

2. **实施修改**

- 修改相关代码文件

- 所有新增注释必须用中文

3. **验证修改**

- 运行 `make dev` 验证后端编译

- 如果修改了前端，运行 `make build-web dev`

- 如果验证失败，立即修复错误并重新验证

4. **代码质量检查**

- 运行 `make lint` 检查代码规范

- 如果有相关单元测试，运行 `make test`

- 修复所有报告的问题

5. **确认完成**

- 用中文总结修改内容

- 告知用户所有验证已通过

专项指南

项目在 `.agent/skills/` 目录下提供详细的专项指南：

Build (编译)

Config Modification (配置修改)

Test E2E (端到端测试)

**查阅方式：** 读取 `.agent/skills/` 目录下对应的 markdown 文件获取详细信息。

常用命令参考

```bash

编译后端

make dev

编译前端 + 后端

make build-web dev

代码检查

make lint

单元测试

make test

E2E 测试

npx playwright test

同步 AI 指示文件到其他位置

make sync-agents

```

AI 指示文件同步

本项目的 AI 指示文件是统一管理的：

- `.agent/rules/gemini-guide.md` (Gemini CLI)

- `.gemini/GEMINI.md` (Antigravity)

修改 AI 指示后，运行 `make sync-agents` 同步到所有位置。

约束和注意事项

1. **强制使用中文** — 这是最重要的规则，违反会导致用户体验下降

2. **禁止跳过编译验证** — 未经验证的代码不得提交

3. **Make 命令优先** — 项目的构建系统基于 Makefile，必须使用

4. **完整的提交前检查** — build + lint + test 三项必须全部通过

示例工作流

**用户请求：** "添加一个新的配置选项来控制录制质量"

**AI 响应流程：**

1. 用中文确认："我将为您添加录制质量控制配置选项。请问您希望支持哪些质量级别？"

2. 实施修改后：

```bash

# 验证编译

make dev

```

3. 如果编译通过：

```bash

# 代码检查

make lint

# 运行测试

make test

```

4. 用中文总结："已完成配置选项添加。修改包括：[具体修改内容]。所有编译和测试已通过。"

---

使用本技能时，始终遵循"中文优先、验证优先、Make 命令优先"的三大原则。