项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- macOS、Linux 或 WSL 环境,或 Windows 的 PowerShell
- Windows 上需在普通(非管理员)PowerShell 窗口执行安装
- 原生安装无需预装 Bun 或 Node.js
- 仅当采用「手动复制」方式时才需要自行安装 Bun
安装与启动步骤
-
1安装(macOS/Linux/WSL)
在终端执行官方安装脚本,它会同时装好原生 aidlc 命令与各 harness 运行时,无需预先安装 Bun 或 Node.js。
curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.sh | sh -
2安装(Windows)
在普通 PowerShell 窗口中执行;若用「以管理员身份运行」打开的窗口会收到警告与提示,因为管理员安装安全性较低。
irm https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.ps1 | iex -
3让 PATH 生效
若当前会话找不到 aidlc,新开一个终端即可;macOS/Linux/WSL 上按安装器输出的 PATH 提示操作(Windows 会自动为当前账户写入 User PATH)。
-
4可选:安装 Bun
只有选择「手动复制」路径才需要 Bun(原生安装是唯一不需要 Bun 的地方)。访问 https://bun.sh/ 按官网说明安装。
-
5可选:复制运行时
从 latest release 下载 aidlc-copy-runtime-X.Y.Z.tar.gz,把完整的 runtime/
/ 目录复制进你的项目;这条路径不需要原生 aidlc 命令。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
-NoModifyPath | 否 | Windows 安装参数,跳过持久化与当前进程的 PATH 修改 | -NoModifyPath |
如何确认成功
新开一个终端后,aidlc 命令能被识别调用,说明安装与 PATH 配置成功。
常见问题
Q:终端提示找不到 aidlc 怎么办?
A:先新开一个终端让 PATH 生效;macOS/Linux/WSL 上按安装器给出的 PATH 提示配置,Windows 会自动注册 User PATH。
Q:需要自己安装 Bun 或 Node.js 吗?
A:不需要。原生安装通过 aidlc 运行 hooks 和命令,不会调用 bun;只有在使用手动复制路径时才需要安装 Bun。
Q:Windows 上应该用管理员 PowerShell 安装吗?
A:不建议。请在普通 PowerShell 窗口运行,管理员方式会弹出警告和提示,因为以管理员身份安装安全性更低。
Q:如何跳过 Windows 的 PATH 修改?
A:在执行安装脚本时加上 -NoModifyPath 参数,即可同时跳过持久化和当前进程的 PATH 改动。
注意事项
- Windows 安装针对当前账户,并自动把 bin 目录加入 User PATH;卸载时只移除安装器标记为自己写入的那条 PATH 记录。
- 原生安装会一次性安装 aidlc 命令与全部 harness 运行时,可运行在 Claude Code、Kiro CLI、Kiro IDE、Codex CLI、Cursor、opencode、GitHub Copilot 等代理上。
- 手动复制路径是唯一需要 Bun 的方式,且无需原生 aidlc 命令,适合想自行管理项目文件的用户。
- README 未提供除安装脚本以外的启动/运行命令,具体工作流用法请参考官方文档与官网。
核心亮点
- 把需求到交付拆成可配置阶段,代理不再一上来就写代码
- 规则与流程解耦,可按项目或任务类型替换 steering rules
- TypeScript 实现,便于集成到现有 AI 编码工具链并二次开发
不足之处
- 规则体系偏重,简单小任务可能显得流程冗余
- 实际效果高度依赖底层代理能力,缺少统一评测基准
适用场景
- 用 Claude Code 开发新功能时强制先澄清需求再动手
- 团队统一 AI 编码规范,把评审与测试环节固化进流程
- 重构或修 bug 时按任务类型自动切换更轻量的工作流
替代项目
BMAD-METHOD、spec-kit
上一篇:opensre
同类项目推荐
n8n
开源
拖拽搭建自动化流程,轻松接入 AI 与 400+ 应用,搞定重复工作。
Fair-code workflow automation platform with native AI capabilities. Combine visual b···
EasyCLIProxyAPI
开源
图形界面一键配好 AI 代理,省去手写配置文件
A desktop GUI for CLIProxyAPI and a tool for automatically configuring popular AI ag···
feishu-docx
开源
让 AI 代理轻松读写飞书文档,双向转换 Markdown
Feishu/Lark Docs、Sheet、Bitable <-> Markdown | AI Agent-friendly knowledge base exp···
puppeteer
开源
用 JavaScript 轻松操控无头浏览器,搞定自动化测试与网页抓取。
JavaScript API for Chrome and Firefox
