核心用法
OpenTangl 通过六个步骤搭建自驱动开发循环：
1. 环境准备 — 检查 Node.js ≥18、git、GitHub CLI 及 LLM API 密钥（OpenAI/Anthropic）
2. 克隆安装 — 从 GitHub 拉取 OpenTangl 并安装依赖
3. 项目识别 — 支持三种路径：从零创建新项目（React/Vite/Next.js/Express/Serverless）、接入现有代码库、或引导用户定位项目；自动检测技术栈、包管理器、构建命令及目标分支
4. 配置生成 — 创建 projects.yaml 定义项目元数据、源码目录、验证命令；多项目可通过 environment 字段分组
5. 愿景文档 — 撰写 product-vision.md，包含人工维护的「起源与方向」和系统自动更新的「当前优先级」
6. 启动运行 — 执行 autopilot 命令，LLM 读取愿景、扫描代码、提出任务、编写代码、运行验证、创建 PR、LLM 审查、自动合并，并更新进度
显著优点
- 端到端自动化：从需求理解到代码合并的全链路闭环，减少人工介入
- 多项目协同：支持 monorepo 或多仓库场景，统一愿景驱动
- 智能任务规划：基于产品愿景动态优先级排序，平衡功能开发与技术债
- 内置质量关卡：构建验证、LLM 代码审查、冲突自动解决、失败重试机制
- 灵活 LLM 切换：OpenAI 与 Anthropic 双提供商支持，运行时可切换
潜在缺点与局限性
- 代码风险：AI 生成代码未经人工审查直接合并，可能引入隐蔽缺陷或安全漏洞
- 权限过度：需要 GitHub CLI 写权限，自动合并机制可能绕过团队 code review 流程
- 幻觉与偏离：LLM 对复杂业务逻辑的理解可能偏离原始意图，需持续校准愿景文档
- 调试困难：全自动流程中定位问题根因较复杂，日志追踪能力依赖用户手动监控
- 生态锁定：主要面向 JavaScript/TypeScript 生态，其他语言支持有限
适合人群
- 独立开发者或小型团队，希望加速原型开发和迭代
- 技术负责人希望自动化处理标准化、低风险的代码任务
- 已建立严格回滚机制和监控体系，能承担自动化风险的项目
常规风险
- 供应链安全：从 GitHub 直接克隆并执行未经验证的代码，存在恶意代码注入风险
- 密钥泄露：
.env文件管理不当可能导致 API 密钥暴露 - 代码所有权：自动提交可能产生版权或许可证合规问题
- 生产事故：自动合并未经充分测试的代码可能引发线上故障，建议仅在非关键分支或预发环境启用自动合并