序言：一人即是一支队伍¶

序言封面

过去，要把一个脑中的想法变成能跑的产品，你需要一支整装待发的舰队：产品经理定航向、设计师画蓝图、前后端工程师造轮子、运维守底舱。

今天，AI 把“造轮子”的边际成本压缩到了接近零。这让“一个人成为一支队伍”不仅可能，而且正在发生。

这听起来很自由，但代价是责任更重。

当代码不再是瓶颈，方向错误就成了最大的灾难。在低成本制造的诱惑下，你面临的最大风险往往是做出来一堆垃圾：没有用户价值，无法持续交付，甚至因为缺乏治理而埋下法律或安全隐患。[4][5]

此刻起，你不再只是那个等着接需求的程序员。你必须同时佩戴三枚徽章：决断航向的指挥官（价值）、把改动变成成果的工程师（交付），以及在狂热中踩刹车的审查官（治理）。[2]

本书写给谁¶

这本书不教你“如何用 AI 一天生成 100 个垃圾站”，也不提供“快速暴富”的幻觉。这是一本写给严肃手艺人的工程手册。

如果你想在不确定性里建立纪律，用证据而非直觉导航，并准备好对结果端到端负责，从写下一行字到收到第一块钱，你适合读这本书。如果你只把 AI 当作免思考的外包工，指望它替你承担思考的痛苦和决策的风险，这本书可能会让你失望。

如果你愿意用“慢一点的验证”换取“稳一点的交付”，这本书提供的是一套把单兵作战变成可复利、可审计的工程体系。[4][5]

你的三重责任：价值、交付、治理¶

在一人成军的模式下，没人替你补位。你必须独自守住三条底线。

价值这条线要回答值不值得做，你需要留下决策日志，记录假设、反例与止损红线。如果你无法用一句话说清“谁在什么场景下解决什么痛点”，就先别推进。交付这条线要回答做出来靠不靠谱，你需要写清验收标准，让通过和失败可复核。如果自动化测试过不了，或者你做不到一键回滚，就先别上线。治理这条线要回答能不能长期存活，你需要有评测报告，至少能解释准确率、幻觉率与延迟分布。如果关键动作无法回答谁在何时做了什么，或者系统行为不可追溯，就别扩量。

图 P-1：价值/交付/治理三圈相交，中心为 AI Accelerator，并标注证据阈值、回滚阈值与审计阈值

把上图看作你的三个“门神”：价值门神盯证据，没有可回放证据就先别写代码。交付门神盯回归与指标，指标越界或关键用例失败就立刻降级或回滚。治理门神盯审计，涉及扣费或删除数据这类关键操作，没有审计日志就先别扩量。

能力演进：从调用者到塑造者¶

这一路你会经历三个台阶。这不关乎职位，只关乎你能交付的确定性：

第一阶段是调用者，你能把 API 调通，交付一个能跑的 Demo，但你说不清它为什么跑通，也说不清它什么时候会挂。第二阶段是设计者，你开始交付指标与护栏，把“感觉更好”写成可验证的门槛，比如准确率超过多少，延迟低于多少。第三阶段是塑造者，你开始交付权重与基准，通过调整数据分布与策略权重，让系统行为更可控，也更容易持续演进。

图 P-2：三阶台阶从 Caller→Designer→Shaper

警惕 AI 的“虚假确定性”¶

AI 最危险的地方，在于它能以极其自信的语气胡说八道。当建造变得廉价时，你很容易产生幻觉：把“代码跑通了”误判为“路走对了”。[6]

你需要一套可落地的工程纪律。没数据的观点就是猜测，猜测可以写，但要配验证方法与止损线。形容词要换成数字，别说要快，要把 P99 延迟的目标写出来，别说要准，要把固定评测集上的通过率写出来。任何没有回滚按钮的功能都很危险，在按下发布前先问自己，出事后能不能在十分钟内恢复。

模板：现在就能用的工程脚手架¶

为了让你立刻上手，这里提供两个最基础的模板和一个可执行的门禁示例。

模板 A：一页纸 PRD（微型版）¶

在写代码前，先把三件事写清楚：用户故事、验收标准、止损线。填不出来就先别动工。

用户故事: As a <角色>, I want <功能>, so that <价值>
验收标准: <具体的通过/失败条件>
止损线: <投入多少资源未果即放弃>

示例
用户故事: 作为主编，我想要一键校对，以便在 5 分钟内发现所有错别字
验收标准: 上传 Markdown 文件，返回带高亮的 HTML；错别字召回率大于 90%；误报率小于 5%
止损线: 如果本周五前无法将误报率降到 10% 以下，则砍掉此功能

模板 B：决策日志（Decision Log）¶

新建一个 DECISIONS.md，像这样记录每一个关键转折。

# 2025-12-24: 放弃本地部署 LLM，转用 API

背景: 本地模型响应太慢（P99 > 5s），且显存溢出导致 Crash
决策: 切换到云端 API
验证: 成本测算与性能测试结果写清（口径与样本固定）
回滚方案: 保留本地推理方案，通过环境变量 `USE_LOCAL_LLM=true` 随时切回

可执行示例：一个极简门禁脚本（可接入 CI）¶

这是一个极简 Bash 脚本，用来模拟“门神触发”。把它放在 scripts/check_thresholds.sh，并在 CI 或 pre-push hook 里调用。

#!/usr/bin/env bash
set -euo pipefail

echo "Running threshold checks"

# 1) 检查是否有硬编码密钥（示意规则）
if grep -R -nE "sk-[A-Za-z0-9]{20,}" ./src; then
  echo "FAIL: possible API key found in source. Move secrets to env vars."
  exit 1
fi

# 2) 运行一个最关键的冒烟测试（替换为你的实际用例）
python3 -m pytest tests/smoke_test.py

echo "PASS"

最短路径（今天就能做）¶

你不必读完整本书才开始行动。今天就能做的事包括：新建 DECISIONS.md 把决策写下来；给每个任务写一条止损线；先把 Hello World 的自动化部署流水线跑通；写一个最关键的端到端用例当金丝雀测试；给新功能加一个 Feature Flag 作为回滚开关；删掉注释掉的幽灵代码，Git 会记住历史。

本书导航¶

本书是一套分区域的作战海图，可以根据阶段按需查阅。0 到 1 阶段建议先跑通机会、合同、原型、验证与体验这条最短闭环，依次看 02-discovery.md、03-prd.md、04-prototype.md、05-validation.md、06-ui.md。上线后建议补齐工程设施与评测体系，先看 07-engineering.md 与 18-evaluation.md。当你需要构建 RAG 或 Agent 时看 10-agent-rag.md。如果你想先建立全貌认知，可以先读 condensed-master-guide.md。

承诺¶

我不列举即将过时的工具清单，只交付一套关于观测、决策与纪律的方法论。

在一人成军的时代，纪律是你唯一的护城河。[5]

参考文献详见本书统一列表：references.md。