跳转到主要内容

open-typeless

一个手把手教程,展示如何用 Trellis 从零开始构建 macOS 语音输入应用。

Step 1: 项目初始化

1.1 创建 Electron 项目

npx create-electron-app@latest open-typeless --template=vite-typescript

cd open-typeless

# 删除 npm 生成的文件
rm -rf node_modules package-lock.json

# 创建 .npmrc (pnpm + Electron 必需)
cat > .npmrc << 'EOF'
node-linker=hoisted
shamefully-hoist=true
EOF

# 用 pnpm 重新安装
pnpm install

1.2 初始化 Trellis

trellis init
trellis init

1.3 从旧项目复制 Spec

如果有类似项目的 spec,可以复制过来:
cp -r /path/to/old-project/.trellis/spec ./

1.4 让 AI 填充 Spec

Prompt:
帮我从 electron-doc/ 里选择有用的 spec,整理到本项目的 .trellis/spec/ 里
AI 会分析并组织 spec: spec selection

Step 2: 任务规划

2.1 让 AI 规划任务

Prompt:
我打算用火山引擎 ASR BigModel API 来做这个。帮我规划一下怎么拆分任务。
AI 创建基于批次的任务计划: task planning

2.2 创建任务

AI 把任务组织成批次:
批次任务目的
Batch 1asr-infrastructure基础设施(必须先完成)
Batch 2asr-audio-recorder, asr-volcengine-client, asr-floating-window可以并行开发
Batch 3asr-integration集成(依赖 Batch 2)
tasks created

2.3 完成 Batch 1

Batch 1 完成后,验证并更新下游任务的 context: batch 1 complete

Step 3: 并行开发

3.1 启动并行 Agent

Prompt: /trellis:parallel AI 启动 3 个 worktree agent 开发 Batch 2,每个 agent 在隔离的 git worktree 中工作: parallel agents

Step 4: 监控进度

4.1 查看 Agent 状态

AI 监控 agent 状态和任务进度: agent status

4.2 记录 Session

并行 agent 完成后会自动创建 PR: parallel PRs 合并并完成批次后,记录 session: Prompt: /trellis:record-session record session

Step 5: 继续开发

5.1 查看剩余任务

AI 显示当前项目的剩余任务: task list

5.2 实现下一个功能

选择下一个任务,AI 用 implement agent 然后 check agent: implement and check

5.3 配置和测试

AI 帮助完成剩余设置(环境配置、权限): final setup

总结

用 Trellis 构建 open-typeless:
步骤做什么Trellis 功能
1初始化项目trellis init,spec 组织
2规划任务AI 任务拆分,批次规划
3并行开发/trellis:parallel,worktree agents
4监控和记录/trellis:record-session
5继续迭代Task hooks,implement/check agents
结果: 1 天完成完整 Electron 应用,有结构化的 spec 和文档化的进度。