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？
- DevCodex 解决什么问题？
- 核心特色
- 它如何工作？
- 适合谁？
- 5 分钟开始
- 更新
- 卸载
- 生效方式
- 添加自己的 Skill
- 与宿主原生 Skill 共存
- 边界
- 许可证
AI 编程真正难的通常不是让模型写一段代码，而是让它在真实项目里稳定完成一个任务：
- 新会话不知道项目结构、约定、历史决策和当前进度。
- 长任务容易断在一半，下一轮很难准确接上。
- Codex、Claude Code、GitHub Copilot、Gemini CLI 和 Grok 各有自己的配置和能力，项目规则很容易分散。
- 只有 prompt 或零散 Skill 时，缺少从需求、实现、验证到报告的闭环。
- 项目自己的流程、检查清单和团队约定很难跨宿主复用。
DevCodex 把这些能力组合成一个本地工作流入口：先理解当前任务，再按需读取上下文和记忆，选择合适的 Skill 与工作流，最后把关键过程、验证和结果沉淀下来。
| 问题 | 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 的用户。
- Node.js
>=18 - npm
- 至少一个受支持的 AI 编程宿主：Codex、Claude Code、GitHub Copilot、Gemini CLI 或 Grok
先确认本机是否已有 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。
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。
如果你希望 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。
这里的“项目根目录”就是你用 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、测试、打包和发布风险。"
}新建或修改后，重新打开会话，或在后续请求中自然触发相关意图。
Codex、Claude Code 等宿主自己的项目指令、个人 Skill 和配置文件继续按宿主原有规则生效。
DevCodex 不扫描、复制、合并、覆盖或删除这些用户资产。即使名称相同，宿主原生 Skill 也不视为 DevCodex 所有。
如果希望五个宿主通过 DevCodex 使用同一套能力，写 DevCodex 工作区 Skill：
<你的项目根目录>/.devcodex/workspace/skills/<id>/SKILL.md
如果只希望某个宿主单独使用，继续使用该宿主自己的 Skill 或指令机制。
- DevCodex 不替代业务框架、GitHub CI、安全审计或人工评审。
- 不同宿主的 Hook、指令和插件能力不同；同一工作流在不同宿主中的强制能力可能不同。
- DevCodex 不接管宿主原生 Skill、个人配置或项目指令文件。
- 工作区 Skill 只影响创建它的项目目录。