AI-DLC快速上手:3条命令完成安装、配置与首个工作流
【免费下载链接】aidlc-workflowsAI-Driven Life Cycle (AI-DLC) adaptive workflow steering rules for AI coding agents项目地址: https://gitcode.com/GitHub_Trending/ai/aidlc-workflows
AI-DLC(AI-Driven Development Life Cycle)是一套面向 AI 编程代理(AI coding agent)的自适应工作流指挥规则,能把 Claude Code、Cursor、Codex CLI 等 AI 编码助手变成结构化、可审计的软件交付流程。本文面向新手,用 3 条命令带你完成 AI-DLC 工作流的安装、项目配置与首次运行,全程不需要 Node.js 或 Bun。
什么是 AI-DLC?为什么用它指挥 AI 编码代理
直接用 AI 助手写代码,项目一长大就容易丢上下文。AI-DLC 把"需求 → 决策 → 实现 → 测试 → 运维"串成一条可追溯的生命周期:
- 5 个阶段、33 个 stage,从初始化一直覆盖到运维
- 14 个智能体:11 个领域专家 + 2 个评审者 + 1 个自适应编排者
- 11 种工作流档案(scope):新功能、缺陷修复、基础设施、安全补丁、POC 等
- 人工审批门 + 98 类审计事件,每一步都有记录可查
- 一套确定性引擎,在 Claude Code、Kiro CLI/IDE、Codex CLI、Cursor、opencode、GitHub Copilot 上行为一致
核心方法论与引擎全部在 core/ 目录中手工编写,与具体宿主工具解耦;README.md 的 "Repository Layout" 一节有完整的目录说明。
第1步:一条命令安装 AI-DLC(无需 Node.js)
安装器会自动装好原生aidlc命令和全部宿主运行时(harness runtime)。
macOS / Linux / WSL:
curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.sh | shWindows PowerShell:
irm https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.ps1 | iex💡 如果装完 shell 提示找不到
aidlc,按安装器打印的 PATH 提示操作,或开一个新终端即可。
手动安装(可选):如果你更想自己管理文件,先克隆仓库:
git clone https://gitcode.com/GitHub_Trending/ai/aidlc-workflows然后安装对应的原生aidlc命令,把发布包里的runtime/<harness>/目录复制进你的项目即可。安装脚本与打包工具位于 scripts/install.sh、scripts/package.ts。
第2步:2 行命令配置项目并体检
进入你的项目根目录,按你使用的宿主工具选一个 harness 配置:
cd /path/to/your-project aidlc config --harness claude aidlc doctor常用 harness 取值一览:
| 宿主工具 | 配置值 | 打开方式 | 调用命令 |
|---|---|---|---|
| Claude Code | claude | claude | /aidlc |
| Kiro CLI | kiro | kiro-cli chat | /aidlc |
| Kiro IDE | kiro-ide | 打开项目 | /aidlc |
| Codex CLI | codex | codex | $aidlc |
| Cursor | cursor | 打开 Cursor 或agent | /aidlc |
| opencode | opencode | opencode | /aidlc |
| GitHub Copilot | copilot | Copilot CLI 或 VS Code | /aidlc |
几个实用技巧:
- 直接敲
aidlc config(不带参数)可进入交互式配置,它会自动探测已安装的 harness、模型提供商和信任状态; - 用
aidlc config --dry-run可预览将要写入的变更,不会实际修改文件; aidlc doctor是 AI-DLC 的"体检命令":它会检查运行时、项目状态、provider、hooks 和信任问题,并给出对应的修复命令。
aidlc config还会在项目中创建aidlc/工作区,首个工作流的意图记录会落在aidlc/spaces/<space>/intents/下,详见 docs/guide/01-getting-started.md 的 "What Config Creates" 小节。
第3步:启动你的第一个工作流
打开配置好的宿主工具,用一句话描述要做的事:
/aidlc Build a REST API for inventory managementAI-DLC 会做三件事:从请求中挑选工作流档案 → 追问缺失的决策 → 在审批门处停下来等你确认。Codex CLI 中前缀换成$aidlc即可。
如何选择工作流档案(scope)
不确定用哪个?可以显式指定:
/aidlc express # 最轻量路径:需求→代码→测试,仅 10/33 阶段 /aidlc feature Add customer notifications # 生产级功能,完整 33 阶段 /aidlc bugfix Fix the login timeout # 已知缺陷,9 阶段快速修复| 档案 | 适合场景 | 阶段数 |
|---|---|---|
| Express | 需求已明确,想最快出代码和测试 | 10 / 33 |
| Bugfix | 已知缺陷,聚焦修复 + 回归测试 | 9 / 33 |
| MVP | 首个产品增量,不含运维阶段 | 23 / 33 |
| Feature | 生产级功能,完整生命周期 | 33 / 33 |
| Enterprise | 受监管/高保证工作,完整可追溯 | 33 / 33 |
完整的 11 种档案对比见 docs/guide/workflow-profiles.md;每个档案对应的阶段定义位于 core/scopes/ 目录。
首次运行会看到什么
工作流启动后会自动完成初始化(创建意图记录、探测项目是 greenfield 还是 brownfield、写入状态文件),然后进入交互阶段,每个 stage 结束都有审批门。第一次运行建议选简单任务,完整注释版演练请看 docs/guide/02-your-first-workflow.md。
常见问题速查
| 症状 | 解决办法 |
|---|---|
aidlc命令找不到 | 按安装器提示修改 PATH,或新开一个终端 |
| 项目/运行时版本不一致 | 先完成当前工作流,再重新运行aidlc config |
| Codex 的 hooks 不生效 | 按 docs/guide/harnesses/codex-cli.md 信任项目 hooks |
| 刷新后插件 stage 消失 | 运行/aidlc plugin sync |
升级运行时用aidlc update(不会改动已配置的项目),之后在每个项目里跑一次aidlc doctor再aidlc config刷新。更多诊断与恢复步骤见 docs/guide/15-troubleshooting.md 和 docs/guide/12-cli-commands.md 的完整命令速查表。
延伸阅读
- docs/guide/00-introduction.md — 用户指南总入口:工作流、档案、智能体与审批门
- docs/guide/18-install-and-lifecycle.md — 版本锁定、离线安装、镜像与卸载
- docs/reference/00-overview.md — 面向贡献者的引擎与测试参考
- core/ — 智能体定义(core/agents/)、hooks(core/hooks/)与引擎工具(core/tools/)
三步走完,你的 AI 编码代理已经在一套可审计的工作流指挥之下了 🚀
【免费下载链接】aidlc-workflowsAI-Driven Life Cycle (AI-DLC) adaptive workflow steering rules for AI coding agents项目地址: https://gitcode.com/GitHub_Trending/ai/aidlc-workflows
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考