AGENTS.md —《一人公司产品工程》写作规范

本文件是所有写作子代理的「宪法」。每写一章前必读，产出必须符合本规范。质量一致性高于一切。

1. 全书定位

• 书名：《一人公司产品工程》
• 副标题：把独立产品从玄学变工程——发现需求、整合资源、交付产品的工程化闭环
• 读者：想做独立产品/一人公司的人（开发者、信息化从业者、想转型的职场人、超级个体）
• 核心主张：把「发现需求 → 整合资源 → 交付产品」从玄学（鸡汤创业论）变成工程（可执行闭环）
• 口吻：第一性原理 + 把 X 从玄学变工程。果断、有主张、不绕弯、不鸡汤、不客套。
• 基因：原理优先 + 结论先行 + 可执行闭环 + 直面失败。

2. 语言规范

• 正文中文；技术实体（产品名/命令/变量/路径/JSON 键/协议名）保留英文。例：跑 npm run docs:build、写入 CLAUDE.md、用 Claude Code 编排。
• 人称「你」（直接对话读者）；叙述事物用「它/我们」；几乎不用「我」。
• 产品/协议名首次出现给中文释义 + 英文原名，如「能力矩阵（Capability Matrix）」「交付闭环（Delivery Loop）」。
• 代码块必须带语言标注：```text ```yaml ```bash ```python。无标准语法高亮的（如清单、话术、模板）一律用 ```text。

3. 每章骨架（签名元素，缺一不可）

每章严格按此结构产出：

# 第 NN 章 〈动宾标题〉

> 〈1 段引子：承接上章 + 本章解决什么 + 引出下章。必写。例：第 N-1 章讲了 X，但 X 之后你会遇到 Y，本章解决 Y，第 N+1 章讲 Z。〉

## N.1 结论先行：〈一句话终极主张〉
〈2-3 段把结论摊开。配一个公式 block 或核心对比表锚定。
  结尾句式："理解这一点后，本章其余都在回答一个问题：……"〉

## N.2 〈主题〉是什么：定位、能力与边界
### 与〈替代方案/常见误解〉的差异
| 维度 | A | B | C |
|---|---|---|---|
| ... | ... | ... | ... |
### 能做什么
1. **〈短语〉** — 〈解释〉
2. ...
### 不能做什么（边界）
- **〈项〉** — 〈为什么这是设计取舍，不是缺陷〉

## N.3 〈核心方法论拆解〉
〈ASCII 流程图 或 公式 block，每章 ≥1 张〉
### N.3.1 〈子点〉
### N.3.2 〈子点〉

## N.4 〈N 个心法 / 要点〉
### 心法一：〈名〉
> **〈加粗铁律，blockquote〉**
- **〈落地动作 1〉**
- **〈落地动作 2〉**

## N.5 实战：〈一个真实端到端场景〉
### 步骤一：〈动作〉
〈模板/清单/命令 + 预期 block〉
### 步骤二：...
### 步骤三：...
**验证**：〈可执行验收标准〉
**失败边界**（逐项排查）：
| 症状 | 根因 | 处理 |
|---|---|---|

## N.6 〈本概念〉vs〈相邻概念〉：分工与选型
| 维度 | X | Y | Z |
|---|---|---|---|
**决策树**：
- 〈条件〉 → **〈选择〉**

## N.7 失败边界：〈三种最常见的死法〉
### 死法一：〈名〉
〈根因 + 对抗策略〉
### 死法二：...
### 死法三：...
### 红线边界：不可让渡的决策
- **〈项〉**：〈即便自动化也必须人审〉

## N.8 小结 / 核心心法
> **〈一句金句 blockquote〉**
1. **〈要点〉**
2. ...
执行清单（每次/每周自检）：
- [ ] 〈可勾选动作 1〉
- [ ] 〈可勾选动作 2〉

---

上一章：[第 N-1 章 〈标题〉](〈N-1〉-中文标题)
下一章：[第 N+1 章 〈标题〉](〈N+1〉-中文标题)

签名命中率（来自先例统计）：N.1 结论先行 31/32、失败边界 31/32、blockquote 引子 8/8、底部导航 34/34。这是本书的指纹，不可省略。

4. 全书核心框架（01 章三公式，每章必呼应）

01 章立了三个公式作为全书骨架，每章至少在一处显式呼应其中 1-2 个（用"呼应第 01 章的 XX 公式"）：

公式一 · 杠杆率 = 你编排的 AI 能力数量 × 每个能力被复用的次数
公式二 · 交付闭环 = 范围 → 实现 → 验证 → 验收（缺任何一环就是烂尾）
公式三 · 复利资产 = 一次生产 × N 次复用（内容/代码/案例/SOP）

5. 体量基线

• 概念章：12-20KB（约 4500-6000 中文字）
• 实战/案例章：24-34KB（约 6000-7500 中文字）
• 每章必含：≥1 张表、≥1 个模板/清单/公式 block、≥1 张 ASCII 图、≥1 处 blockquote 铁律、可勾选执行清单。
• 新书相对先例的调整：先例代码块密度极高（实战章 20+）；本书代码块换成**「模板/清单/话术/配置」**（报价单、访谈问题清单、合同要点、SOP 流程），保持「可执行配置」质感；ASCII 图比例上调（四象限、阶段递进、决策树、闭环流程）。

6. 风格 checklist（每章交稿前逐条核对）

• [ ] 第一节是否叫「N.1 结论先行」且真给了结论（不是"本章将讨论"）？
• [ ] H1 后是否紧跟 blockquote 引子（承接 + 本章问题 + 引出）？
• [ ] 是否有专门的「失败边界」小节（≥3 种死法 + 对抗策略）？
• [ ] 是否 ≥1 张表、≥1 个模板/公式 block、≥1 张 ASCII 图、≥1 处 blockquote 铁律？
• [ ] 是否有可勾选的「执行清单」收尾？
• [ ] 是否有底部「上一章 / 下一章」导航？
• [ ] 人称「你」，技术实体英文、正文中文？
• [ ] 每段是否有 **加粗短语** 视觉锚点？至少 1 句金句？
• [ ] 是否呼应了 01 章的三公式之一？是否回指了其他章（"见第 N 章"）？
• [ ] 小节编号是否 N.M / N.M.K？
• [ ] 无标准语法的代码块是否用了 ```text？
• [ ] 是否避免了谄媚废话（"好主意""当然可以"等）？

7. 脱敏原则（案例章 21-25 必读）

• 敏感项目一律剥离细节：平台名、账号凭据、绕过/薅羊毛手段、目标站点、真实客户信息。
• 只保留可迁移的工程范式：如何发现需求、如何编排、如何交付、如何复用。
• 案例服务于方法论，不是炫耀技术细节。读者要学的是"怎么从 X 提炼出可售卖的 Y"，不是"X 的具体实现"。
• 具体脱敏映射见各章 prompt。

8. 命名与导航规范（防断链）

• 文件名：NN-中文标题.md，两位编号、全小写、连字符、无 frontmatter。
• 章节内导航链接用 cleanUrls，不带 .md 不带 .html： 下一章：[第02章 什么是真需求](02-什么是真需求)
• 小节编号 N.M / N.M.K，与 H2/H3 前缀对应，便于交叉引用（"见 10.3"）。

9. 章节地图（写导航时严格对照，勿编造标题/文件名）

编号	文件名	标题
00	00-前言	前言：把一人公司从玄学变工程
01	01-三个工程化公式	第01章 三个工程化公式
02	02-什么是真需求	第02章 什么是「真需求」
03	03-你是编排者不是执行者	第03章 你是编排者，不是执行者
04	04-需求来源地图	第04章 需求来源地图
05	05-用户访谈与需求挖掘	第05章 用户访谈与需求挖掘
06	06-需求验证	第06章 需求验证：最小成本证伪
07	07-需求文档化	第07章 需求文档化
08	08-需求的失败边界	第08章 需求的失败边界
09	09-能力矩阵	第09章 能力矩阵
10	10-AI能力编排	第10章 AI 能力编排
11	11-工作流即资产	第11章 工作流即资产
12	12-知识沉淀系统	第12章 知识沉淀系统
13	13-资源杠杆	第13章 资源杠杆
14	14-成本与预算	第14章 成本与预算
15	15-交付闭环	第15章 交付闭环
16	16-MVP与质量底线	第16章 MVP 与质量底线
17	17-接单交付SOP	第17章 接单交付 SOP
18	18-工作流产品化	第18章 工作流产品化
19	19-Agent产品骨架	第19章 Agent 产品骨架
20	20-交付的失败边界	第20章 交付的失败边界
21	21-案例-从接单中发现需求	第21章 案例：从接单中发现需求
22	22-案例-技术能力产品化	第22章 案例：技术能力产品化
23	23-案例-从工具到产品	第23章 案例：从一个工具到一类产品
24	24-案例-架构分析即服务	第24章 案例：架构分析即服务
25	25-案例-内容资产的复利	第25章 案例：内容资产的复利
26	26-一人公司系统性框架	第26章 一人公司系统性框架
27	27-从交付到运营	第27章 从交付到运营
28	28-风险红线	第28章 风险红线
29	29-备份迁移与环境重建	第29章 备份、迁移与环境可重建
30	30-终章-你的下一步	第30章 终章：你的下一步
99	99-附录	附录：速查手册

10. 写作产出要求

• 直接用 Write 工具写到 /Users/mba/claude/solo-product-engineering/NN-中文标题.md。
• 写完返回一句话确认（章号 + 字数 + 是否通过 checklist 自检）。
• 不要写其他文件，只写分配给你的那一章。