50 条来自真实 AI 协作项目的可检索踩坑实证，覆盖工程纪律、多模型审查、文件与工具陷阱，以及量化研究。
📖 在线阅读 · 📥 下载 PDF/DOCX · 📊 机器可读 JSON · 📝 如何引用
适合查阅，不要求通读。 遇到代码审查、项目发布、配置错误或文档生成问题时，按场景直接跳到对应条目。
代表性条目：
- 修改配置后，验证系统实际读取的是哪一个文件——而非猜测（§3.5）
- 同一 AI 不应同时担任设计者、执行者、验证者和评分官（§2.2）
- 发布前检查
.gitignore排除的文件，而非仅检查已跟踪的文件（§1.2）
flowchart TD
F["**AI Collaboration Framework**<br/>系统方法论 · 16.8 万字符"]
H["**Methodology Handbook**<br/>50 条实战速查 · 错题本"]
R["**Independent Review Toolkit**<br/>审查方法的可执行实现"]
D["**DOCX Pipeline**<br/>文档交付管线"]
C["**案例项目**<br/>ETF · M&A · Prompt-TDD<br/>实证与经验来源"]
F -->|"提炼为"| H
C -->|"提供实证"| H
H -->|"审查实践"| R
H -->|"文档交付"| D
A compact, battle-tested companion to the AI Collaboration Full-Lifecycle Framework — 50 empirically-grounded lessons.
Version 1.0.1 | 2026-07-20
The relationship to the full framework (168K characters) is like "textbook" vs. "error logbook": the framework is the systematic methodology; this handbook distills the mistakes into quick-reference entries. Source material comes from the author's personal project notes, curated and published here.
| 章节 | 条目数 | 内容 |
|---|---|---|
| §1 通用工程纪律 | 9 | 验证与核实、清理与发布、版本管理、代码重构 |
| §2 AI 协作方法论 | 32 | 多模型审查、provenance、prompt 设计、工作流、认知偏差 |
| §3 文件格式与工具陷阱 | 6 | YAML/JSON、DOCX、文本编辑、编码、配置文件 |
| §4 量化研究专项 | 3 | 特征泄漏、LambdaRank、regime 检测 |
每条含：标题 + 一句话教训 + 关键引述 + 实证日期 + 分类标签。
展开完整分类标签索引（22 个标签）
| 标签 | 含义 | 条目数 |
|---|---|---|
| 验证纪律 | 下断言/改配置/改措辞后的独立验证 | 3 |
| 发布纪律 | 发布前的清理、排除、零残留确认 | 3 |
| 版本管理 | 版本号升级的同步范围 | 1 |
| 代码重构 | 从单体提取模块的方法 | 1 |
| 工具使用 | 给外部 CLI 工具发指令的约定 | 1 |
| 多模型审查 | 多个 AI 模型做代码/文档审查的策略 | 9 |
| provenance | 产出物的模型来源追溯 | 3 |
| 独立性审查 | 防止同一 AI 占据多重角色的检查 | 1 |
| 工具评估 | 评估 AI 代理工具的实证方法 | 2 |
| 实验设计 | prompt 变异 vs 模型变异的效应量 | 1 |
| 任务执行 | 有计划时的执行纪律、文本生成流程 | 2 |
| 交付物设计 | md/json 双件的配对模式 | 1 |
| prompt 设计 | CLAUDE.md 编写、Skill 设计协议 | 2 |
| 工作流 | 任务分派、交叉验证、过程文件保存 | 3 |
| 上下文管理 | 大上下文压缩的触发时机 | 2 |
| 认知偏差 | 自评估偏乐观、实证声明过推广、格式残留盲区 | 3 |
| 协作元认知 | 对抗式审查、被动观测、失败重试策略 | 3 |
| 文件格式 | YAML/JSON/CFF/DOCX 格式陷阱 | 3 |
| 文本编辑 | 短模式全局替换的误伤风险 | 1 |
| 编码 | Windows 终端中文字符编码 | 1 |
| 配置 | 修改配置前确认系统读取的文件 | 1 |
| 量化研究 | 特征泄漏、LambdaRank 敏感性、regime 滞后 | 3 |
手册中涉及特定工具或工作流概念。关注条目中的通用原则即可——原则独立于具体 CLI 实现。
| 术语 | 定义 | 来源 |
|---|---|---|
| Workflow | 多 agent 编排框架，支持并行/管道式子任务分发 | Claude Code CLI |
| agent() | Workflow 中启动子 agent 的函数 | Claude Code CLI |
| headroom_compress | 将大文本预压缩以节省上下文窗口 | Claude Code CLI (MCP) |
| 安全分类器 / classifier | 执行命令前的安全审核组件 | Claude Code CLI |
| Codex CLI | OpenAI 命令行 AI 编程工具 | Codex CLI |
| [GATE] | 计划中标记为需人工确认的阻断点 | 项目计划约定 |
| P0/P1/P2 | 优先级：阻塞/高/中 | 通用项目管理 |
| zero-involvement | 零卷入——审查者未参与被审查内容的创建 | 审查方法论 |
| provenance | 产出物的模型后端×会话溯源记录 | AI 协作通用 |
完整术语表见手册附录。
目标读者：使用 AI 编程工具（Claude Code、Codex CLI、Cursor 等）进行软件工程或学术项目的开发者与研究者。假设读者有基本的 AI 辅助编程经验。
证据范围：手册中的"实证"指作者在 2026 年 5-7 月间多次 AI 协作项目中记录的具体事件。数字（如"7/7 收敛""~11% 偏差"）来自单次观测，适用范围限于当时使用的模型版本和任务类型。应视为案例参考而非统计结论。
手册为 md/json 双件发布。md 是真相源（先于 json 生成）。
查阅而非通读。 这不是教程——是速查手册。遇到具体场景时按分类标签定位：
Browse, don't read. This is a reference, not a tutorial. Navigate by category tags when facing specific situations.
- 📖 在线阅读 Markdown — 人类可读（含目录、锚点链接、术语附录）
- 📊 机器可读 JSON — 结构化数据（
metadata→sections[]→subsections[]→entries[]） - English handbook — 美式英语翻译（GPT-5.6-Sol 翻译）
- 正體中文手冊 — 正體中文（OpenCC 转换 + GPT-5.6-Sol 校对）
- 📥 下载 PDF/DOCX — Release 页面提供最新版本
更多项目请见 个人主页
普通文本引用：
Acerolaorion. 方法论与经验教训手册（Methodology & Lessons Learned Handbook）. Version 1.0.1, 2026-07-20. CC BY 4.0.
BibTeX:
@manual{methodology-handbook,
author = {Acerolaorion},
title = {方法论与经验教训手册（Methodology \& Lessons Learned Handbook）},
version = {1.0.1},
year = {2026},
month = jul,
url = {https://github.com/redamancy231-create/methodology-handbook},
note = {CC BY 4.0}
}也可引用 CITATION.cff。如果修改或翻译，请注明变更。