版本:v1.6.4(2026-06-22)
状态:Working Paper(持续更新中,引用请注明版本号)
许可:CC BY 4.0
语言:简体中文(其他语言译本以简体中文原文为准)
编码:UTF-8(全部文本文件)
翻译:正體中文 · English
AI 生成声明:本仓库大部分内容由人机协作生成(详见 PUBLISHING.md)
English Abstract: A comprehensive methodology framework for full-lifecycle human-AI collaboration — from project initiation, execution, and independent review through to archival. ~68,000 Chinese characters; empirically tested through 3 controlled prompt engineering experiments (Prompt-TDD) and 50+ rounds of multi-model independent review across 5 LLM backends. Covers: specification-driven development (Spec Coding), prompt experiment design with evidence grading, multi-agent workflow orchestration, passive observation mechanisms for serendipitous discovery, and project closure protocols. Full English translation available. The independent review methodology has been extracted as a standalone toolkit: Independent Review Toolkit — SOP + prompt templates + adversarial challenge framework + real examples. Licensed CC BY 4.0.
📖 ~16.8万字符 | 六层架构 | 3次对照实验 | 50+轮多后端独立审查 | Spec Coding · Prompt-TDD · 项目闭合
flowchart TB
HG["🧑 <b>Human Gate(人类闸门)</b><br/>贯穿全流程的人类决策点 —— 不可自动化"]
subgraph LAYERS["<b>六层分层架构</b>"]
direction LR
L0["<b>L0 · Spec</b><br/>项目宪法<br/>──────<br/>范围 · 边界<br/>死亡判据<br/>维护流程"]
L1["<b>L1 · Prompt</b><br/>任务规格<br/>──────<br/>Prompt-TDD<br/>对照实验<br/>证据标注 [E/C/N]"]
L2["<b>L2 · Loop</b><br/>执行迭代<br/>──────<br/>执行→反馈<br/>→修正循环"]
L3["<b>L3 · Workflow</b><br/>多任务编排<br/>──────<br/>9种模式<br/>审查链<br/>并行/流水线"]
L4["<b>L4 · Retrospect</b><br/>回顾沉淀<br/>──────<br/>方法论提取<br/>被动观测<br/>10种失效模式"]
L5["<b>L5 · Closure</b><br/>项目闭合<br/>──────<br/>S/M/L 分档<br/>封存清单<br/>资产归档"]
end
HG -.-> LAYERS
CROSS["📐 <b>跨层关切</b><br/>──────<br/>证据等级二维表示 [内部强度 × 跨模型推广性]<br/>方法论片段三层模板 · 跨层可观测性设计"]
EMPIRICAL["✅ <b>实证基础</b><br/>──────<br/>3 次对照实验(含阴性结果公开)<br/>50+ 轮独立审查 · 5 种 LLM 后端 · 4 个 CLI house"]
LAYERS --> CROSS
CROSS --> EMPIRICAL
一套描述"如何用 AI 协作跑完一个完整项目"的元层次操作规范——从启动、执行、审查到封存的全生命周期流程框架。核心信念:方向盘 > 发动机、分层不互相替代、从失败反向沉淀、AI 闭环 ≠ 人类审查。
定位声明:这是一个半开放的个人方法论工具——它不追求成为独立于作者的"通用框架"(一个人不可能拥有覆盖所有项目类型、工具链、验证独立性的经验谱系)。它提供的是经过多后端审查和对照实验证据标注的个人实践模式。欢迎参考、改编、和贡献反例;但读者应预期需要翻译成本才能适配自己的场景。详见 §1.8 局限 #9 和
_research/通用框架可行性讨论_20260621.md。
这是一份小型技术文档,不是软件项目。 本仓库不包含可运行的应用程序、库或 Web 服务。这里的"代码"是文档生成脚本(MD → JSON/DOCX 转换),"数据"是审查报告和案例研究,核心交付物是一份约 16.8 万字符(含 ~6.8 万中文字)的 Markdown 文档。
如果你在找:下载安装指南、API 文档、Demo 页面 —— 这些这里都没有。
如果你在找:一套经过实证检验的 AI 协作方法论框架 —— AI协作项目全生命周期框架.md 是入口。
主文档 AI协作项目全生命周期框架.md 是一份约 16.8 万字符(约 320 KB)的 Markdown 文档,以中文为主(~6.8 万汉字),含若干代码块、表格和 Mermaid 图表。精确的字符级统计随版本变动,不在此维护;如需当前数值可运行 _workflows/count_chars_v164.py。
AI协作项目全生命周期框架/
│
├── AI协作项目全生命周期框架.md ← 📖 主文档(入口)
├── AI协作项目全生命周期框架.json ← 机器可读版
├── AI协作项目全生命周期框架.docx ← Word 版(pandoc 生成)
├── README.md ← 本文件(结构导航)
├── CLAUDE.md ← AI 助手项目指令
├── PUBLISHING.md ← 发布边界与 AI 生成声明
├── LICENSE ← CC BY 4.0 许可证
├── VERSION ← 版本号(1.6.4)
├── project_status.md ← 项目状态追踪
├── reference_files.md ← 关键文件索引
├── project.yaml ← DOCX 管道项目配置
├── inventory.csv ← 文件清单(与发布包内容一致)
├── verify_version_consistency.py ← 版本一致性校验脚本
├── .gitignore ← 发布包边界定义
│
├── _archive/ ← 🗄 历史封存
│ ├── 元审查合规清单.{md,json} — 框架自身合规审查
│ ├── 独立审查标准操作程序_SOP.{md,json} — 审查 SOP v1.0
│ ├── provenance_erratum_20260617.md — 模型 provenance 勘误
│ ├── v1.5.1冻结期_待执行协议清单.md — 冻结期协议清单(已归档)
│ └── docx_legacy_scripts/ — DOCX 旧版生成脚本归档(含 README 说明取代关系)
│
├── _mermaid_png/ ← 🎨 图表源码 + 矢量图
│ └── *.mmd(源)/ *.emf(矢量) — Mermaid 源码 + EMF 矢量图
│ (PNG/SVG/PDF 渲染缓存不入库,见 .gitignore)
│
├── _protocols-and-tools/ ← 📋 协议 + 工具 + 配套文档
│ ├── meta-audit-checklist.{md,json} — 元审查合规清单 v1.0.4+(75 项)
│ ├── methodological-review-sop.{md,json} — 独立审查 SOP v1.0.4
│ ├── 框架级成熟度评估表.{md,json} — 框架自身成熟度评估 v0.4
│ ├── 外部依赖登记表.{md,json} — 工具链/模型/平台依赖追踪
│ ├── 可调参数索引.md — 魔法数字集中索引
│ ├── import_integrity_check.py — Python 导入检查工具(已弃用,见主文档 §9.1)
│ ├── AI协作项目全生命周期框架_OPEN4试读计时协议.{md,json}
│ └── AI协作项目全生命周期框架_人类专家verify包.{md,json}
│
├── _research/ ← 🔬 案例研究材料
│ ├── CCR作为逃生口案例研究.{md,json}
│ ├── CacheAligner与AI框架OPEN-1对标分析.{md,json}
│ ├── ChatGPT-5.5独立审查_headroom对标三文档.{md,json}
│ ├── SmartCrusher方法论提取.{md,json}
│ ├── headroom对标分析_封存说明.{md,json}
│ ├── 通用框架可行性讨论_20260621.md
│ ├── 两次试跑对比_2026-06-22.md
│ └── drafts/ — 废弃草案(v1.3.2 / v1.5.1)
│
├── _reviews/ ← 🔍 多后端独立审查报告
│ ├── (各版本审查报告 + 交叉验证记录 .md/.json/.txt)
│ ├── prompts/ — 审查提示词
│ ├── last_messages/ — CLI 输出片段
│ └── retrospects/ — 复盘记录
│
├── _workflows/ ← ⚙ 构建 + 同步 + 翻译脚本
│ ├── regenerate_docx.py — DOCX 全量重生成(Mermaid + pandoc + 样式)
│ ├── regenerate_inventory.py — 重生成 inventory.csv
│ ├── count_chars_v164.py — 字符级统计
│ ├── sync_v16{1,2,3,4}_docx.py — 各版本 DOCX 同步(历史)
│ ├── i18n/ — 翻译管道(术语表 + 翻译/检查脚本 + 审查报告)
│ └── *.js — Workflow 定义脚本
│
├── en/ ← 🌐 English translation
│ ├── README.md
│ ├── AI协作项目全生命周期框架.md
│ └── reference_files.md
│
└── zh-Hant/ ← 🌏 正體中文翻譯
├── README.md
├── AI协作项目全生命周期框架.md
└── reference_files.md
| 你想…… | 从这里开始 |
|---|---|
| 了解框架内容 | AI协作项目全生命周期框架.md |
| 机器处理/交叉分析 | AI协作项目全生命周期框架.json |
| 了解项目当前状态和待办 | project_status.md |
| 查找特定文件 | reference_files.md |
| 查看独立审查记录 | _reviews/ |
| 查看审查 SOP | _protocols-and-tools/methodological-review-sop.md |
| 了解框架成熟度 | _protocols-and-tools/框架级成熟度评估表.md |
| 前缀 | 含义 |
|---|---|
_ |
AI 工作中间产物(不被人类直接消费) |
| 无前缀 | 人类直接消费的核心文件 |
_archive / _mermaid_png / _reviews / _workflows 均为 AI 工作目录。
_protocols-and-tools / _research 人类可读,但非主文档。
主文档同时维护三种格式:
| 格式 | 用途 | 消费者 |
|---|---|---|
.md |
权威版本 | 人类 + AI |
.json |
结构化配套 | 机器(脚本消费、交叉验证) |
.docx |
传统分发 | 人类(Word 阅读/打印) |
.json 和 .docx 均由 .md 派生,修改以 .md 为准。
本框架经 5 种后端 × 5 个 CLI 的多轮独立审查,审查谱系记录于主文档 § 审查链。所有审查报告归档于 _reviews/。
本仓库的方法论已拆分为独立工具:
| 工具 | 说明 |
|---|---|
| Independent Review Toolkit | 独立审查工具包——SOP · prompt 模板 · 对抗式挑战框架 · 真实案例。从本文档 §9.2 + 50+ 轮实战审查提炼。复制 prompt 即可用。 |
| Prompt-TDD Methodology | Prompt 对照实验方法论案例手册——SOP + 两个真实实验(含阴性结果)+ 核心教训。本文档 §4.1.1.1 的 CK1-CK6 检查清单即提炼自此项目。 |
| M&A Case Study Pipeline | 多模型学术生产流水线——框架的六层理念在并购重组案例研究中的八阶段端到端实证(含交叉双盲审 + 开卷/盲答对照实验 + 可复用 playbook)。 |
| ETF Pattern Match — pybind11 | pybind11/C++20 混合编程加速实践——从量化策略提取纯计算模块并用 C++20 加速(DTW 43x / pattern_match 58x);采用本框架的多后端审查、被动观测、项目闭合协议。 |
| Claude Skills | 3 个实战验证的 Claude Code Skill——会话交接 · CLAUDE.md 编写 · 事前否决。从本文档 §9.2–§9.3 + 50+ 轮跨模型审查提炼,经 3 后端独立验证闭合。 |
生成模型:DeepSeek-V4-Pro (via Claude Code CLI) · 2026-07-01
目录结构与文件计数校正:Claude Opus 4.8 (via Claude Code CLI) · 2026-06-23 — 移除已迁出的构建产物/缓存条目,对齐发布包真实结构(经 Codex GPT-5.5 独立清点交叉验证)