Menu
Codex 的项目开发约束技能。涉及代码修改、代码阅读、业务上下文建立、文档编辑、查询代码逻辑、多文件实现时使用。它会约束任务启动、文档优先级、工作区与正式区的使用方式、代码变更后的文档同步，以及对外变更时的确认规则。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Codex 的设计阶段技能。需要根据 requirements 文档产出技术设计、明确实现方案、拆分关键模块、梳理依赖和风险，并把结果写入 `docs/codex/{version}/designs/` 时使用。它应与 `project-skill-convention` 配合，并在完成后回写 `status.md`。
Codex 的基础设施只读查询技能。适用于查看数据库表结构、索引、ES mapping、ES 文档、Nacos 配置，以及追踪服务依赖的中间件连接信息。当任务涉及“查配置”“查索引”“查表结构”“查数据库”“DESC”“nacos”“mapping”“文档数”等场景时优先使用，核心原则是不猜，直接查。
Codex 的业务域文档生成技能。适用于为 Java 项目初始化或补充 `docs/desc/` 业务域文档、建立领域上下文、生成技术速查和域文档骨架。当项目缺少业务域文档、需要建立知识库或需要补齐某个业务域说明时使用。
Codex 的计划阶段技能。需要根据 design 文档拆解实施步骤、确定执行顺序、验证依赖、形成可执行计划，并把结果写入 `docs/codex/{version}/plans/` 时使用。它应与 `project-skill-convention` 配合，并在完成后回写 `status.md`。
Codex 的项目入口技能。适用于进入一个项目后的大多数任务起点，包括代码修改、缺陷修复、代码阅读、需求分析、技术设计、执行计划、实现推进、闭环追踪、基础设施查询、业务文档沉淀和长任务恢复。它负责根据任务意图自动选择并串联 `dev-constraints`、`task-control`、`project-skill-convention`、`req-analysis`、`design-phase`、`plan-phase`、`req-trace`、`dev-small-tool`、`docs-desc-generation` 等技能，作为整套 Codex 项目工作流的统一入口。
Codex 的项目协作公约技能。当仓库希望让需求分析、技术设计、实现计划、实现执行、追踪审查共用一套目录、状态文件和交接规则时使用。它会定义前置检查、目录结构、状态回写规则、阶段职责和与 task-control 的联动方式。
| name | dev-constraints |
| description | Codex 的项目开发约束技能。涉及代码修改、代码阅读、业务上下文建立、文档编辑、查询代码逻辑、多文件实现时使用。它会约束任务启动、文档优先级、工作区与正式区的使用方式、代码变更后的文档同步，以及对外变更时的确认规则。 |
本技能定义项目任务在关键节点必须执行的动作。它不替代具体业务技能，也不替代实现计划，但会覆盖这些任务在上下文建立、文档处理、代码修改与验收时的默认行为。
查询类任务只需要执行“开始任务时”。不涉及文件修改时，可以不进入后续的文档同步和验收环节。
出现以下任一情况时，应同时使用 task-control 做持久化记录：
开始前先检查项目中是否已有工作区性质的未合并内容。优先检查：
.codex/docs/如果存在上次任务遗留的未合并内容，应先判断本次是否复用，而不是直接覆盖。
建立业务上下文、理解代码逻辑、准备修改代码前，优先读取文档，再读代码：
若同时存在工作区文档与正式文档，优先读取工作区版本。
如果项目既没有工作区文档，也没有正式文档，应先提示用户：
docs-desc-generation 补一版最小业务域文档只有在用户明确接受跳过时，才直接进入代码探索。
如果任务纯粹是查询基础设施信息，例如表结构、索引、配置、数据库数据、队列主题等：
dev-small-tool 直接查询dev-small-tool 查询这类任务可以不进入完整的文档→代码探索流程。
进入代码修改前，先识别本次改动是否影响以下内容：
如果改动涉及上述对外契约，而用户没有明确要求或确认，必须暂停并征求确认，不得自行决定。
代码变更完成时，如项目存在工作区文档区，应把本次行为变化同步更新到工作区文档。
工作区不存在时：
如果变更涉及新增或修改以下内容，应检查文档里是否已有对应流程说明：
若没有，应在对应文档中补齐。
若项目有 TECH-REF、技术速查、架构索引、问题定位文档等，应在以下情况同步更新：
如果项目区分工作区文档和正式文档：
只有在以下条件同时满足时，才可以直接改正式文档：
只要代码行为变更，就尽量在同一任务里完成文档同步，而不是留到以后补。
以下情况必须等待用户确认：
按任务类型自检：
如果项目存在工作区与正式区区分，不自动合并正式文档，除非用户明确要求。