Codex: Codex 规则与钩子

# AGENTS.md

## 项目概述
项目名称：E-Commerce API
技术栈：FastAPI + PostgreSQL + Redis
代码规范：PEP 8 + Black formatter

## 代码规则
- 所有函数必须有类型注解
- 所有 API 端点必须有输入验证
- 使用 dependency injection
- 错误处理使用自定义异常类

## 文件结构
- src/api/ - API 路由
- src/models/ - 数据模型
- src/services/ - 业务逻辑
- src/tests/ - 测试文件

## 禁止操作
- 不要修改 .env 文件
- 不要删除现有测试
- 不要安装新依赖（需人工确认）
- 不要修改 database/migrations/ 中的已有迁移

# AGENTS.md

## 项目概述
Next.js 14 电商网站，使用 App Router + TypeScript + Prisma

## 代码规则
- 组件使用函数式组件 + TypeScript
- 使用 server actions 而非 API routes
- 数据获取使用 RSC (React Server Components)
- 样式使用 Tailwind CSS
- 表单使用 React Hook Form + Zod 验证

## 目录约定
- app/ - 页面和路由
- components/ - 可复用组件
- lib/ - 工具函数和配置
- types/ - TypeScript 类型定义

## 禁止操作
- 不要使用 'use client' 除非必要
- 不要安装新的 UI 库（使用已有的 shadcn/ui）
- 不要修改 prisma/schema.prisma 中的已有模型（只添加新的）
- 不要修改 middleware.ts

# .codex/config.toml

[hooks]
# 任务完成后自动运行测试
post-task = "npm test"

# 提交前自动格式化
pre-commit = "npm run format && npm run lint"

# 出错时发送通知
on-error = "curl -X POST https://hooks.slack.com/xxx -d 'Codex error'"

# .codex/hooks/post-task.sh
#!/bin/bash

# 运行测试
npm test
if [ $? -ne 0 ]; then
  echo "Tests failed! Fixing..."
  codex --full-auto "修复所有失败的测试"
fi

# 格式化代码
npm run format

# 检查 lint
npm run lint

# Bob 的钩子配置
[hooks]
post-task = "bash .codex/hooks/post-task.sh"

# .codex/hooks/post-task.sh
#!/bin/bash
npm test                    # 运行测试
npm run lint -- --fix       # 修复 lint
npm run format              # 格式化
echo "Hook: post-task completed"

project/
├── AGENTS.md              # 全局规则
├── src/
│   ├── AGENTS.md          # src 目录规则
│   ├── api/
│   │   └── AGENTS.md      # API 模块规则
│   └── auth/
│       └── AGENTS.md      # Auth 模块规则

子目录 AGENTS.md > 父目录 AGENTS.md > 根目录 AGENTS.md

<!-- src/api/AGENTS.md -->
# API 模块规则
- 所有端点必须有 Swagger 文档
- 使用 Pydantic 做请求/响应验证
- 返回标准响应格式：{ data: ..., error: ... }

AGENTS.md 子目录 > AGENTS.md 根目录 > Skills > 配置文件 > 默认行为