# 07 · AI-native 工作流

> 统一命令面 `/kb <verb>` + 四循环 + 人机分工铁律。**本文是命令列表的唯一真相源**，工具链文档引用不复述。
> 核心：AI 主执行，人是监督者与拍板者；丢资料是唯一强人工入口。

---

## 1. 统一命令面 `/kb <verb>`

一处列全，工具链与工作流共用。命令实现在 `.claude/commands/`。

| 命令 | 作用 |
|---|---|
| `/kb-new <代号>` | 建项目骨架（调 `kb-init.sh`） |
| `/kb-ingest <代号> <源>` | 录入循环入口（丢资料，AI 全包） |
| `/kb-link <文件/NAS路径/URL>` | 编译链接：点名物料，提炼精华+留指针，不搬原件 |
| `/kb-ask <问题>` | 查询循环入口（强制溯源） |
| `/kb-save` | 把对话洞察回写为 `questions/` 页 |
| `/kb-check` | frontmatter 校验 + lint 体检（调 `kb-lint-fm.py`） |
| `/kb-status` | 源计数 / 健康仪表盘（读 `meta/stats.md`） |

> 删除 `/kb-grow`——生长机制降为预留接口，不落地命令与监控。

---

## 2. 四循环

### 循环 A · 录入（Ingest）

**人只做**：丢资料 + 一句说明 + 对要点点头。

**AI 自动**：
1. **Delta Check 去重** → 比对 `meta/ingest-manifest.json` hash 台账。
2. **落原文** → 外部文档进 `projects/*/docs/` 或 `assets/`。
3. **抽关键发现** → 从原文抽要点。
4. **写合规页** → frontmatter 自动补齐（`title`/`ingested`/`status`/可推导 `source`）。
5. **建 wikilink** → 识别提及的实体/项目/决策自动挂链。
6. **矛盾不静默覆盖** → MVP 用简单标注挂起（正文加矛盾标记），**不做自动 status 降级状态机**。

> **MVP 一次录入产出结构化 markdown，不做 8-15 页 wiki 编译**（P4 才编译）。

### 循环 B · 查询（Ask）

- CC 直接**语义检索 markdown** 回答（MVP 不依赖向量库）。
- **每条结论挂 `source_link` 溯源**。
- 覆盖不足**明说缺口**，**绝不用训练数据编造**——无据即报 Gap。
- 有沉淀价值时**提议 `/kb-save`** 回写。

### 循环 C · 维护（Maintain）

- `/kb-check` 跑 lint（孤立页 / 死链 / 缺字段 / 过时索引）。
- **保持轻量提示，不做周度 cron 强制门禁**；靠 Git PR review + CC 提示。
- **安全项 AI 自动修**：补可推导字段、建 stub、加 wikilink。
- **有损项挂起交人**：删页、解决矛盾、合并、改 type。

### 循环 D · 生长（Grow，预留）

- 一段说明即可——「到 P5 红线时再启用向量库导航层，接口预留」。
- 仅保留 `meta/stats.md` 人工可读源计数作红线观察点。
- **不预建**密度/熵增监控。

### 循环 E · 飞书群问答（P2 上线）

同事在飞书群 @机器人 提问，机器人查知识库带溯源回复。**长连接实现，无需公网**（见 `docs/08`）。

- **人只做**：群里 @机器人 问一句。
- **AI 自动**：`kb-bot` 收事件 → 抽问题 → 调 `/kb-ask`（复用查询循环 B 的全部铁律）→ `lark-cli` 回复到 thread。
- **只读不写**：机器人绝不写/删知识库；答案带 `source_link`，无据回「知识库暂无」，绝不编造。
- 人机分工同**循环 B 查询**（此处只是把入口从 CC 换成飞书群）。

---

## 3. 人机分工表

| 环节 | 人 | AI |
|---|---|---|
| 采集 | **丢资料 + 一句说明**（唯一强人工入口） | 拉取/去重/落盘 |
| frontmatter | 拍板 `type`（采集器常可推断） | 自动补 `title`/`ingested`/`status`/`source` |
| 结构化 | 对要点点头 | 抽发现、写合规页、建 wikilink |
| 查询 | 提问、判断可用性 | 检索、溯源回答、报 Gap |
| 矛盾 | 拍板解决 | 标注挂起，不擅自覆盖 |
| 维护 | review 有损操作 | 自动修安全项、提示 |
| 删/合并/改 type | **拍板** | 挂起交人 |

---

## 4. 人机分工铁律

1. **能让 AI 自动做的绝不让人做**——丢资料是唯一强人工入口。
2. **AI 永不擅自有损操作**——删页/覆盖/合并/改 type 必挂起交人。
3. **AI 永不编造**——无据即报 Gap，绝不用训练数据填坑。
4. **人是监督者与拍板者**——AI 执行，人决策。

---

## 附：典型会话示范

```
用户：把客户 A 昨天飞书群里定报价那段整理进来
  → /kb-ingest clientA 飞书群
  → AI: Delta Check 通过（新内容）→ 落原文 → 抽出「改用阶梯定价」决策
       → 写 projects/clientA/decisions/stepped-pricing.md
       → frontmatter 自动补齐，related 挂到 [[project-clientA]]
       → 请确认要点：①阶梯定价 ②牺牲首单毛利 ③锁长期合作
  用户：对
  → AI: 已提交。

用户：客户 A 为什么不用一口价？
  → /kb-ask 客户 A 为什么不用一口价
  → AI: 因客户预算分期到位，改用阶梯定价锁长期合作、牺牲首单毛利。
       溯源：projects/clientA/decisions/stepped-pricing.md
       （source: 飞书群 https://company.feishu.cn/im/xxxx?msg=99231）
```