awslabs/aidlc-workflows

AI-Driven Life Cycle (AI-DLC) adaptive workflow steering rules for AI coding agents

AI‑DLC Workflows (awslabs/aidlc‑workflows)

是什麼 – AI‑DLC（AI驅動開發生命週期）是一組規則，可將生成式AI程式碼助手（Kiro、Amazon Q、Cursor、Cline、Claude Code、GitHub Copilot、OpenAI Codex等）轉換為結構化、自我修正的軟體開發工作流程。該倉儲提供一個zip檔案（ai‑dlc‑rules‑vX.zip），包含兩個資料夾：

aws-aidlc-rules/ – 核心工作流程定義（主要是支援的IDE/代理讀取為「規則」或「指示」的Markdown檔案）。
aws-aidlc-rule-details/ – 核心規則所參考的補充細節檔案。

將這些資料夾複製到您所選AI程式碼工具所需的隱藏設定目錄後，該工具將自動在每次程式碼會話中套用AI‑DLC工作流程。工作流程描述了一個三階段適應式流程（啟動 → 建構 → 運營），旨在維持高程式碼品質、強制執行標準，並讓開發者在AI承擔繁重工作之時仍保有控制權。

快速入門（通用步驟）

下載 – 從 Releases 頁面下載最新版本的發行版zip檔案。
解壓 – 在專案外部解壓（例如：~/Downloads）。
複製 – 將兩個子資料夾複製到您IDE/代理所需的隱藏設定目錄中（參見下方平台特定部分）。
驗證 – 確認規則在IDE的UI中顯示（每個工具均提供螢幕截圖）。
編碼 – 正常編碼即可——AI助手現在將遵循AI‑DLC指示，引導您完成三階段工作流程，並提供自我修正建議。

支援的平台（設定程式碼片段）

平台	規則存放位置	例子命令（macOS/Linux）
Kiro	`.kiro/steering/`（核心）和 `.kiro/`（細節）	`cp -R ~/Downloads/aidlc-rules/aws-aidlc-rules .kiro/steering/`
Amazon Q	`.amazonq/rules/`（核心）和 `.amazonq/`（細節）	`cp -R ~/Downloads/aidlc-rules/aws-aidlc-rules .amazonq/rules/`
Cursor	`.cursor/rules/ai-dlc-workflow.mdc`（或 `AGENTS.md`）	`cat > .cursor/rules/ai-dlc-workflow.mdc <<'EOF' … EOF`
Cline	`.clinerules/`（核心）和 `.aidlc-rule-details/`（細節）	`cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md .clinerules/`
Claude Code	專案根目錄的 `CLAUDE.md`（或 `.claude/CLAUDE.md`）	`cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md ./CLAUDE.md`
GitHub Copilot	`.github/copilot-instructions.md`	`cp ~/Downloads/aidlc-rules/aws-aidlc-rules/core-workflow.md .github/copilot-instructions.md`
OpenAI Codex	（與Copilot類似——使用`AGENTS.md`或自訂指示檔案）	see README

每個平台部分還包含Windows PowerShell/CMD等效命令。

核心概念

三階段適應式工作流程 – inception、construction、operations。規則引導AI助手經過這些階段，並根據專案背景和開發者回饋自動適應。
自我修正 – 工作流程包含驗證步驟，允許AI提出修復建議，並在提交變更前請求確認。
可擴展 – 可將額外規則集放入 aws-aidlc-rule-details/ 目錄中，以針對特定領域或合規要求自訂行為。
工具無關 – 由於規則是純Markdown（或簡單設定檔），同一工作流程可跨多種主流AI程式碼助手使用。

前提條件

已安裝並設定支援的AI程式碼助手（Kiro、Amazon Q、Cursor、Cline、Claude Code、GitHub Copilot或OpenAI Codex）。
能夠執行shell命令（或在Windows上使用PowerShell/CMD）將規則檔案複製到隱藏設定目錄中。
可選：熟悉AI‑DLC方法論——詳見連結的部落格文章和PDF規格以取得更深入背景。

使用方法

安裝助手（例如：新增Amazon Q VS Code擴充）。
放置規則檔案 – 按照您工具的說明放置檔案。
在IDE中開啟專案。助手將自動載入 core‑workflow.md（或等效檔案）並開始提供指導。
互動 – 助手可能要求您確認步驟、切換模式或解決建議的修正。遵循提示；工作流程將追蹤進度。
審查 – 由於生成式AI可能出錯，README提醒您審查所有AI生成的程式碼並監控使用成本。

擴展工作流程

在 aws-aidlc-rule-details/ 下新增Markdown檔案（例如：extensions/用於自訂政策）。
更新核心 core-workflow.md 以引用新檔案。
下次IDE載入規則時，擴展將生效。

支援工具與資源

規格PDF – AI‑DLC 2.0工作流程的詳細正式描述。
部落格文章 – 方法論的高階概述。
方法定義論文 – 基礎概念的學術風格闡述。
故障排除 – README中的常見設定陷阱部分。
版本控制建議 – 如何將AI‑DLC與Git工作流程整合的建議。

許可與貢獻

本專案採用Apache‑2.0許可證（參見LICENSE檔案）。
歡迎透過拉取請求貢獻；詳見Contributing部分的指南。

TL;DR

AI‑DLC Workflows 提供一套即用型規則檔案，可將任何主流生成式AI程式碼助手轉換為嚴謹、可驗證的軟體開發流程。安裝您偏好的助手，將規則檔案複製到工具的隱藏設定資料夾中，讓AI引導您完成自適應的三階段工作流程，同時您始終保有對每個變更的最終控制權。