5.4 KiB
5.4 KiB
Codex 任务交接检查清单
使用此检查清单确保向 Codex 提供所有必要信息。
任务评估
复杂度: ⬜ 简单 ⬜ 中等 ⬜ 复杂 ⬜ 非常复杂 核心逻辑行数: ________ 主要目标: ⬜ 算法设计 ⬜ 架构评审 ⬜ 性能优化 ⬜ 代码审查 紧急度: ⬜ 低 ⬜ 中等 ⬜ 高 ⬜ 关键
核心检查清单
1. 问题定义 ✓
- 清晰的问题陈述
- 定义成功标准
- 建立范围边界
- 记录已知限制
2. 上下文信息 ✓
- 提供项目概览
- 共享相关背景
- 识别相关系统/组件
- 提供历史背景
**项目**: [名称和用途]
**组件**: [正在处理的部分]
**用户**: [谁使用此功能/规模]
**历史**: [当前实现存在的原因]
3. 技术约束 ✓
- 性能要求(延迟、吞吐量)
- 资源限制(内存、CPU、存储)
- 兼容性要求(版本、平台)
- 依赖约束
⬜ 时间复杂度: 最大 O(?)
⬜ 空间复杂度: 最大 O(?)
⬜ 延迟目标: __ms
⬜ 吞吐量目标: __req/sec
⬜ 内存限制: __MB/GB
⬜ 平台: [Linux/Windows/macOS/跨平台]
⬜ 语言版本: [例如:Rust 1.70+, Python 3.11+]
4. 代码上下文 ✓
- 共享相关现有代码
- 记录代码风格/约定
- 提供依赖列表
- 包含项目结构概览
5. 数据上下文 ✓
- 指定输入数据格式
- 提供输入大小/规模
- 定义预期输出格式
- 识别边界情况
**输入**:
- 格式: [JSON/CSV/Binary/其他]
- 大小: [典型和最大]
- 模式: [结构定义]
- 示例: [示例数据]
**输出**:
- 格式: [预期结构]
- 约束: [验证规则]
6. 测试用例 ✓
- 提供正常情况(3-5 个示例)
- 识别边界情况
- 指定错误情况
- 性能基准(如果适用)
**正常情况**:
1. 输入: [...] → 期望: [...]
2. 输入: [...] → 期望: [...]
**边界情况**:
1. 空输入 → 期望: [...]
2. 单元素 → 期望: [...]
3. 最大大小 → 期望: [...]
**错误情况**:
1. 无效格式 → 期望: [错误处理]
2. 空值 → 期望: [错误处理]
7. 性能基线 ✓
(适用于优化任务)
- 当前性能指标
- 包含分析数据
- 识别瓶颈
- 指定目标改进
**当前性能**:
- 延迟: p50: __ms, p95: __ms, p99: __ms
- 吞吐量: __ops/sec
- 内存: __MB 峰值
- CPU: __%
**瓶颈** (来自分析):
1. 函数 X: __% 时间
2. 函数 Y: __% 时间
**目标**:
- 延迟减少 __%
- 吞吐量增加到 __ops/sec
8. 安全考虑 ✓
- 敏感数据处理要求
- 认证/授权需求
- 合规要求(GDPR、HIPAA 等)
- 已知安全关注点
9. 具体问题 ✓
- 准备至少 2 个具体问题
- 问题集中且可回答
- 如果有多个问题则优先排序
10. 预期交付物 ✓
- 明确界定您需要 Codex 做什么
- 指定格式(伪代码、完整代码、设计文档)
- 指示详细程度
⬜ 高级架构图
⬜ 详细设计文档
⬜ 伪代码/算法
⬜ 实现代码
⬜ 测试用例
⬜ 性能分析
⬜ 权衡比较
⬜ 迁移策略
任务特定检查清单
算法设计任务
- 问题约束形式化
- 提供输入/输出示例
- 量化性能要求
- 定义正确性标准
- 列举边界情况
架构评审任务
- 包含系统图
- 记录组件交互
- 列出当前痛点
- 指定扩展要求
- 记录技术栈
性能优化任务
- 附加分析数据
- 识别瓶颈
- 提供当前指标
- 定义目标指标
- 记录约束
代码审查任务
- 提供完整代码上下文
- 指定审查关注领域
- 识别关键路径
- 列出已知问题
- 定义审查标准
MCP 工具检查清单
- MCP 服务器运行并可访问
- 所需工具可用(验证
tools/list) - 配置工具权限
- 审查 inputSchema 要求
- 了解工具超时限制
- 准备错误处理策略
- 记录安全约束
发送前验证
发送前询问自己:
-
Codex 能否在不澄清的情况下理解问题?
- 是 → 继续
- 否 → 添加缺失的上下文
-
约束是否完整且具体?
- 是 → 继续
- 否 → 定义约束
-
成功能否客观衡量?
- 是 → 继续
- 否 → 添加成功标准
-
范围对于一次交互是否合理?
- 是 → 继续
- 否 → 拆分为更小的任务
-
是否包含了示例?
- 是 → 继续
- 否 → 添加示例
快速模板
快速算法请求
**问题**: [一行描述]
**输入**: [格式和约束]
**输出**: [预期结果]
**约束**: 时间: O(?), 空间: O(?)
**测试用例**: [一个示例]
快速性能评审
**函数**: [名称]
**当前**: [延迟/吞吐量]
**目标**: [目标]
**分析**: [热点]
**代码**: [实现]
快速架构问题
**系统**: [描述]
**规模**: [当前和目标]
**挑战**: [具体问题]
**问题**: [集中问题]
交接质量评分
总评分: ___/25
- 20-25: 优秀 - 准备交接
- 15-19: 良好 - 考虑添加更多细节
- 10-14: 需要改进 - 填补关键空白
- <10: 未准备 - 缺少主要信息
返回 SKILL.md 获取主要文档。