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:
yangqianqian
2026-07-16 18:24:39 +08:00
commit 84f7950589
60 changed files with 4410 additions and 0 deletions

36
projects/_example/_index.md Executable file
View File

@@ -0,0 +1,36 @@
---
type: project
title: "示例项目Example"
description: 一个照抄即合规的 OKF 对齐示例项目,给同事看 frontmatter 与目录结构长什么样。
status: developing
created: 2026-06-18
ingested: 2026-06-24
tags: [示例, onboarding]
related:
- "[[decision-clientA-tiered-pricing]]"
- "[[conversation-kickoff-20260618]]"
---
# 示例项目Example
> 这是给同事的活样板。新建真实项目请用 `bash tools/kb-init.sh <代号>`,不要复制本目录名 `_example`。
## 概览
虚构的「客户 A 定制化交付」项目,用来演示如何把项目资料结构化沉淀进知识库。
## 进展
- 2026-06-18 项目启动会,确定范围与需求方(见 conversations/
- 2026-06-20 定价策略拍板为阶梯定价(见 decisions/
## 关键决策
- [[decision-clientA-tiered-pricing]] —— 采用阶梯定价而非一口价
## 需求方 / 参与人
- 需求方:客户 A 采购部
- 内部:张三(商务)、李四(交付)
## 资料索引
- `docs/` :外部汇入的正式文档(需求书/合同/方案)
- `conversations/` :聊天记录结构化沉淀
- `decisions/` :决策记录,每条挂溯源
- `assets/` :原始附件(唯一免 frontmatter 目录)

View File

View File

@@ -0,0 +1,31 @@
---
type: conversation
title: "客户 A 项目启动会要点"
description: 启动会摘录:确认交付范围、需求方对接人、首个里程碑时间。
tags: [启动会, 客户-a, 需求]
timestamp: 2026-06-18
source: 会议
source_link: https://company.feishu.cn/minutes/xxxx
author: 李四
created: 2026-06-18
ingested: 2026-06-24
status: developing
related:
- "[[示例项目Example]]"
- "[[decision-clientA-tiered-pricing]]"
---
# 客户 A 项目启动会要点
## 摘录
> 客户 A本年度预算分季度到位希望先小范围试点再扩量。
> 我方李四:可先交付核心模块,二期再接扩展需求。
## 要点
- 交付范围:一期只做核心模块,扩展需求进二期
- 需求方对接人:客户 A 采购部王经理
- 首个里程碑2026-07-15 完成一期验收
- 遗留问题:定价方式待商务确认 → 后续在 [[decision-clientA-tiered-pricing]] 拍板
## 溯源
完整会议纪要见 `source_link`

View File

@@ -0,0 +1,33 @@
---
type: decision
title: "客户 A 报价采用阶梯定价而非一口价"
description: 因客户预算分期到位,改用阶梯定价锁定长期合作,牺牲首单毛利。
tags: [报价, 客户-a, 定价策略]
timestamp: 2026-06-20
source: 飞书群
source_link: https://company.feishu.cn/im/xxxx?msg=99231
author: 张三
created: 2026-06-20
ingested: 2026-06-24
status: mature
related:
- "[[示例项目Example]]"
---
# 客户 A 报价采用阶梯定价而非一口价
## 背景
客户 A 采购部反馈本年度预算分季度到位,一口价方案会卡在首季审批。
## 决策
改用阶梯定价:首单让出约 8 个点毛利换取签下全年框架,后续订单按量回升。
## 依据
- 客户明确表达长期合作意向LTV 显著高于单单毛利
- 竞品报的是一口价,阶梯定价形成差异化
## 参与人 · 时间
- 张三商务、李四交付2026-06-20 飞书群讨论
## 溯源
原始讨论见 `source_link`(飞书群消息锚点)。

View File

View File

@@ -0,0 +1,29 @@
---
type: doc
title: "客户 A 一期需求说明书(汇入)"
description: 从飞书文档汇入的一期需求正式说明,交付范围的权威依据。
tags: [需求, 客户-a, 合同附件]
timestamp: 2026-06-19
source: 飞书文档
source_link: https://company.feishu.cn/docx/xxxxdocxtoken
author: 客户A采购部
created: 2026-06-19
ingested: 2026-06-24
status: mature
related:
- "[[示例项目Example]]"
---
# 客户 A 一期需求说明书(汇入)
> 本页由 `feishu-pull.py` 半自动导出,原文见 `source_link`。外部摄入页 `source`/`source_link` 为必填。
## 一期范围
- 核心模块 A、B
- 不含扩展模块 C进二期
## 验收标准
- 2026-07-15 前完成一期功能验收,缺陷率 < 2%
## 溯源
以飞书原始文档为准,本页为结构化镜像。

View File

@@ -0,0 +1,43 @@
---
type: project
title: "万牛会L1培训"
description: AI数字员工应用实战培训项目8月8-9日线上实训营
status: developing
created: 2026-07-08
ingested: 2026-07-16
tags: [培训, 万牛会, L1, AI]
related:
- "[[课程大纲v1]]"
- "[[小班制20人]]"
---
# 万牛会L1培训
## 概览
**万牛会L1培训**是面向企业员工的 AI 数字员工应用实战培训项目。
- 时间2026年8月8-9日
- 形式:线上实训营
- 目标:帮助学员掌握 Claude Code、Workflow 等工具
## 进展
- ✅ 2026-07-08课程大纲 v1 完成
- ✅ 2026-07-10确定小班制20人/班)
- 🔄 2026-07-16招生筹备中
## 关键决策
- [[小班制20人]] —— 采用小班制20人/班)保证培训质量
## 核心文档
- [[课程大纲v1]] —— 2天课程安排与模块设计
## 参与人
- 项目负责人qianqian
- 讲师团队qianqian主讲+ 技术团队(助教)
- 招生对象:企业员工
## 资料索引
- `docs/` :课程大纲、教学方案
- `decisions/` :培训模式、定价策略等决策
- `conversations/` :团队讨论记录
- `assets/` :课件、录屏等附件

View File

View File

@@ -0,0 +1,45 @@
---
type: decision
title: "万牛会L1培训采用小班制20人/班)"
description: 为保证培训质量和互动效果采用小班制每班不超过20人
tags: [培训, 万牛会, 小班制, L1]
timestamp: 2026-07-10
source: 飞书群
source_link: https://company.feishu.cn/im/chat_placeholder
author: qianqian
status: mature
created: 2026-07-10
ingested: 2026-07-16
related:
- "[[wanniu-l1]]"
---
# 万牛会L1培训采用小班制20人/班)
## 背景
根据之前的培训经验大班制50+人)存在以下问题:
- 学员互动不足
- 讲师无法照顾到每个学员的进度
- 实操环节混乱
## 决策
采用小班制,具体规则:
- 每班不超过20人
- 开多个班次覆盖需求
- 每班配1名讲师 + 1名助教
## 依据
- 参考行业标准AI培训最佳实践建议15-25人/班
- 内部调研:往期学员反馈希望"老师能看到我的操作"
- 成本核算小班制虽然增加人力但完课率提升30%ROI更高
## 参与人
- 决策人qianqian
- 讨论参与:团队全员
- 时间2026-07-10 飞书群讨论
## 影响
- 招生计划从单班50人调整为3班×20人
- 师资需求需额外招2名讲师
- 场地需求需3个独立教室

View File

View File

@@ -0,0 +1,67 @@
---
type: doc
title: "万牛会L1培训 - 课程大纲 v1"
description: AI数字员工应用实战课程大纲包含Claude Code、Workflow编排、实战项目
tags: [课程大纲, 万牛会, L1, AI培训]
timestamp: 2026-07-08
source: 飞书文档
source_link: https://company.feishu.cn/docx/course_outline_placeholder
author: qianqian
status: mature
created: 2026-07-08
ingested: 2026-07-16
related:
- "[[wanniu-l1]]"
- "[[小班制20人]]"
---
# 万牛会L1培训 - 课程大纲 v1
## 课程定位
面向企业员工的 AI 数字员工应用实战培训,帮助学员掌握 Claude Code、Workflow 等工具,构建可复用的自动化技能。
## 课程时长
- 总时长2天8.8-8.9
- 每天9:00-12:00, 14:00-18:00
- 实操占比60%
## 课程模块
### Day 1 上午AI 工具基础
- Claude Code 基本操作1h
- 提示词工程入门1h
- 实战:用 Claude 写第一个脚本1h
### Day 1 下午Workflow 编排
- Workflow 概念与应用场景1h
- 多 Agent 协作模式1.5h
- 实战:构建知识库采集 Workflow1.5h
### Day 2 上午:实战项目
- 项目需求分析0.5h
- 分组实战选择业务场景2h
- 中期答疑0.5h
### Day 2 下午:优化与部署
- Workflow 调优技巧1h
- 部署与监控1h
- 项目展示与点评2h
## 学员要求
- 有基本的文件操作能力
- 会使用命令行更佳(非必须)
- 带笔记本电脑Mac/Windows 均可)
## 师资配置
根据 [[小班制20人]] 决策:
- 每班20人
- 1名讲师 + 1名助教
- 讲师qianqian 主讲
- 助教:技术团队轮值
## 交付物
- 学员项目代码Git 仓库)
- 课程录屏
- 课件 PPT
- 学员反馈问卷