devcodex-labs/devcodex

Intent-driven AI coding workflow runtime for consistent context, skills, approvals, validation, and handoffs across six AI coding hosts.

DevCodex – 意圖驅動的 AI 程式碼編排器

是什麼 – DevCodex 是一個基於 Node.js 的命令列工具，位於現有的 AI 程式碼助手（GitHub Copilot、Claude Code、Gemini CLI、Grok、Cursor 等）之上。它不取代模型，而是增加一個專案級的工程層，具備以下功能：

解析使用者意圖 – 將自然語言請求轉換為結構化任務（類型、範圍、風險、所需技能、驗證標準）。
管理專案上下文 – 讀取生成的 Profile（專案結構、建置/測試指令、架構限制等），並保留過去任務、檢查點與證據的記憶。
載入合適的「技能」 – 從內建的 80 多個領域特定能力庫中按需載入（例如 API 設計、安全審查、效能調校）。
執行受控工作流程 – 選擇多種工程化工作流程之一（開發、修復、分析、審計、恢復、聊天），並強制執行確認點、自動推進與基於證據的完成。
支援長時間執行的任務 – 在會話間持久化任務狀態，支援安全恢復，並可協調不同 AI 程式碼主機之間的協作。
基於證據的交接 – 在標記任務完成前，報告變更內容、執行的測試、剩餘風險，並可選擇產生「自我進化」候選，供未來重用。

主要功能（README 中描述）

功能	說明
意圖驅動執行	使用者只需陳述目標；DevCodex 自動決定工作流程、範圍、所需技能與驗證步驟。
跨主機支援	支援六種 AI 程式碼主機（Codex、Claude Code、Copilot、Gemini CLI、Grok、Cursor），使用統一的工程層。
80+ 專業技能	預打包的領域知識（前端、後端、安全、測試、效能、SRE 等），按需載入。
專案配置檔	為倉儲生成結構化的「工程師手冊」（技術堆疊、建置/測試指令、架構邊界、契約）。該配置檔基於證據，可隨時間優化。
自動模式	執行顯式的 `@devcodex-auto`（或別名）後，系統可無需重複確認繼續運行，但仍尊重原始意圖與安全檢查。
跨會話恢復	任務 ID、檢查點、證據與剩餘工作持久化在 `.devcodex/` 中，新會話可精確從上次中斷處恢復。
基於證據的完成	在標記任務完成前，報告修改內容、測試結果、建置結果、剩餘風險及後續步驟。
受控的自我進化	重複問題經人工批准後可轉化為可重用的技能，不會自動覆蓋現有規則。
並行任務安全分析	運行多個任務前，檢查檔案級衝突、共享狀態與合併順序。
細粒度權限模型	區分只讀分析、檔案修改、Git 提交、推送、標籤、發佈等操作，每項均需顯式授權。
CLI 工具	提供 `devcodex init`、`status`、`doctor`、`runtime`、`governance ledger` 等命令，用於檢查、維護與治理。

誰會受益？

希望 AI 協助尊重專案規範且不會在會話間遺失上下文的個人開發者。
需要可重現、可審計的 AI 生成程式碼變更，並希望將重複性工程知識封裝為可重用技能的團隊。
希望在單一、策略驅動的工作流程下整合多個 AI 程式碼工具，而無需重寫每個工具提示的組織。

成熟度與可用性

套件：已發布於 npm（devcodex），README 中顯示版本徽章。
授權：AGPL-3.0。
Node 要求：>= 18.17.0。
文件：完整文件、入門指南、範例與 API 參考位於 https://devcodex-labs.github.io/devcodex/。
狀態：積極維護中（README 提及更新流程、治理帳本與技能演進路線圖）。

快速開始（來自 README）

# 全域安裝
npm install -g devcodex

# 初始化專案（建立 .devcodex/、起始配置檔等）
cd /path/to/your/repo
devcodex init

devcodex status   # 查看目前就緒狀態

初始化後，可發出自然語言任務，例如：

分析目前專案最值得優先解決的三個問題。
先說明讀取範圍與證據，只分析，不修改檔案。

DevCodex 將：

識別意圖、專案與安全的唯讀範圍。
載入相關技能。
在不修改程式碼的前提下，產生基於證據的分析。

總結

DevCodex 是一個真正的開源專案，為現有的 AI 程式碼助手添加了強大、意圖驅動的編排層，將原始程式碼生成轉變為有紀律、可審計的軟體工程工作流程。