Initial commit: company-kb framework
- 完整的知识库框架(P0-P5 路线图) - 12篇治理文档 - 工具脚本(kb-init.sh, kb-lint-fm.py, feishu-sync.py, kb-bot) - 7个 Claude 命令 - 示例项目和测试项目(wanniu-l1) - 契约文件(meta/kb-contract.yaml) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
113
docs/07-AI-native工作流.md
Executable file
113
docs/07-AI-native工作流.md
Executable file
@@ -0,0 +1,113 @@
|
||||
# 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)
|
||||
```
|
||||
Reference in New Issue
Block a user