DevCodex 是面向 AI 编程宿主的工作流运行时和宿主适配包。它通过一个 npm 全局包，把上下文、记忆、80+ 内置 Skill、报告与验证闭环接入 Codex、Claude Code、GitHub Copilot、Gemini CLI 和 Grok，让不同宿主在同一个项目里按更一致的开发流程协作。

如果你经常遇到 AI 新会话忘记项目背景、长任务中途断线、不同宿主规则不一致、修复过程没有记录、验证结果说不清这些问题，DevCodex 的目标就是把“随口聊天式开发”变成有上下文、有流程、有记录、可继续的 AI 编程协作。

npm install -g devcodex
devcodex --version

安装或更新后，重新打开宿主的新会话即可开始使用。

DevCodex 不替代业务框架、GitHub CI、安全审计或人工评审。它也不接管 Codex、Claude Code 等宿主原有的个人 Skill、项目指令或配置文件。

为什么需要 DevCodex？

AI 编程真正难的通常不是让模型写一段代码，而是让它在真实项目里稳定完成一个任务：

新会话不知道项目结构、约定、历史决策和当前进度。
长任务容易断在一半，下一轮很难准确接上。
Codex、Claude Code、GitHub Copilot、Gemini CLI 和 Grok 各有自己的配置和能力，项目规则很容易分散。
只有 prompt 或零散 Skill 时，缺少从需求、实现、验证到报告的闭环。
项目自己的流程、检查清单和团队约定很难跨宿主复用。

DevCodex 把这些能力组合成一个本地工作流入口：先理解当前任务，再按需读取上下文和记忆，选择合适的 Skill 与工作流，最后把关键过程、验证和结果沉淀下来。

DevCodex 解决什么问题？

问题	DevCodex 怎么处理	用户得到什么
每次都要重新解释项目背景	按任务意图读取必要的项目上下文、历史记忆和相关源码	少重复说明，AI 更快进入有效状态
长任务和新会话容易断	把任务过程写入报告和文件记忆	后续会话可以围绕真实记录继续
多个 AI 宿主规则不一致	一个 npm 包刷新五个宿主的用户级适配	切换宿主时保留同一套工作流习惯
只有 prompt，没有执行闭环	开发、修复、分析、审计等任务都有过程、边界和验证记录	更容易复盘，也更容易发现“假完成”
项目私有流程难复用	支持在项目里添加工作区 Skill	你的流程、检查清单和团队约定可被五宿主共享

核心特色

特色	说明
五宿主一个入口	支持 Codex、Claude Code、GitHub Copilot、Gemini CLI 和 Grok。不同宿主的 Hook、指令和插件能力不完全相同；DevCodex 会按宿主能力使用可用执行方式。
上下文按需进入会话	不把所有资料一股脑塞给 AI，而是根据当前任务选择必要的项目资料、记忆和源码线索。
文件记忆与长任务恢复	将关键过程写入当前项目的报告和记忆，减少“上一轮做到哪了”的断层。
80+ 内置 Skill	覆盖开发、修复、审计、发布、文档、架构、质量、安全、SRE、平台生态、产品与体验等专业场景。
报告与验证闭环	任务结束时沉淀结果、验证命令和剩余风险，让交付不是只靠一句“完成了”。
工作区 Skill	用户可以在项目下添加自己的 Skill，让项目流程跨五宿主复用。
本地优先	安装包刷新本地用户级宿主适配；普通使用不需要启动额外后台服务。
原生资产共存	DevCodex 不扫描、复制、合并、覆盖或删除这些用户资产。宿主自己的 Skill、项目指令和个人配置继续按原宿主规则生效。

它如何工作？

你仍然在熟悉的宿主里用自然语言发起请求。DevCodex 在新会话中按用户请求的意图进入开发、修复、分析、审计等流程，并按需加载内置 Skill 或工作区 Skill。

用户请求
  → 判断任务意图
  → 读取必要上下文和记忆
  → 加载匹配的内置 Skill 或工作区 Skill
  → 执行开发 / 修复 / 分析 / 审计等流程
  → 输出结果、验证和报告
  → 写入记忆，方便后续会话继续

这里描述的是用户能感知的流程；不同宿主底层能力不同，DevCodex 会按当前宿主可用能力执行或回退。

适合谁？

同时使用 Codex、Claude Code、GitHub Copilot、Gemini CLI 或 Grok 的开发者。
经常让 AI 处理跨文件、跨轮次、需要验证的开发任务的人。
希望项目约定、检查清单、发布流程或团队规则能被 AI 稳定遵守的人。
想把自己的项目流程沉淀成可复用工作区 Skill 的用户。

5 分钟开始

系统要求

Node.js >=18
npm
至少一个受支持的 AI 编程宿主：Codex、Claude Code、GitHub Copilot、Gemini CLI 或 Grok

安装 Node.js

先确认本机是否已有 Node.js 和 npm：

node -v
npm -v

如果命令不存在，安装 Node.js LTS：

Windows / macOS：从 Node.js 官方下载页安装 LTS 版本。
macOS / Linux：也可以使用 nvm、fnm、asdf 等版本管理器安装 LTS 版本。

安装后重新打开终端，再确认：

node -v
npm -v

如果 Node.js 版本低于 18，请先升级 Node.js。

安装 DevCodex

npm 模块名称是 devcodex，不带组织 scope。

安装前建议确认 npm registry 上的版本与本文档对应；如果 registry 上的版本不是当前文档对应版本，不要把下面命令当作当前版本安装。

npm install -g devcodex
devcodex --version

安装完成后，重新打开 Codex、Claude Code、GitHub Copilot、Gemini CLI 或 Grok 的新会话。

第一次怎么用

在新的宿主会话里，直接用自然语言发起任务即可，例如：

分析当前项目，告诉我最应该先改进的三个问题。

阅读这个仓库，帮我修复当前失败的 GitHub CI。

DevCodex 会按任务意图选择流程和 Skill。普通使用者不需要手动配置内置 Skill。

自动推进：`@rocky`

如果你希望 DevCodex 在明确任务范围内自动继续执行，可以在请求里带上 @rocky：

@rocky 阅读当前项目，修复失败的 CI，完成后提交。

@rocky 是全局默认 @rocky 自动推进别名。进入自动推进后，DevCodex 会在当前会话里尽量连续完成需求、实现、验证、报告等步骤；如果你想退出，直接说“退出 auto”或“exit auto mode”即可。

自动推进不等于无限授权：删除文件、不可逆操作、越过项目范围、需要外部确认的发布动作等仍会遵守 DevCodex 的安全边界。当前只有 Hook 支持且白名单路径提供 runtime 级硬保证；在只依赖指令回退的宿主中，DevCodex 会尽量按语义继续推进，但不承诺完全等价的自动放行。

如果你想改成自己的别名，在项目根目录创建或修改：

<你的项目根目录>/.devcodex/workspace/profile/config.json

示例：

{
  "extensions": {
    "devcodex": {
      "autoAliases": ["@team-auto"]
    }
  }
}

extensions.devcodex.autoAliases 用于替换全局默认别名；省略该字段表示继续使用默认 @rocky，设置为空数组 [] 表示关闭默认自动推进别名。

更新

npm update -g devcodex
devcodex --version

更新完成后，重新打开宿主的新会话。

卸载

npm uninstall -g devcodex

生效方式

安装或更新 DevCodex 后，npm 会在安装生命周期中刷新用户级宿主适配。已打开的宿主会话通常不会回读刚更新的配置，因此需要重新打开一个新会话。

DevCodex 内置 Skill 随安装包一起提供。普通使用者不需要手动配置内置 Skill；新会话开始后，DevCodex 会按请求意图自动选择需要的 Skill。

添加自己的 Skill

如果你希望为某个项目增加自己的流程、检查清单或团队约定，在这个项目根目录下创建工作区 Skill。

这里的“项目根目录”就是你用 Codex、Claude Code、GitHub Copilot、Gemini CLI 或 Grok 打开的业务项目目录。

<你的项目根目录>/
  .devcodex/
    workspace/
      skills/
        <id>/
          SKILL.md
          intent.json

例如：

my-app/
  .devcodex/
    workspace/
      skills/
        release-check/
          SKILL.md
          intent.json

SKILL.md：

---
name: release-check
description: >
  当用户准备发布版本、检查 changelog、tag、npm publish 或 GitHub release 时使用。
---
# release-check

## 步骤
1. 检查版本号、变更记录和发布分支。
2. 运行项目约定的测试与打包命令。
3. 输出发布前风险和下一步。

intent.json：

{
  "schemaVersion": "SkillIntentV1",
  "skillId": "release-check",
  "intents": [
    {
      "id": "release",
      "label": "发布检查",
      "include": ["发布", "release", "tag", "npm"]
    }
  ],
  "examples": {
    "positive": ["帮我发版前检查", "准备 npm publish"],
    "negative": ["修复登录 bug", "解释这个函数"]
  },
  "summary": "发布前检查版本、changelog、tag、测试、打包和发布风险。"
}

新建或修改后，重新打开会话，或在后续请求中自然触发相关意图。

与宿主原生 Skill 共存

Codex、Claude Code 等宿主自己的项目指令、个人 Skill 和配置文件继续按宿主原有规则生效。

DevCodex 不扫描、复制、合并、覆盖或删除这些用户资产。即使名称相同，宿主原生 Skill 也不视为 DevCodex 所有。

如果希望五个宿主通过 DevCodex 使用同一套能力，写 DevCodex 工作区 Skill：

<你的项目根目录>/.devcodex/workspace/skills/<id>/SKILL.md

如果只希望某个宿主单独使用，继续使用该宿主自己的 Skill 或指令机制。

边界

DevCodex 不替代业务框架、GitHub CI、安全审计或人工评审。
不同宿主的 Hook、指令和插件能力不同；同一工作流在不同宿主中的强制能力可能不同。
DevCodex 不接管宿主原生 Skill、个人配置或项目指令文件。
工作区 Skill 只影响创建它的项目目录。

许可证

AGPL-3.0

Keywords

FAQs

What is devcodex?

Is devcodex popular?

Is devcodex well maintained?

Package last updated on 31 Jul 2026

devcodex

DevCodex

目录