DevCodex — cross-host AI coding engineering harness for Codex, Claude Code, GitHub Copilot, Gemini CLI, Grok, and Cursor
意图驱动的跨宿主 AI Coding 工程化 Harness
让 AI Coding 不只是生成代码，而是从需求开始，持续把工程任务做完。
识别意图 · 读取项目 · 调用专业 Skill · 确认边界 · 自动推进 · 执行修改 · 验证结果 · 保存进度 · 跨会话续接 · 受控进化
完整文档 · 5 分钟开始 · 跨会话续接案例 · 反馈问题
模型和宿主负责推理、写代码与执行工具；DevCodex 以任务意图为起点，负责判断要完成什么、作用于哪个项目、该读取什么、加载哪些专业能力、按什么工程流程推进，以及怎样证明真正完成。
意图驱动 · 6 个 AI Coding 宿主 · 8 条任务工作流 · 80+ 专业 Skill · 项目上下文与记忆 · Sticky Auto 自动推进 · 长任务恢复 · 跨会话续接 · 证据化完成 · 受控自我进化
npm install -g devcodex
cd <你的项目根目录>
devcodex init
devcodex status
安装或更新后保留原任务。宿主提供连接重载时，刷新 DevCodex 连接并核对当前加载版本；没有该能力时，保存检查点、继续可执行工作，方便时重载宿主。安装成功不代表已有连接已经加载新版，无需为更新另建任务。
第一个任务可以直接这样说：
分析当前项目最值得优先解决的三个问题。
先说明读取范围和证据，只分析，不修改文件。
模型越来越会写代码，但真实工程任务仍然经常失败在代码生成之外：
DevCodex 补上的，就是 AI Coding 与真实软件工程之间缺少的这一层。
| 只依赖当前 AI Coding 会话 | 加上 DevCodex |
|---|---|
| 背景主要留在聊天窗口 | 项目上下文、任务状态、报告和记忆跟随项目保存 |
| 容易拿到需求就直接编码 | 先判断目标、项目、范围、风险和是否允许修改 |
| 主要依赖模型的通用能力 | 根据任务和阶段加载对应的专业 Skill |
| 长任务中断后从头分析 | 从任务身份、检查点、确认状态和剩余项继续 |
| 大项目每轮重复读取 | 可按变化范围和影响关系做增量分析与复证 |
| “代码写完”等于“任务完成” | 测试、构建、报告、证据和剩余风险共同收口 |
| 项目经验散落在对话里 | 重复问题可形成受控进化候选和项目 Skill |
| 每个工具单独维护规则 | 六个宿主复用同一套项目工程方法 |
DevCodex 不要求用户先学习工作流名称，也不会看到某个关键词就机械套用固定 Prompt。它会先把你真正想得到的结果结构化，再让这份结构化意图驱动后面的项目识别、上下文、Skill、流程、Auto/确认、执行和验证。下游组件不能各自重新解释原始文本。
它会同时判断：
| 你的请求 | DevCodex 识别后的工程路径 |
|---|---|
| “分析测试为什么失败，不要修改” | 进入只读分析，说明读取范围、证据与未验证部分 |
| “复现并修复这个失败用例” | 进入修复流程，先复现、定位根因，再修改和回归 |
| “为支付回调增加幂等” | 进入开发流程，先明确需求、方案、范围与验收 |
| “审查当前支付链路的风险” | 进入证据审查，不默认修改文件 |
| “继续支付回调幂等任务” | 定位原任务，复核当前状态后从准确断点续接 |
| “这个设计是否合理？” | 先判断只需要分析建议，还是最终需要落地修改 |
意图不是一次性的分类标签，而是整条工程链的控制起点：
用户目标
→ 任务类型
→ 目标项目、范围与风险
→ 上下文与记忆
→ 专业 Skill
→ 工作流与确认方式
→ 验证和完成标准
当用户目标发生变化，例如从“只分析”变成“按方案实施”、从单项目扩大到整个 workspace，或临时增加提交与发布要求，DevCodex 会重新结构化意图，再统一刷新工作流、上下文、权限和验证边界。范围变化或短时凭据过期本身不会直接变成一次用户确认。
Auto 只负责在已经识别的意图和已授权范围内持续推进，不会绕过意图判断，也不会把只读分析自动变成代码修改。
flowchart LR
A[说出目标] --> B[识别任务意图]
B --> C[判断项目、范围与风险]
C --> D[读取上下文与记忆]
D --> E[加载当前专业 Skill]
E --> F[明确需求、方案与验收]
F --> G{确认或 Auto 推进}
G --> H[执行修改]
H --> I[测试、构建与检查]
I --> J[报告证据与剩余风险]
J --> K[保存任务状态与续接点]
K --> L{是否发现可复用经验}
L -- 否 --> M[任务完成]
L -- 是 --> N[生成受控进化候选]
N --> M
DevCodex 不是在开始前多塞一段 Prompt，而是持续管理任务从理解、执行到验证和交接的全过程。
DevCodex 不改变模型参数。它通过四件事提升 AI 在真实项目中的有效表现：
简单任务可以走更短路径；涉及公共契约、数据、安全、多模块或发布风险时，会自动提高复审和验证强度。是否需要确认只由当前结构化意图与动作授权决定，风险标签、复审器和验证器不能自行要求确认。流程仪式、技术方案深度与验证范围分别判断，不再用一个模糊的“简单/复杂”标签同时控制三者：当前任务中用户明确说法优先，其次才是项目配置、基于项目事实的智能识别和保守回退。入口先初判，读取项目后再二次判断，并在 PC8～PC10 写清流程/方案、验证范围与预计耗时、后续阶段和当前是否需要用户动作。
Profile 可配置 extensions.devcodex.workflowRouting.mode 为 adaptive（默认）、simple 或 standard，并用 showPlan 控制展示密度；该配置只提供流程仪式默认值，不能降低公共契约、状态恢复、package 或发布等强制义务。入口 PC0 同时显示已安装包、当前 runtime 与源码候选的版本关系，避免“版本号相同”被误报为运行内容完全一致。
产物打开按实际呈现面而不是仅按宿主名称决定。Codex Desktop 输出真实的本地文件链接；VS Code、Zed、JetBrains 可输出对应打开命令；未知或未验证界面直接给可复制绝对路径。系统只有在打开动作执行且回读成功时才会写“已打开”，renderer 选中、命令生成或链接渲染本身不冒充打开成功。
普通模式下，DevCodex 会在需求、方案和实施计划等关键节点等待确认。需要让 AI 在已授权范围内持续推进时，可以显式进入 Auto：
@devcodex-auto 完成支付回调幂等修复。
先复现和确认根因，再完成方案、修改、相关回归、报告与任务收口；
不要扩大到删除、push 或发布。
Auto 不会跳过工程流程，而是自动通过适用的流程确认，并继续执行后面的分析、实施、验证、报告和状态保存：
executionDecision=enable-auto；正式任务建立后由任务级 Auto 持续承接，不依赖短时 receipt 或会话 TTL，不需要每个阶段反复回复“继续”；正式入口是 @devcodex-auto，默认快捷别名是 @rocky。可用 退出 auto、关闭自动模式 或 切回确认模式 退出；正式任务在恢复时按任务 identity 和结构化意图续接，不能仅因新会话或短时凭据过期撤销任务级授权。
Auto 的价值不是“跳过步骤”，而是让已经明确目标和边界的任务不再被机械确认打断，同时继续保留验证、证据和安全底线。
在 Profile 的 config.json 中设置：
{
"extensions": {
"devcodex": {
"autoAliases": ["@team-auto"]
}
}
}
非空数组会替换默认快捷别名 @rocky；空数组 [] 会关闭默认快捷别名。正式入口 @devcodex-auto 不会被重命名。
DevCodex 的续接不是“读一段旧会话摘要，然后继续猜”。
对正式任务，它会持续保存可恢复的工程状态，包括：
新会话收到：
继续支付回调幂等修复任务。
会先完成以下恢复过程：
flowchart LR
A[按任务名定位原任务] --> B[读取报告、记忆与检查点]
B --> C[复核当前分支、文件和项目状态]
C --> D{旧证据仍然新鲜吗}
D -- 是 --> E[恢复原工作流与剩余步骤]
D -- 否 --> F[标记过期或冲突并重新结构化意图]
E --> G[从准确断点继续]
F --> G
恢复后仍然遵守原来的边界：原任务只读，续接后仍然只读；原任务没有 push 或发布权限，换会话后也不会自动获得。
正式任务本身不会因为等待、关机、断网、宿主退出或版本升级而过期。会短期过期的是 fenced owner——它只是防止两个会话同时写同一任务的写入租约，默认空闲租期为 5 分钟；租约过期或 accepted Stop 主动释放后，任务身份、概况、CP 确认、报告、记忆与检查点仍保留。新会话可发送 继续 <准确任务名>，DevCodex 会在服务端重新核对项目根、TaskIdentityV2、概况、CP 摘要、旧 turn/operation 状态并执行单赢家 CAS，成功后同时生成新的 admission generation 与 owner generation，无需重写任务或重复确认同一 CP。
如果旧 owner 仍有效、旧工具操作尚未收口、任务真相发生漂移、任务已经终态，或另一个会话先完成接管，恢复会失败关闭并返回可执行的 typed next step（等待租约、完成/对账旧操作、修复漂移、显式 reopen，或读取赢家），不会把“拒绝接管”误报成“任务已丢失”。
这带来几个实际结果：
跨宿主接力复用的是项目工程状态，不是无条件搬运某个宿主的完整聊天会话。Hooks、MCP、权限和自动化强度仍取决于目标宿主。
这些机制让跨会话恢复适合真正的长任务，而不是只适合短对话演示。
完整案例见跨会话续接。
Profile 可以理解为 AI 使用当前项目时的工程说明书。 它记录项目结构、技术栈、构建与测试命令、代码风格、架构边界、发布方式、功能清单和用户契约，让 AI 不必每次都从目录和 package.json 重新猜测项目规则。
devcodex init 生成的是一份有证据的 Profile 初稿和模板，不是自动完成的最终事实。初始化后应让 AI 继续读取真实源码、脚本、CI、文档、配置和发布流程，把模板补充成当前项目可依赖的工程基线；无法从项目证明的内容必须保留为 unverified，不能编造。
Profile 也不是永久正确的缓存。项目级分析和审查会把 Profile 声明与当前代码、配置和运行证据重新对账；发现漂移时，以当前可验证事实为准，并把 Profile 修订作为后续任务。
没有完整 Profile 时，DevCodex 仍可以读取当前文件并处理有限任务，但会失去可靠的项目级工程基线：status / doctor 会显示 missing 或 partial，运行模式使用更保守的 prod 默认（这里只表示保守规则模式，不代表自动部署到生产），无法确认的项目事实保持未验证，依赖构建、测试、发布或架构边界的任务可能要求补充信息、降级或停止。多项目 workspace 中，如果目标项目的 Profile 根整体缺失，会返回 PROFILE_MISSING，而不是误用另一个项目的 Profile。
DevCodex 把三类信息分开处理：
| 类型 | 解决什么问题 |
|---|---|
| 项目说明 | 项目怎样构建、测试、发布，目录、技术栈和安全边界是什么 |
| 当前上下文 | 这次任务真正需要读取哪些代码、文档、配置和证据 |
| 任务记忆 | 已确认什么、做过什么、验证过什么、还剩什么 |
在大型、多轮项目分析中，还可以把已经验证的稳定事实、文件关系和影响范围形成可复用的项目知识：
这不是“缓存一段自然语言总结”，而是带来源、范围、新鲜度和失效条件的项目认知。
意图识别不是任务开始时的一次性标签。用户补充范围、改变最终目标、切换项目，或从“只分析”改为“按方案实施”时，DevCodex 会重新判断：
这避免 AI 因为第一轮判断已经完成，就在用户目标改变后继续沿用旧流程、旧上下文或旧权限。
DevCodex 内置 80+ 专业 Skill，覆盖：
Skill 只在匹配当前任务和阶段时加载。看到仓库中存在某个 Skill，不等于它已经被全部送进模型。
项目还可以添加自己的 Skill，把业务规则、团队规范、架构约束、常见问题和验证方式变成 AI 可重复使用的工程能力。
新功能会从目标、范围、非目标和验收开始；复杂任务还会形成方案、实施顺序、验证和回滚策略。
执行过程中如果实际范围明显扩大、出现新的公共契约或高风险操作，DevCodex 会暂停并回到确认阶段，而不是把临时发现悄悄扩写成新的需求。
完成需要回答：
没运行的验证不能写成已通过；测试成功也不能自动获得提交或发布授权。
当某类问题反复出现、流程经常返工，或现有 Skill 无法覆盖时，DevCodex 可以：
重复问题 / 返工 / 新经验
↓
识别能力缺口和根因
↓
生成 Skill、规则、Prompt 或验证方案候选
↓
小范围试运行和效果验证
↓
人工审查与批准
↓
沉淀为工作区或项目能力
候选默认不会直接进入实际工作流，也不会自动覆盖当前规则或发布。只有目标明确、证据充分、目的地正确并获得授权后，才会晋级为可用能力；无效或有害的改进可以拒绝、回滚或退役。
这不是让 AI 随意修改自己，而是让经过验证的工程经验能够安全积累。
重复问题或返工证据
↓
写入 evolution/candidates 候选区
↓
判断应沉淀到 workspace、单个项目还是上游包
↓
补齐适用场景、反例、验证和回滚证据
↓
人工批准晋级
↓
生成 SKILL.md + intent.json 到活动目录
↓
用自然语言正反例测试路由，失败则修订或回退
关键边界：
SKILL.md 与 intent.json；devcodex init 只负责准备隔离目录，不会把每次对话自动转成 Skill：
.devcodex/workspace/evolution/candidates/ 候选
.devcodex/workspace/evolution/evidence/ 问题、试运行与效果证据
.devcodex/workspace/evolution/decisions/ 目标、审批与晋级决定
批准后的活动目标由复用范围决定：
| 目标 | 活动目录 | 约束 |
|---|---|---|
| workspace Skill | .devcodex/workspace/skills/<id>/ | 默认选择，同一 workspace 复用 |
| project Skill | .devcodex/<project>/skills/<id>/ | 必须有项目专属证据 |
| DevCodex 上游 Skill | content/skills/<id>/ | 必须有维护者明确授权，并重新走发布流程 |
当前公开 CLI 没有“一键把候选直接变成活动 Skill”的命令。晋级由受控 AI 工作流完成：先形成并批准目标决定，再由 workspace-skill-author 生成 SKILL.md 与 intent.json，最后执行正反例和自然语言路由验证。
可以直接这样要求：
审查当前 workspace 的进化候选，找出与支付回调重复处理相关的候选。
先判断它应该沉淀为 workspace Skill 还是项目 Skill，列出证据、适用场景、反例、验证和回滚方案。
未经我批准不要晋级；我确认后，再生成 SKILL.md 与 intent.json，并用自然语言正反例测试路由。
没有历史候选时，也可以直接创建项目自己的 Skill：
为当前 workspace 创建 payment-webhook-reliability Skill。
它用于支付回调幂等、签名校验、状态机、重复通知和补偿检查；
请同时生成适用场景、正反例和验证步骤，并用自然语言测试一次路由。
DevCodex 当前面向：
Codex · Claude Code · GitHub Copilot · Gemini CLI · Grok · Cursor
项目上下文、任务记忆、专业 Skill、确认边界、验证和报告尽量保持一致；同时根据宿主实际支持的 Hook、MCP、插件、权限和生命周期事件选择可执行路径。
缺少某种宿主能力时，DevCodex 会降级、提示或保持未验证，而不是假装六个工具完全相同。
当任务、会话、项目、上下文版本和正文身份完全一致，并且已确认正文已经送达时，DevCodex 可以复用轻量描述，避免重复传输同一大段内容。
任一身份或内容发生变化，就恢复完整读取。这样既减少无意义重复，又不会因为错误缓存让 AI 在过期上下文上继续工作。
当一个项目同时存在多个需求、问题或优化任务时，DevCodex 可以先检查：
只有写入面和汇合协议都能证明安全时才建议并行；无法证明时保持串行。它不是通用多 Agent 编排框架，但可以避免“为了并行而并行”造成的工程冲突。
分析、修改、删除、提交、切换分支、推送、Tag、Release 和发布是不同动作。
DevCodex 默认保持当前分支，不会因为普通开发任务自动创建分支、提交、推送或发布。涉及危险操作、项目外写入或清理时，需要更明确的授权和可证明的目标范围。
devcodex status
devcodex doctor --json
devcodex runtime status --json
devcodex runtime maintenance --dry-run --json
devcodex governance ledger init --apply --json
devcodex governance ledger plan --kind GR --json
状态会区分“配置存在”“适配器合同通过”“原生宿主已验证”和“端到端可用”，不会把文件存在冒充成真实能力。
普通非 dry-run 的 init / update 会零搬迁初始化治理台账 manifest 并重建派生索引，不改写现有 Markdown 台账。历史分片不会自动执行：governance ledger plan 只读预览；确认候选后使用 devcodex governance ledger apply --kind GR --plan <sha256> --json，回滚使用同一精确摘要执行 rollback。活动台账始终是唯一写入目标，archive shard 为只读历史。
| 场景 | 更合适的选择 | 原因 |
|---|---|---|
| 一次性问答、极小编辑、只依赖某个宿主特有工具 | 直接使用宿主 | 最快，不需要任务状态、报告或续接链 |
| 跨文件或跨模块开发 | DevCodex | 需要需求、方案、执行边界和验证闭环 |
| 修复问题并担心同类回归 | DevCodex | 会串联复现、根因、同类路径和定向回归 |
| 需求不完整或风险较高 | DevCodex | 先明确范围、非目标、验收和授权 |
| 长任务会跨多个会话 | DevCodex | 保存任务身份、检查点、证据和剩余项 |
| 大型项目需要多轮分析 | DevCodex | 支持分批交付、项目知识和选择性失效 |
| 需要审计、交接或留下证据 | DevCodex | 报告、验证结果和未覆盖范围可查 |
| 希望团队经验持续沉淀 | DevCodex | 可创建项目 Skill 和受控进化候选 |
DevCodex 不替代 Codex、Claude Code、Cursor 等宿主。宿主提供模型、界面和原生工具；DevCodex 提供项目层的工程工作方式。
需要 Node.js >=18.17.0 和 npm。
node -v
npm -v
npm install -g devcodex
devcodex --version
正常安装会刷新用户级宿主适配器。如果包管理器禁用了安装脚本，或后续 status 显示适配器未就绪，可执行：
devcodex global-adapters apply
cd <你的项目或 workspace 根目录>
devcodex init
devcodex status
devcodex init 会准备 .devcodex/ 运行目录、任务状态、记忆、工作区 Skill 与进化候选目录，并生成 workspace 的基础 Profile 初稿。它不会自动修改业务源码，也不会把模板中的未确认内容当成项目事实。希望先查看将要创建什么时，可以先运行 devcodex init --dry-run。
先预览项目适合的 Profile 档位，再生成需要的模板：
# 先查看当前档位、推荐档位和将要生成的文件
devcodex profile plan
# 再按项目实际选择档位；下面以常规业务项目为例
devcodex profile init --tier profile-standard
devcodex status
然后在当前项目的新会话中直接说：
完善当前项目的 DevCodex Profile。
请读取真实的 package.json、目录结构、源码、lint/test/build 脚本、CI、文档、配置和发布流程，
逐项补充项目结构、架构边界、代码风格、测试规范、发布规范和功能清单。
只写能够从项目证据证明的事实；无法确认的内容保留为 unverified，不要编造。
完成后检查 Profile 与当前代码是否一致，并运行 devcodex status 和 devcodex doctor --json。
status / doctor 主要检查 Profile 的路径、档位、必需文件和结构状态；Profile 是否真正符合业务和源码，仍以 AI 的证据化复核与用户确认结果为准。
| Profile 档位 | 适合的项目 | 主要内容 |
|---|---|---|
profile-lite | 小型项目或首次体验 | 项目信息、架构约束、代码风格和基础配置 |
profile-standard | 大多数真实业务项目 | 增加测试规范、发布规范和功能清单 |
profile-closed-loop | SDK、CLI、框架、公开 API 或文档站 | 再增加用户文档与契约规范 |
profile plan 只预览，不写文件；已有文件默认保留，升级档位只补缺失内容。--force 可能覆盖 DevCodex 管理的 Profile 文件，执行前应先查看计划与 Git diff。
多项目 workspace 可以为指定项目单独初始化：
devcodex init --profile <项目相对路径> --dry-run
devcodex init --profile <项目相对路径>
workspace Profile 作为公共基线，项目 Profile 只覆盖该项目自己的差异，不会把另一个项目的规则误用到当前项目。
发布版本、本机安装版本和当前宿主加载版本分别核验。连接重载能力由宿主提供；有可验证通道时在原任务中重载，缺少通道时保留原任务和检查点并继续可执行工作。devcodex doctor --json 在新进程成功，不等于原有 MCP 连接已切换版本。
分析当前项目最值得优先解决的三个问题。
先说明读取范围和证据，只分析，不修改文件。
你应该看到：
完整步骤见5 分钟开始。
| 位置 | 行为 |
|---|---|
| 用户 HOME | 安装或刷新 DevCodex 管理的宿主适配器与运行文件 |
| 当前项目 / workspace | 执行 devcodex init 后创建或刷新 .devcodex/ |
| 业务源码 | 安装与初始化本身不会自动修改 |
| 后台服务 | 普通使用不启动 DevCodex 自己的常驻网络服务 |
| 宿主原生配置与 Skill | 不扫描、复制、合并、覆盖或删除用户自己的资产 |
项目说明、任务状态、报告、记忆和项目 Skill 默认保存在项目目录中。模型推理、联网、认证、沙箱和数据处理仍由你选择的 AI Coding 宿主负责。
DevCodex 不代理模型请求，也不会把“项目状态保存在本地”夸张成“代码绝不会离开本机”；宿主是否上传上下文、保存聊天或使用联网工具，应以对应宿主和组织策略为准。
当前版本的
devcodex init会生成基础 Profile 初稿；它只负责建立可编辑模板和已检测事实。最终 Profile 仍应由 AI 结合真实项目补全，并由用户或团队确认。
用户不需要先学习工作流名称。说出最终目标后，DevCodex 会选择合适路径。
| 工作流 | 用途 | 默认是否修改文件 |
|---|---|---|
dev | 功能开发、重构或文档实施 | 确认后修改 |
fix | 复现、定位并修复问题 | 确认后修改 |
analyze | 只读分析与研究 | 否 |
audit | 基于证据的系统审查 | 否 |
resume | 恢复已有任务 | 继承原任务边界 |
chat | 普通交流 | 否 |
self-fix | 修复 DevCodex 自身规则或流程 | 高级入口，确认后修改 |
other | 无法安全归类时先规划 | 否 |
其中 dev、fix、analyze、audit、resume、chat 是六条主工作流；self-fix 和 other 是高级或兜底路径。
公开摘要使用 80+。当前 Skill 覆盖四类能力：
| 分类 | 主要内容 |
|---|---|
| Workflow & Routing | 任务判断、阶段、确认路径、开发、修复、分析与审查 |
| Domain & Architecture | 产品、体验、前后端、API、数据、安全、性能与系统架构 |
| Quality & Delivery | 测试、审查、文档、验证、报告、发布和交付收口 |
| Runtime & Governance | 宿主、上下文、记忆、Skill 生命周期、策略和运行治理 |
工作区 Skill 是项目级扩展，不会自动混入内置 Skill 统计，也不会在未经批准时从进化候选直接进入活动路由。
| 宿主 | 推荐入口 | 说明 |
|---|---|---|
| GitHub Copilot | Copilot CLI；VS Code / JetBrains 使用指令回退 | 不同入口能力不同 |
| Claude Code | Claude Code | 以当前直接证据支持范围为准 |
| Codex | Codex App / CLI | Hook 与 MCP 能力取决于宿主配置 |
| Gemini CLI | Gemini CLI | 适配存在，真实回放证据不足时保持未验证 |
| Grok | devcodex grok | 推荐使用 DevCodex 启动入口 |
| Cursor | 本地 IDE / CLI | 本地与 Cloud Agent 必须分别判断 |
精确兼容状态见六宿主能力边界。
| DevCodex 负责 | AI Coding 宿主负责 |
|---|---|
| 任务和项目识别、上下文、记忆与专业 Skill | 模型推理和原生 Agent 循环 |
| 确认与授权边界、验证、报告、证据和续接 | 主要工具执行、会话传输与生命周期 |
| 六宿主适配和共享工程流程 | 认证、沙箱、联网与运行环境 |
为当前项目增加 <功能>。
先整理目标、范围、非目标和验收标准，再给出方案。
我确认后再修改；完成后运行相关验证并报告剩余风险。
修复 <问题>。
先复现并定位根因，检查同类路径和回归范围。
确认方案后再修改，完成后用验证证据证明原问题已经消失。
分析当前架构最值得优先解决的三个问题。
给出代码证据、影响和优先级，只分析，不修改文件。
审查当前项目的支付回调、幂等和状态一致性。
只读，不修改文件；按风险排序并给出证据和未检查范围。
继续支付回调幂等修复任务。
先读取原任务的确认状态、报告、验证证据和剩余风险，
复核当前代码是否变化，再从准确断点继续。
深度分析当前项目，按模块分批交付结果。
保存可复用的项目知识；后续只重算变化文件、影响范围和新的分析视角。
每批都给出证据、覆盖范围和检查点。
分析最近重复出现的返工、回归和用户反馈。
找出当前 Skill 或流程缺口，生成改进候选和验证方案。
候选先不要自动生效，也不要发布。
检查下面三个任务是否可以安全并行。
列出各自允许修改的路径、共享状态、冲突风险、合并顺序和停止条件；
无法证明安全时保持串行。
@devcodex-auto 完成当前需求。
从需求与项目事实开始，自动推进适用的确认、方案、实施、验证、报告和任务状态保存；
范围扩大、验证失败或遇到高风险动作时停止并报告。
允许修改当前项目已确认范围内的文件，但不要删除、push、Tag、Release 或发布。
正式自动入口是 @devcodex-auto，默认快捷别名是 @rocky。extensions.devcodex.autoAliases 的非空数组会替换默认别名，空数组 [] 会关闭默认别名。Auto 在同一会话内持续有效；输入 退出 auto 或 切回确认模式 可退出。自动入口不会扩大删除、推送或发布权限。
不会改变模型参数、权重、上下文窗口或基础推理上限。它通过正确目标、项目上下文、专业 Skill、工作流、工具、记忆、验证和证据链，让同一个模型在真实工程中表现得更可靠。
任务进度、确认状态和验证证据必须已经写入项目。只有聊天窗口中存在、项目中没有留下状态的任务，无法可靠恢复。
可以基于同一项目中的需求、报告、任务记忆和检查点接力，但不是无条件复制完整聊天会话。目标宿主需要能够读取这些项目文件，具体 Hook、MCP 和自动执行能力仍以宿主实际支持为准。
不会把旧记录当成永久真相。续接会复核当前项目、分支、文件身份和证据新鲜度；出现冲突、过期或范围漂移时，先重新结构化意图，再由结果决定继续、停止或进入确认模式。
analyze 和默认 audit 只读；dev 与 fix 由结构化意图选择 confirm 或 Auto。Auto 自动通过适用的工程确认，正式任务授权可随任务恢复；提交、推送、Tag、GitHub Release 和 npm publish 仍需要按动作独立、明确授权。
不会用完全相同的强度处理所有任务。低风险、范围清晰的小任务可以缩短产物和验证路径；公共契约、数据、安全、多模块和发布任务会使用更严格的确认与复审。
在原任务中核对连接是否已刷新，然后运行：
devcodex status
devcodex doctor --json
devcodex global-adapters apply
不要只根据配置文件存在判断能力已经生效。状态中的 configured、adapter contract、native probe 和最终 readiness 是不同证据层。
DevCodex 普通使用不需要自己的常驻网络服务，也不代理模型请求；但真正的模型调用和数据处理由当前宿主完成。代码是否上传、聊天是否保存、联网工具是否启用，应查看宿主、账号和组织策略。
可以。工作区 Skill 可用于沉淀业务规则、架构约束、团队流程和验证方式。可以直接要求 AI 创建，也可以从进化候选经过证据、目标判断和人工批准后晋级。候选不会直接变成活动 Skill。
devcodex status --json
devcodex doctor --json
devcodex runtime status --json
完整决策树见故障排查。
先更新 npm 包和用户级宿主适配器：
npm update -g devcodex
devcodex --version
devcodex global-adapters apply
再进入正在使用的项目或 workspace，预览并刷新项目运行内容：
cd <你的项目或 workspace 根目录>
devcodex update --dry-run
devcodex update
devcodex status
devcodex update 只刷新当前 workspace 的 DevCodex 运行内容，不会自动覆盖或升级已经由团队维护的 Profile。项目事实变化时，应让 AI 单独复核并更新 Profile。
更新后保留原任务，核对当前宿主连接的实际加载版本。可用时重载该连接；能力不可用时保留检查点、继续可执行工作，方便时重载宿主后续办。
先预览 DevCodex 管理的用户级资产，再显式清理，最后卸载 npm 包：
devcodex uninstall --dry-run
devcodex uninstall --apply
npm uninstall -g devcodex
请不要先执行 npm uninstall -g devcodex，否则安全清理宿主适配器的命令也会一起消失。
普通卸载只移除能够证明由 DevCodex 管理的用户级宿主适配器和运行资产：
.devcodex/ 默认保留，因为其中可能包含 Profile、需求、问题、报告、任务记忆、检查点、工作区 Skill 和进化候选；如果确认永久放弃某个项目中的 DevCodex 数据，应先备份或审查 .devcodex/，再由用户手动删除。DevCodex 不会在全局卸载时自动清空项目历史。
DevCodex 仍在持续演进。Bug、真实使用反馈、宿主兼容问题、Skill 建议、文档改进和工程案例都欢迎通过 Issues 提交。
安全漏洞请按照仓库 Security Policy 私下报告，不要先创建公开 Issue。
本项目认可并感谢 LINUX DO 社区对开源开发者交流的支持。
FAQs
DevCodex — cross-host AI coding engineering harness for Codex, Claude Code, GitHub Copilot, Gemini CLI, Grok, and Cursor
The npm package devcodex receives a total of 172 weekly downloads. As such, devcodex popularity was classified as not popular.
We found that devcodex demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Research
/Security News
Socket uncovered two malicious VS Code themes in a GlassWorm-linked cluster with thousands of installs across VS Code Marketplace and Open VSX.
Security News
/Company News
Capital One is partnering with Socket to proactively secure its open source supply chain.
Security News
Socket CTO Ahmad Nassri discusses how to keep AI agents from bypassing package blocks, limit credential access, and monitor their actions.