Roark：基于Pi SDK的GitHub Issue自动化工作流工具

Roark是围绕Pi编码智能体SDK构建的CLI工作流运行器，旨在自动化GitHub Issue到草稿Pull Request的转化过程。它以辅助开发者为设计理念，保留人类决策权，通过隔离工作空间确保实验性变更不破坏主分支，并提供可追溯的运行产物，支持多种命令以满足不同场景需求。

在软件开发中，将需求转化为代码是复杂且易出错的环节，开发者需经历理解Issue描述、规划方案、编写代码、测试及提交PR等步骤，耗时且需大量上下文切换。Roark项目应运而生，封装Pi编码智能体SDK能力，提供Issue到PR的完整自动化工作流方案。

Roark将Issue处理划分为七个阶段：获取（Fetch）、分类（Triage）、规划（Plan）、实现（Implement）、审查（Review）、修复（Fix）、就绪检查（Readiness）。其关键设计是隔离工作空间机制，每次运行创建代码库干净克隆，在克隆中执行修改，保持原始检出不受影响，支持同步变更回工作目录，确保多Issue并行处理、失败操作易回滚。

Roark提供多种核心命令：

• roark do：执行单个Issue生成草稿PR；
• roark auto：基于标签自动化处理Issue；
• roark continue：从失败点恢复运行；
• roark revise-pr：根据PR审查反馈修订PR。 所有运行产物保存在.roark/runs目录，包括上下文文件、计划文档、代码变更、审查报告、验证结果等，确保每次运行可追溯、可审计。

环境要求：Bun运行时、Git、已认证的GitHub CLI、目标仓库权限。 安装步骤：克隆仓库→安装依赖→全局安装→验证。 初始化配置：在目标仓库执行roark init生成.roark/config.json，支持自定义模型选择、温度参数、标签规则、工作空间选项等配置。

Roark明确不执行自动合并PR、关闭Issue、持续运行守护进程等操作，确保人类控制代码库。与其他工具对比：

特性	Roark	GitHub Copilot	Devin
开源	✅	❌	❌
本地运行	✅	❌	❌
Issue驱动	✅	❌	✅
产物可审查	✅	部分	✅
自动合并	❌	❌	✅
人类控制	强	中	弱

Roark适用于开源项目维护（处理重复Issue）、个人开发（快速转化想法为代码草稿）、团队审查辅助（生成初步方案）、学习探索（观察AI生成代码与审查报告）。总结：Roark是AI辅助开发的务实路径，放大开发者能力，保持控制，是值得尝试的开源方案。