| name | starter-kit-guide |
| description | Codex 中文技能工程的只读说明技能。需要快速了解这个 starter kit 包含哪些技能、它们各自适用于什么场景，以及应该如何在 Codex 中使用时调用。 |
Starter Kit 使用说明
只解释本技能工程，不做实际修改。
包含的技能
project-entry：项目入口与技能编排dev-constraints：开发约束dev-small-tool：基础设施只读查询docs-desc-generation：业务域文档生成session-cleanup：安全清理旧 Codex 会话task-control：长任务持久化与恢复project-skill-convention：需求、设计、计划、追踪的统一公约req-analysis：需求拆解与 requirements 文档生成design-phase：技术设计文档生成plan-phase：实施计划文档生成req-trace：需求到实现的闭环追踪审查starter-kit-import：安装或复制本技能工程到 Codex 技能目录starter-kit-backup：把现有 Codex 技能打包成可分享的 starter kit
推荐入口
项目工作建议优先依赖项目根 AGENTS.md 自动进入 $project-entry；如果项目还没初始化规则文件，再手动从 $project-entry 进入。
它会根据任务类型，把请求分流到：
- 日常开发：
dev-constraints
- 基础设施查询：
dev-small-tool
- 业务域文档：
docs-desc-generation
- 本地维护：
session-cleanup
- 长任务：
task-control
- 需求分析：
req-analysis
- 技术设计：
design-phase
- 执行计划：
plan-phase
- 闭环追踪：
req-trace
如果使用子代理或并行执行，也应继续遵守项目根 AGENTS.md 和入口技能给出的编排规则。
入口总览图
flowchart TD
A[进入项目] --> B[AGENTS.md]
B --> C[project-entry]
C --> D{任务类型}
D -->|开发| E[dev-constraints]
D -->|长任务| F[task-control]
D -->|流程型任务| G[project-skill-convention]
G --> H[req-analysis / design-phase / plan-phase / req-trace]
阶段流转图
flowchart LR
A[需求] --> B[req-analysis]
B --> C[requirements]
C --> D[design-phase]
D --> E[design]
E --> F[plan-phase]
F --> G[plan]
G --> H[实现]
H --> I[req-trace]
子代理协作图
flowchart TD
A[主代理] --> B[project-entry 判断]
B --> C[整理派发协议]
C --> D[传递 AGENTS.md 规则]
C --> E[传递边界/必守技能/必读文件]
C --> F[必要时先接入 task-control]
D --> G[子代理局部执行]
E --> G
F --> G
G --> H[回传改动/验证/风险/下一步]
H --> I[主代理收口]
常见使用方式
- 日常开发：
project-entry -> dev-constraints
- 基础设施查询：
project-entry -> dev-small-tool
- 缺上下文时初始化业务域文档：
project-entry -> docs-desc-generation
- 会话维护：
session-cleanup
- 大任务、易中断任务：
project-entry -> dev-constraints -> task-control
- 结构化交付流程：
project-entry -> req-analysis -> design-phase -> plan-phase -> 实现 -> req-trace
- 子代理协作：主代理先按
project-entry 判断规则，再把边界、必读文件、必守技能、回传格式传给子代理
- 分享到另一台机器或团队：
starter-kit-backup 后再 starter-kit-import
工程定位
- 这是一个纯 Codex 技能工程
- 通过技能目录直接组织和分发能力
- 依赖 Codex 的技能发现与显式调用方式工作
- 既可作为通用 starter kit，也可继续扩展成项目专用技能包
- 通过“项目根
AGENTS.md + project-entry”提供接近原版的项目级自动编排体验
- 通过项目规则协议尽量补足原版对子代理规则继承的能力
