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 编码助手添加了强大、意图驱动的编排层，将原始代码生成转变为有纪律、可审计的软件工程工作流。