Ting

AGENTS.md的作用

告诉他你的项目基本信息，不能动什么，数据怎么走，避免重复 交代信息。

AGENT内容

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

# AGENTS.md

## 项目概述
这是一个基于 Next.js 14 + Prisma + PostgreSQL 的 SaaS 应用。
使用 App Router，不使用 Pages Router。

## 技术栈
- 前端：Next.js 14, React 18, TailwindCSS, shadcn/ui
- 后端：Next.js API Routes, Prisma ORM
- 数据库：PostgreSQL 15
- 认证：NextAuth.js

## 重要约定
- 所有数据库操作必须通过 lib/db.ts 中的 prisma 实例
- API 路由错误统一用 lib/api-error.ts 处理
- 环境变量在 .env.local 中，参考 .env.example

## 禁止事项
- 不要修改 prisma/schema.prisma，除非我明确要求
- 不要删除任何现有测试
- 生产环境的 .env 文件不要碰

• 配置层级
  • 全局层：~/.codex/AGENTS.md
  • 项目层： repo/AGENTS.md
  • 覆写层： repo/services/payments/AGENTS.override.md（子目录）

子代理是什么

适合需要同时处理多个文件或多个独立任务的场景。

CI/CD：持续集成和持续交付==实现软件发布流程各个阶段（从开发到部署）自动化的方法

PR：Pull Request==拉取请求，开发者可以将自己完成的代码修改提交给代码库的维护者，申请将这些更改合并到目标分支中

CI/CD工作

• 自动更新CHANGELOG：每次合并主分支后自动根据提交记录更新 CHANGELOG.md（合并到 main 分支后）
• 生成API文档： 根据代码变更自动生成或同步 API 文档（代码推送后）
• 自动代码审查：在 PR 流水线里自动跑代码审查并留下注释（PR创建或更新时）

日常开发工作流

步骤

1. 明确需求： 描述你想要实现的功能
2. Codex分析：Codex 理解项目结构和规范
3. 方案讨论： 与 Codex 确认实现方案
4. 代码生成：Codex 编写代码并修改文件
5. 验证测试：运行测试确认功能正确
6. 迭代优化： 根据反馈调整代码

代码理解工作流

步骤

1. 从入口点开始，让 Codex 解释整体架构
2. 逐步深入关键模块，理解核心逻辑
3. 追踪数据流和调用链
4. 总结关键点和注意事项

快速上手新代码(待总结)

重构工作流

谨慎使用，系统性改进代码结构

提示词基本结构

任务描述

你想做什么

命令分类

上下文管理

• /compact：压缩上下文==将当前对话历史只能摘要，保留关键信息，释放token
• /status：查看状态==输出当前对话id、已消耗的上下文token数、剩余额度等

代码与开发工作流

• /review：代码审查==对当前文件或指定代码段进行系统性审查，检查潜在bug、安全问题、性能瓶颈和代码风格
• /side：（对话分支）侧边对话==在临时分支发起独立对话，不影响主线，完成后可以合并、丢弃、保留
• /fork：（代码分支）派生分支==对话分叉为本地git分支或新工作树
• /mcp：列出当前对话中已连接的所有MCP服务器，查看在线状态和金额用工具列表

模型与推理控制

• /reasoning：推理强度（感觉如果是界面直接选比较方便）
• /model：模型（同上）

个性化

• /persona：设置个性语言风格
• /feedback：提交反馈==遇到输出问题立即反馈
• /pet：桌宠

日常开发工作流默认开始

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 步骤1：开始新任务前，检查上下文余量
/status

# 步骤2：遇到复杂问题，提升推理强度
/reasoning   # 切换至"高"档

# 步骤3：完成代码改动后，启动审查
/review

# 步骤4：探索不确定的方案，开启侧边对话
/side

# 步骤5：上下文快满时，压缩历史
/compact

本文参考b站视频教程学习

分词+词表构建

基础概念

流程：语料（Corpus）—> 分词（Tokenization）—> 词汇表（Vocabulary）