القائمة
Codex 的业务域文档生成技能。适用于为 Java 项目初始化或补充 `docs/desc/` 业务域文档、建立领域上下文、生成技术速查和域文档骨架。当项目缺少业务域文档、需要建立知识库或需要补齐某个业务域说明时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | docs-desc-generation |
| description | Codex 的业务域文档生成技能。适用于为 Java 项目初始化或补充 `docs/desc/` 业务域文档、建立领域上下文、生成技术速查和域文档骨架。当项目缺少业务域文档、需要建立知识库或需要补齐某个业务域说明时使用。 |
本技能负责生成和补充项目的业务域文档体系。它和 docs/codex/{version}/ 的需求/设计/计划/追踪文档不是一回事：
docs/desc/：长期业务上下文与领域知识库docs/codex/{version}/：某轮需求交付的阶段产物执行前先完成：
.gitignore 是否包含 .codex/task-control 规则注册本任务使用 Codex 版工作区：
.codex/desc-work/{branch}/docs/desc/最终正式产物：
| 文件 | 用途 |
|---|---|
docs/desc/README.md | 业务域索引、系统概览、阅读建议 |
docs/desc/TECH-REF.md | 技术速查、问题定位、关键入口 |
docs/desc/{domain}/{domain}-domain.md | 各业务域详细文档 |
阶段0：骨架建立
-> 工作区 README + TECH-REF
阶段1：逐域深入
-> 各域 domain 文档
阶段2：跨域补全
-> 业务域关系图 + 核心数据流
阶段3：全局优化
-> 统一术语、去重、补缺
阶段4：准确性抽查
-> 核心声明与代码交叉验证
验收
-> 确认是否整理进正式区 docs/desc/
输出：
README.mdTECH-REF.md至少完成：
工作区建议路径：
.codex/desc-work/{branch}/README.md
.codex/desc-work/{branch}/TECH-REF.md
对每个业务域输出：
.codex/desc-work/{branch}/{domain}/{domain}-domain.md
每个域至少包含：
补充数据模型时，优先使用 dev-small-tool 查询真实表结构、索引和字段信息，不凭记忆猜测表名。
基于各域文档补充：
整体阅读工作区文档，统一：
至少抽查 1 到 2 个核心域：
发现问题时，先修复，再决定是否扩大抽查范围。
dev-constraints：当项目缺少业务域文档时，dev-constraints 可引导进入本技能dev-small-tool：查询真实表结构、索引、配置时优先使用它task-control：多阶段文档生成任务必须注册project-entry：本技能可作为项目初始化或上下文补齐任务的一条分支能力至少检查：
-domain.md本技能默认只生成工作区版本，不自动覆盖正式区。
如果用户明确要求整理到正式区，可按以下方式处理：
.codex/desc-work/{branch}/docs/desc/创建文档时，优先参考 templates.md。
Codex 的设计阶段技能。需要根据 requirements 文档产出技术设计、明确实现方案、拆分关键模块、梳理依赖和风险，并把结果写入 `docs/codex/{version}/designs/` 时使用。它应与 `project-skill-convention` 配合，并在完成后回写 `status.md`。
Codex 的项目开发约束技能。涉及代码修改、代码阅读、业务上下文建立、文档编辑、查询代码逻辑、多文件实现时使用。它会约束任务启动、文档优先级、工作区与正式区的使用方式、代码变更后的文档同步，以及对外变更时的确认规则。
Codex 的基础设施只读查询技能。适用于查看数据库表结构、索引、ES mapping、ES 文档、Nacos 配置，以及追踪服务依赖的中间件连接信息。当任务涉及“查配置”“查索引”“查表结构”“查数据库”“DESC”“nacos”“mapping”“文档数”等场景时优先使用，核心原则是不猜，直接查。
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 的联动方式。