메뉴
Codex 的项目开发约束技能。涉及代码修改、代码阅读、业务上下文建立、文档编辑、查询代码逻辑、多文件实现时使用。它会约束任务启动、文档优先级、工作区与正式区的使用方式、代码变更后的文档同步，以及对外变更时的确认规则。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
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、技术速查、架构索引、问题定位文档等，应在以下情况同步更新：
如果项目区分工作区文档和正式文档：
只有在以下条件同时满足时，才可以直接改正式文档：
只要代码行为变更，就尽量在同一任务里完成文档同步，而不是留到以后补。
以下情况必须等待用户确认：
按任务类型自检：
如果项目存在工作区与正式区区分，不自动合并正式文档，除非用户明确要求。