AI Dev Pipeline v3

English

aipipe 是一个可全局安装的 CLI。它能把开发者与审查者相互独立的工作流接入 现有项目，也能在之后将其干净地移除。

使用前需要准备 Node.js 22+、Git；执行远程操作时还需要 GitHub CLI（gh）。

# 安装已发布的 CLI
npm install --global aipipe-cli

# 本地开发时，也可以直接从当前检出目录安装
npm install --global .

cd /path/to/project
aipipe init
aipipe doctor

接入后，目标项目只会增加一个带命名空间的 .aipipe/ 适配器、一份带命名空间的 GitHub 工作流、两份带命名空间的 Issue 模板，以及 AGENTS.md 中一个带边界标记的 区块。CLI 的源代码、依赖、凭据和私有状态都不会被复制到目标项目。

aipipe status
aipipe eject

正常完成一次接入和移除后，eject 之后的本地文件系统会与 init 之前逐字节一致。 如果托管文件被修改，CLI 默认会中止移除；只有明确使用 --force 才会丢弃这些修改。 如果曾创建 GitHub 资源，正常移除时也只会删除状态文件中记录为由本 CLI 创建的标签 和规则集。

为什么使用 Node.js 22，而不是 Python

v3 使用纯 Node.js ESM，没有运行时依赖，也不需要构建步骤。

• npm 提供了可预期、跨平台的全局命令安装和升级方式；
• Node 自带本 CLI 所需的文件系统、进程、加密、JSON 和测试能力；
• 无需处理 Python 虚拟环境、pipx 或不同平台的包名差异，产品团队首次使用更简单；
• Node 22 是有意选择的最低版本：它是一条成熟的 LTS 版本线，而 Node 18 和 Node 20 已停止维护。CI 同时测试 Node 22 和 24；v3 不要求最新的 Current 版本。

如果工具以服务端或数据处理为主，Python 会是合理选择；但对于全局安装的项目适配器， Python 在 macOS、Windows 和 Linux 上的环境与入口点体验不够一致。项目也评估过 Go， 但编译产物矩阵和签名流水线会增加运维负担，却不能改善这套面向 GitHub 的工作流。

核心命令

# 只执行可逆的本地接入
aipipe init /path/to/project

# 同时创建缺失的状态标签和 aipipe-v3 规则集
aipipe init /path/to/project --github --repo owner/repository

# 从覆盖目录初始化项目提示词和设计模板
aipipe init /path/to/project --template-dir ./team-aipipe-templates

# 配置账号隔离（令牌仍由 gh 或环境变量管理）
aipipe config set accounts.developer owner-dev-bot
aipipe config set accounts.reviewer owner-reviewer-bot

# 设置用户级默认值，再按项目覆盖或恢复继承
aipipe config set parallel.maxDevelopers 4 --global
aipipe config set parallel.maxDevelopers 2
aipipe config unset parallel.maxDevelopers

# 推动任务通过状态机
aipipe task list --state todo
aipipe task claim 42 --agent dev-1
aipipe task handoff 42 --pr 77 --reviewer reviewer-1
aipipe task verdict 42 --pr 77 --agent reviewer-1 --approve
aipipe task merge 42 --pr 77

# 检查或移除
aipipe status --json
aipipe doctor
aipipe eject

配置会依次深度合并内置层、用户层、项目层和可选的运行时层。提示词和设计模板可以从 用户目录或显式指定的目录初始化，然后在各项目中继续编辑；安全关键的策略文件始终不 允许覆盖。详细信息请参阅配置与模板覆盖、 架构、命令参考、 npm 发布和迁移说明。 测试指南说明兼容性矩阵和已安装包的端到端验证。

开发与验证

npm run check
npm test
npm pack --dry-run
npm run test:installed

项目没有生产依赖或开发依赖，测试使用 Node 内置的测试运行器。