核心用法
OpenTangl 是一个面向 JavaScript/TypeScript 项目的自主开发代理。用户只需提供产品愿景文档，系统即可自动完成：
1. 任务规划：读取愿景文档，扫描代码库，提出符合优先级的工作项
2. 代码生成：根据任务编写代码并运行验证命令（build/test/lint）
3. 版本管理：创建分支、提交更改、推送至 GitHub
4. 代码审查：调用 LLM 自动评审 PR，标记潜在问题
5. 合并发布：验证通过后自动合并到目标分支
支持单仓库和多仓库（monorepo）场景，通过 projects.yaml 配置项目元数据，通过 product-vision.md 定义方向与优先级。运行时可通过 --cycles 控制迭代次数，--feature-ratio 调整功能/维护比例。
显著优点
- 端到端自动化：覆盖从需求到合并的完整开发流程，真正实现 "ship code without writing it"
- 多项目协调：通过
environment字段将多个仓库视为统一产品管理 - 安全设计：破坏性操作（推送、合并）强制用户确认，支持隔离环境运行
- 灵活配置：支持 OpenAI/Anthropic 双模型切换，验证命令可自定义
- 持续演进：每次运行后自动更新愿景文档中的优先级状态
潜在缺点与局限性
- 仅限 JS/TS 生态：不支持 Python、Go 等其他语言的项目
- GitHub 依赖：PR/合并流程深度绑定 GitHub CLI，不支持 GitLab、Bitbucket
- 成本不可控：LLM 调用频繁（代码生成+审查+任务规划），大项目可能产生高额 API 费用
- 质量风险：自动生成代码的架构合理性、边界 case 覆盖依赖模型能力，仍需人工最终把关
- 确认步骤繁琐：安全设计导致每一步破坏性操作都需确认，降低 "全自动" 体验
适合人群
- 需要快速迭代 MVP 的独立开发者或小型团队
- 拥有清晰产品愿景但人力有限的初创公司
- 希望将重复性编码工作自动化的技术负责人
- 愿意承担 API 成本以换取开发速度的场景
不适合：对代码质量有极高合规要求（金融、医疗）的场景，或无法承担 LLM 调用成本的大型项目。
常规风险
- 密钥泄露风险：需配置
OPENAI_API_KEY或ANTHROPIC_API_KEY，若.gitignore配置不当可能意外提交 - 仓库污染风险：自动创建的分支、PR 若无人清理会堆积；建议配合机器账号和窄权限 token
- 构建副作用：
npm install可能执行生命周期脚本，隔离环境（容器/VM）是必需非建议 - 模型幻觉风险：LLM 可能误解代码意图或生成无效修复，导致循环失败或引入 bug
- 费用失控风险：未设置用量上限的 API key 可能在长周期运行中产生意外账单