docs: 初始化如愿知识库

This commit is contained in:
qiaoxinjiu
2026-05-26 15:08:20 +08:00
commit 0e85cb0d10
59 changed files with 4371 additions and 0 deletions

1
.obsidian/app.json vendored Normal file
View File

@@ -0,0 +1 @@
{}

3
.obsidian/appearance.json vendored Normal file
View File

@@ -0,0 +1,3 @@
{
"theme": "obsidian"
}

33
.obsidian/core-plugins.json vendored Normal file
View File

@@ -0,0 +1,33 @@
{
"file-explorer": true,
"global-search": true,
"switcher": true,
"graph": true,
"backlink": true,
"canvas": true,
"outgoing-link": true,
"tag-pane": true,
"footnotes": false,
"properties": true,
"page-preview": true,
"daily-notes": true,
"templates": true,
"note-composer": true,
"command-palette": true,
"slash-command": false,
"editor-status": true,
"bookmarks": true,
"markdown-importer": false,
"zk-prefixer": false,
"random-note": false,
"outline": true,
"word-count": true,
"slides": false,
"audio-recorder": false,
"workspaces": false,
"file-recovery": true,
"publish": false,
"sync": true,
"bases": true,
"webviewer": false
}

22
.obsidian/graph.json vendored Normal file
View File

@@ -0,0 +1,22 @@
{
"collapse-filter": true,
"search": "",
"showTags": false,
"showAttachments": false,
"hideUnresolved": false,
"showOrphans": true,
"collapse-color-groups": false,
"colorGroups": [],
"collapse-display": false,
"showArrow": false,
"textFadeMultiplier": 0,
"nodeSizeMultiplier": 1,
"lineSizeMultiplier": 1,
"collapse-forces": true,
"centerStrength": 0.518713248970312,
"repelStrength": 10,
"linkStrength": 1,
"linkDistance": 250,
"scale": 0.9999999999999976,
"close": true
}

226
.obsidian/workspace.json vendored Normal file
View File

@@ -0,0 +1,226 @@
{
"main": {
"id": "cbc7833e6ae0e16b",
"type": "split",
"children": [
{
"id": "80711f127ce5a470",
"type": "tabs",
"children": [
{
"id": "ff990f59633b7f33",
"type": "leaf",
"state": {
"type": "markdown",
"state": {
"file": "05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md",
"mode": "source",
"source": false
},
"icon": "lucide-file",
"title": "20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3"
}
}
]
}
],
"direction": "vertical"
},
"left": {
"id": "ee9f886dd5e7ad74",
"type": "split",
"children": [
{
"id": "a5fafeb928030213",
"type": "tabs",
"children": [
{
"id": "5f88809baca22f4f",
"type": "leaf",
"state": {
"type": "file-explorer",
"state": {
"sortOrder": "alphabetical",
"autoReveal": false
},
"icon": "lucide-folder-closed",
"title": "文件列表"
}
},
{
"id": "444c717a69f391f1",
"type": "leaf",
"state": {
"type": "search",
"state": {
"query": "",
"matchingCase": false,
"explainSearch": false,
"collapseAll": false,
"extraContext": false,
"sortOrder": "alphabetical"
},
"icon": "lucide-search",
"title": "搜索"
}
},
{
"id": "6cdb50be8fd92385",
"type": "leaf",
"state": {
"type": "bookmarks",
"state": {},
"icon": "lucide-bookmark",
"title": "书签"
}
}
]
}
],
"direction": "horizontal",
"width": 300
},
"right": {
"id": "d76d00fd901f4d51",
"type": "split",
"children": [
{
"id": "c6e93b7c0a6b53a5",
"type": "tabs",
"children": [
{
"id": "a3ca721552c50754",
"type": "leaf",
"state": {
"type": "backlink",
"state": {
"file": "05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md",
"collapseAll": false,
"extraContext": false,
"sortOrder": "alphabetical",
"showSearch": false,
"searchQuery": "",
"backlinkCollapsed": false,
"unlinkedCollapsed": true
},
"icon": "links-coming-in",
"title": "20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3 的反向链接列表"
}
},
{
"id": "ffebe63020b4e178",
"type": "leaf",
"state": {
"type": "outgoing-link",
"state": {
"file": "05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md",
"linksCollapsed": false,
"unlinkedCollapsed": true
},
"icon": "links-going-out",
"title": "20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3 的出链列表"
}
},
{
"id": "a137bd7bdab1bff0",
"type": "leaf",
"state": {
"type": "tag",
"state": {
"sortOrder": "frequency",
"useHierarchy": true,
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-tags",
"title": "标签"
}
},
{
"id": "9806bfea20ade829",
"type": "leaf",
"state": {
"type": "all-properties",
"state": {
"sortOrder": "frequency",
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-archive",
"title": "添加笔记属性"
}
},
{
"id": "adfd00e3ffdd3411",
"type": "leaf",
"state": {
"type": "outline",
"state": {
"file": "05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md",
"followCursor": false,
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-list",
"title": "20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3 的大纲"
}
}
]
}
],
"direction": "horizontal",
"width": 300,
"collapsed": true
},
"left-ribbon": {
"hiddenItems": {
"switcher:打开快速切换": false,
"graph:查看关系图谱": false,
"canvas:新建白板": false,
"daily-notes:打开/创建今天的日记": false,
"templates:插入模板": false,
"command-palette:打开命令面板": false,
"bases:新建数据库": false
}
},
"active": "ff990f59633b7f33",
"lastOpenFiles": [
"Git使用说明.md",
"05_需求文档/20260517_USER评价业务闭环_第三步_数据流与中间对象设计_v3.md",
"02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md",
"20260517_USER评价业务闭环_共用能力图与渠道专属流程_v2.2.md",
"00_首页/知识地图.md",
"未命名.canvas",
"08_测试相关/上线检查模板.md",
"08_测试相关/验收记录模板.md",
"08_测试相关/缺陷记录模板.md",
"08_测试相关/测试计划模板.md",
"08_测试相关/测试用例模板.md",
"08_测试相关/测试用例索引.md",
"08_测试相关/README.md",
"07_技术文档/技术决策记录.md",
"07_技术文档/接口说明模板.md",
"07_技术文档/系统架构说明模板.md",
"07_技术文档/技术文档索引.md",
"07_技术文档/README.md",
"06_里程碑/里程碑评审记录.md",
"06_里程碑/阶段计划模板.md",
"06_里程碑/里程碑索引.md",
"06_里程碑/README.md",
"08_测试相关",
"07_技术文档",
"06_里程碑",
"02_项目管理流程/阶段1_业务需求完整形成.md",
"05_需求文档/需求文档索引.md",
"05_需求文档/README.md",
"05_需求文档",
"01_业务流程/业务补充验证记录.md",
"04_Agent检索/知识库持续更新与验证流程.md",
"99_归档",
"04_Agent检索",
"03_规范与模板",
"02_项目管理流程",
"01_业务流程",
"00_首页"
]
}

View File

@@ -0,0 +1,55 @@
---
type: agent_entry
tags: [Agent, 问答, 检索]
aliases: [问答入口, Agent入口]
source: manual
status: active
owner: 内部技术团队
updated: 2026-05
---
# Agent 问答入口
当用户询问业务或项目流程时Agent 应先检索本知识库 Markdown 文件,再组织回答。
## 推荐检索顺序
1. `05_需求文档/`:持续新增的业务需求、业务规则、需求变更。
2. `06_里程碑/`:项目节点、阶段计划、阶段评审、上线节奏。
3. `07_技术文档/`:架构、接口、数据模型、实现方案、技术决策。
4. `08_测试相关/`:测试计划、测试用例、缺陷、验收、上线检查。
5. `02_项目管理流程/`:阶段、角色、交付物、门禁、检查清单。
6. `01_业务流程/`:具体业务流程、业务对象、业务规则。
7. `04_Agent检索/`:关键词、同义词、回答规则、来源索引。
8. `03_规范与模板/`:需要产出文档或表单时检索。
## 回答格式
- 先给结论。
- 再按阶段、负责人、输入、关键动作、输出、检查点说明。
- 最后注明来源文件。
- 若知识库没有明确记录,回答“知识库未明确记录”,并说明建议补充到哪个文件。
## 示例问题
- 一个内部系统需求从提出到上线要走哪些阶段?
- 阶段2.5测试提前补漏要产出什么?
- 业务主管在项目入口分级中负责什么?
- 什么时候需要前端提前参与需求收敛?
- 新增一条业务规则后,怎么验证 Agent 能搜到?
- 某个业务规则应该补充到哪个模板里?
- 某个需求对应哪些测试用例?
- 某个模块有哪些接口说明?
- 这个项目当前处在哪个里程碑?
## 业务补充验证入口
- 需求文档目录:`05_需求文档/`
- 里程碑目录:`06_里程碑/`
- 技术文档目录:`07_技术文档/`
- 测试相关目录:`08_测试相关/`
- 需求文档索引:`05_需求文档/需求文档索引.md`
- 测试用例索引:`08_测试相关/测试用例索引.md`
- 模板:`03_规范与模板/业务规则与需求补充模板.md`
- 流程:`04_Agent检索/知识库持续更新与验证流程.md`
- 记录:`01_业务流程/业务补充验证记录.md`

59
00_首页/知识地图.md Normal file
View File

@@ -0,0 +1,59 @@
---
type: map
tags: [知识地图, 导航]
aliases: [知识库地图]
source: manual
status: active
owner: 内部技术团队
updated: 2026-05
---
# 知识地图
## 需求文档
- [[../05_需求文档/README|需求文档入口]]
- [[../05_需求文档/需求文档索引|需求文档索引]]
- [[../03_规范与模板/需求说明模板|需求说明模板]]
- [[../03_规范与模板/业务规则与需求补充模板|业务规则与需求补充模板]]
- [[../01_业务流程/业务规则索引|业务规则索引]]
- [[../01_业务流程/业务对象字典|业务对象字典]]
## 里程碑
- [[../06_里程碑/README|里程碑入口]]
- [[../06_里程碑/里程碑索引|里程碑索引]]
- [[../06_里程碑/阶段计划模板|阶段计划模板]]
- [[../06_里程碑/里程碑评审记录|里程碑评审记录]]
- [[../02_项目管理流程/AI驱动内部系统开发流程_V3_总览|项目管理流程总览]]
- [[../02_项目管理流程/阶段交付物清单|阶段交付物清单]]
- [[../02_项目管理流程/项目检查清单|项目检查清单]]
## 技术文档
- [[../07_技术文档/README|技术文档入口]]
- [[../07_技术文档/技术文档索引|技术文档索引]]
- [[../07_技术文档/系统架构说明模板|系统架构说明模板]]
- [[../07_技术文档/接口说明模板|接口说明模板]]
- [[../07_技术文档/技术决策记录|技术决策记录]]
## 测试相关
- [[../08_测试相关/README|测试相关入口]]
- [[../08_测试相关/测试用例索引|测试用例索引]]
- [[../08_测试相关/测试用例模板|测试用例模板]]
- [[../08_测试相关/测试计划模板|测试计划模板]]
- [[../08_测试相关/缺陷记录模板|缺陷记录模板]]
- [[../08_测试相关/验收记录模板|验收记录模板]]
- [[../08_测试相关/上线检查模板|上线检查模板]]
- [[../02_项目管理流程/阶段2.5_测试提前补漏|阶段2.5 测试提前补漏]]
- [[../02_项目管理流程/阶段4_测试培训上线回流|阶段4 测试培训上线回流]]
## Agent 检索
- [[../04_Agent检索/检索说明|检索说明]]
- [[../04_Agent检索/问答提示词|问答提示词]]
- [[../04_Agent检索/关键词索引|关键词索引]]
- [[../04_Agent检索/同义词表|同义词表]]
- [[../04_Agent检索/来源文件索引|来源文件索引]]
- [[../04_Agent检索/知识库持续更新与验证流程|持续更新与验证流程]]

View File

@@ -0,0 +1,37 @@
---
type: index
tags: [知识库, 首页, 如愿]
aliases: [如愿知识库首页, 知识库入口]
source: manual
status: active
owner: 内部技术团队
updated: 2026-05
---
# 如愿知识库首页
本知识库用于沉淀如愿内部系统建设中的业务流程、项目管理流程、角色职责、交付物、检查清单与 Agent 检索问答规范。
## 快速入口
- [[知识地图]]
- [[Agent问答入口]]
- [[../05_需求文档/README|需求文档]]
- [[../06_里程碑/README|里程碑]]
- [[../07_技术文档/README|技术文档]]
- [[../08_测试相关/README|测试相关]]
- [[../04_Agent检索/检索说明|Agent 检索说明]]
## 当前权威来源
- 项目管理流程:`AI_驱动_内部系统开发流程_V3.docx`
- 适用范围ERP、内部系统、小型业务系统、运营工具、AI 辅助开发项目。
## 使用原则
1. 需求类问题先查需求文档。
2. 进度、节点、准入问题先查里程碑。
3. 技术实现、接口、架构问题先查技术文档。
4. 测试范围、用例、验收、缺陷问题先查测试相关。
5. Agent 回答必须说明来源文件。
6. 知识库没有明确记录时,不要猜测,应提示补充位置。

27
01_业务流程/README.md Normal file
View File

@@ -0,0 +1,27 @@
---
type: index
tags: [业务流程, 入口]
aliases: [业务流程入口]
source: manual
status: active
owner: 业务主管
updated: 2026-05
---
# 业务流程
本目录用于沉淀真实业务流程。第一阶段先建立模板、业务对象字典和业务规则索引,后续按流程逐条补充。
## 当前文件
- [[业务流程模板]]
- [[业务对象字典]]
- [[业务规则索引]]
## 录入要求
每条业务流程至少补充:流程名称、适用角色、触发条件、主流程、分支流程、异常处理、输入数据、输出结果、相关系统、业务规则、常见问题、关联项目管理阶段。
## 与项目管理流程的关系
业务流程内容主要用于支撑 [[../02_项目管理流程/阶段1_业务需求完整形成|阶段1 业务需求完整形成]] 和 [[../02_项目管理流程/阶段2_高保真模型与业务对象确认|阶段2 高保真模型与业务对象确认]]。

View File

@@ -0,0 +1,30 @@
---
type: dictionary
tags: [业务对象, 数据对象, 字典]
aliases: [业务对象模型, 对象字典]
source: manual
status: draft
owner: 业务主管
updated: 2026-05
---
# 业务对象字典
用于沉淀业务对象、字段、状态和生命周期是页面、接口、数据库、测试、AI 提示词的共同基础。
## 对象清单
| 业务对象 | 定义 | 关键字段 | 状态 | 关联流程 | 备注 |
|---|---|---|---|---|---|
| | | | | | |
## 维护规则
- 阶段2必须确认统一业务对象模型。
- 新增页面、接口、数据库表或测试用例时,应回查本字典。
- 字段含义、状态枚举和对象关系不明确时,不应进入正式开发。
## 关联条目
- [[../02_项目管理流程/阶段2_高保真模型与业务对象确认]]
- [[../02_项目管理流程/阶段交付物清单]]

View File

@@ -0,0 +1,72 @@
---
type: template
tags: [业务流程, 模板]
aliases: [业务流程梳理模板]
source: manual
status: active
owner: 业务主管
updated: 2026-05
---
# 业务流程模板
## 基本信息
- 流程名称:
- 适用部门:
- 适用角色:
- 相关系统:
- 流程负责人:
- 当前状态draft / active / deprecated
## 触发条件
说明什么情况下进入该流程。
## 前置条件
说明流程开始前必须满足的条件、权限、数据或审批。
## 主流程
1.
2.
3.
## 分支流程
| 分支场景 | 判断条件 | 处理方式 | 负责人 | 输出 |
|---|---|---|---|---|
| | | | | |
## 异常处理
| 异常场景 | 发现方式 | 处理方式 | 升级路径 |
|---|---|---|---|
| | | | |
## 输入数据
| 数据项 | 来源 | 必填 | 说明 |
|---|---|---|---|
| | | | |
## 输出结果
| 输出物 | 接收方 | 用途 |
|---|---|---|
| | | |
## 业务规则
-
## 常见问题
- 问:
答:
## 关联项目管理阶段
- [[../02_项目管理流程/阶段1_业务需求完整形成]]
- [[../02_项目管理流程/阶段2_高保真模型与业务对象确认]]

View File

@@ -0,0 +1,36 @@
---
type: validation_log
tags: [业务流程, 业务规则, 验证记录, Agent检索]
aliases: [业务补充验证, Agent问答验证记录]
source: manual
status: active
owner: 产品经理 / 内部技术团队
updated: 2026-05
---
# 业务补充验证记录
## 使用说明
每次新增或修订 `01_业务流程/` 下的业务规则、需求或流程文档后,在此记录 Agent 检索验证结果。
## 验证记录
| 日期 | 业务域 | 新增/修订文件 | 验证问题 | 是否命中 | 来源文件 | 结果 | 待补充 |
|---|---|---|---|---|---|---|---|
| | | | | 是/否 | | 通过/失败 | |
## 验证结论模板
```markdown
### YYYY-MM-DD 业务域_规则或需求名称
- 新增/修订文件:
- 已更新索引:业务规则索引 / 业务对象字典 / 关键词索引 / 同义词表 / 来源文件索引
- 验证问题:
1.
2.
3.
- 结论:通过 / 失败
- 待补充:
```

View File

@@ -0,0 +1,25 @@
---
type: index
tags: [业务规则, 索引]
aliases: [规则索引]
source: manual
status: draft
owner: 业务主管
updated: 2026-05
---
# 业务规则索引
用于集中记录跨流程复用的业务规则,避免规则散落在需求、页面和测试用例中。
| 规则编号 | 规则名称 | 适用流程 | 规则说明 | 来源 | 状态 |
|---|---|---|---|---|---|
| BR-001 | | | | | draft |
## 维护要求
- 规则必须能追溯到业务流程或项目文档。
- 涉及权限、状态流转、金额、时间、审批、异常处理的规则应优先沉淀。
- 规则变更后,应同步检查测试用例和上线培训材料。
- 新增规则建议使用 `03_规范与模板/业务规则与需求补充模板.md`
- 新增或修订后,按 `04_Agent检索/知识库持续更新与验证流程.md` 执行 Agent 检索验证。

View File

@@ -0,0 +1,123 @@
---
type: process_overview
tags: [项目管理流程, AI驱动开发, ERP, 内部系统]
aliases: [AI驱动内部系统开发流程, 内部系统开发流程V3, ERP开发流程]
source: AI_驱动_内部系统开发流程_V3.docx
status: active
owner: 内部技术团队
updated: 2026-05
---
# AI 驱动内部系统开发流程 V3 总览
## 版本定位
本流程适用于公司当前阶段的 ERP、内部系统、小型业务系统、运营工具、AI 辅助开发项目。
核心目标不是让流程变复杂,而是解决以下问题:
- 业务需求说不清。
- AI 生成内容不完整。
- 前端模型介入太晚。
- 后端数据库设计被页面倒逼。
- 测试太晚才发现需求漏项。
- 项目完成后留下大量重复代码和技术债。
## 总体阶段
| 阶段 | 阶段名称 | 核心目标 | 核心负责人 |
|---|---|---|---|
| 阶段0 | 项目入口分级 | 判断项目是否值得做、走轻流程还是完整流程 | 业务主管 / 技术负责人 |
| 阶段1 | 业务需求完整形成 | 业务侧通过 Vibe Coding 跑完整需求 | 业务主管 / 业务人员 |
| 阶段2 | 高保真模型与业务对象确认 | 把完整但粗糙的需求收敛成可开发模型 | 前端 / 产品经理 |
| 阶段2.5 | 测试提前补漏 | 在开发前用测试视角发现需求漏洞 | 测试 |
| 阶段3 | 研发协作与正式开发 | 基于高保真模型进行模块化、安全、可维护开发 | 前端 / 后端 / 算法 |
| 阶段4 | 测试、培训、上线、回流 | 完成测试、培训、上线验收和问题回流 | 测试 / 业务主管 |
| 阶段5 | 技术债治理与能力沉淀 | 清理 AI 冗余代码并沉淀复用能力 | 技术负责人 |
## 阶段门禁
| 门禁 | 通过标准 |
|---|---|
| Gate 0 | 项目入口通过:确认值得做,确认项目类型。 |
| Gate 1 | 需求完整通过:主流程、分支、页面、按钮、字段、状态大致完整。 |
| Gate 2 | 高保真模型通过页面收敛、按钮行为、业务对象、状态、V1/V2 明确。 |
| Gate 2.5 | 测试补漏:测试用例初稿发现的阻塞问题已处理。 |
| Gate 3 | 开发联调通过:前后端、数据库、权限、安全、主要流程联调完成。 |
| Gate 4 | 上线验收通过:测试通过、业务确认、培训完成。 |
| Gate 5 | 技术债治理完成:重复代码、组件、接口、数据结构完成治理或进入债务池。 |
## 完整版文件结构
- `00_项目入口分级.md`
- `01_主流程说明.md`
- `02_日常操作页面结构.md`
- `03_功能页面按钮盘点表.md`
- `04_分支流程_XXX.md`
- `05_异常流程_XXX.md`
- `06_VibeCoding页面验证记录.md`
- `07_高保真模型.html`
- `07_高保真模型说明.md`
- `08_项目周期与版本确认.md`
- `09_前端技术评审.md`
- `10_技术预检记录.md`
- `10A_统一业务对象模型.md`
- `10B_按钮行为矩阵.md`
- `11_测试用例初稿与需求补漏.md`
- `12_研发任务拆分与协作计划.md`
- `13_技术实现对接.md`
- `14_代码治理与安全规范.md`
- `15_开发问题与联调记录.md`
- `16_正式测试报告.md`
- `17_内部培训手册.md`
- `18_上线验收记录.md`
- `19_上线问题与回流需求.md`
- `20_技术债清单.md`
- `21_业务原子能力沉淀清单.md`
- `22_组件库与服务复用清单.md`
- `23_AI开发上下文模板更新记录.md`
## 轻量版文件结构
小项目可以使用轻量版:
- `00_项目入口分级.md`
- `01_业务需求包.md`
- `02_高保真模型包.md`
- `03_项目版本与技术预检.md`
- `04_测试用例初稿与需求补漏.md`
- `05_研发协作与技术实现包.md`
- `06_代码治理与安全规范.md`
- `07_测试培训上线包.md`
- `08_技术债与能力沉淀包.md`
## 最终核心原则
- 先分级,再开发。
- 阶段1追求需求完整不追求产品完善。
- Vibe Coding 页面只是需求原型,不直接进入生产。
- 阶段2追求模型高效前端必须深度参与。
- 高保真模型确认后,才允许正式开发。
- 统一业务对象模型是页面、接口、数据库、测试、AI 提示词的共同基础。
- 性能、安全、权限、并发、日志、可回滚必须提前预检。
- 测试提前补漏,不只是上线前找 Bug。
- 研发阶段以代码质量、模块化、安全性、可维护性为中心。
- AI 代码必须治理,不能直接堆进生产。
- 每个项目都要沉淀业务原子能力。
- 每完成 3-4 个项目,必须进行技术债治理。
## 一句话总结
这套流程不是为了让 AI 替代开发,而是让 AI 帮业务更快形成完整需求,让前端和产品把需求收敛成高保真模型,让研发团队基于模型高质量开发,让测试和技术债治理保障系统长期可用。
## 关联条目
- [[阶段0_项目入口分级]]
- [[阶段1_业务需求完整形成]]
- [[阶段2_高保真模型与业务对象确认]]
- [[阶段2.5_测试提前补漏]]
- [[阶段3_研发协作与正式开发]]
- [[阶段4_测试培训上线回流]]
- [[角色职责矩阵]]
- [[阶段交付物清单]]
- [[项目检查清单]]

View File

@@ -0,0 +1,34 @@
---
type: index
tags: [项目管理流程, AI驱动开发]
aliases: [项目管理流程入口, 开发流程入口]
source: AI_驱动_内部系统开发流程_V3.docx
status: active
owner: 内部技术团队
updated: 2026-05
---
# 项目管理流程
本目录基于 `AI_驱动_内部系统开发流程_V3.docx` 拆解,用于指导 ERP、内部系统、小型业务系统、运营工具、AI 辅助开发项目。
## 阶段文件
- [[AI驱动内部系统开发流程_V3_总览]]
- [[阶段0_项目入口分级]]
- [[阶段1_业务需求完整形成]]
- [[阶段2_高保真模型与业务对象确认]]
- [[阶段2.5_测试提前补漏]]
- [[阶段3_研发协作与正式开发]]
- [[阶段4_测试培训上线回流]]
## 重组索引
- [[角色职责矩阵]]
- [[阶段交付物清单]]
- [[项目检查清单]]
- [[常见问题FAQ]]
## 核心原则
先分级再开发。阶段1追求需求完整不追求产品完善。高保真模型确认后才允许正式开发。测试要提前补漏。AI 代码必须治理,不能直接堆进生产。

View File

@@ -0,0 +1,65 @@
---
type: faq
tags: [项目管理流程, FAQ, 问答]
aliases: [流程常见问题, 项目管理问答]
source: AI_驱动_内部系统开发流程_V3.docx
status: active
owner: 内部技术团队
updated: 2026-05
---
# 常见问题 FAQ
## 一个内部系统需求从提出到上线要走哪些阶段?
通常经过阶段0项目入口分级、阶段1业务需求完整形成、阶段2高保真模型与业务对象确认、阶段2.5测试提前补漏、阶段3研发协作与正式开发、阶段4测试培训上线回流。文档还定义了阶段5技术债治理与能力沉淀。
来源:[[AI驱动内部系统开发流程_V3_总览]]
## 阶段0项目入口分级由谁负责
由业务主管和技术负责人共同负责。业务主管判断业务价值和范围,技术负责人判断技术复杂度和风险。
来源:[[阶段0_项目入口分级]]、[[角色职责矩阵]]
## 业务需求完整形成阶段的目标是什么?
业务侧通过 Vibe Coding 跑完整需求。阶段1追求需求完整不追求产品完善。
来源:[[阶段1_业务需求完整形成]]
## 阶段2.5测试提前补漏应该在什么时候发生?
发生在高保真模型确认后、正式开发前。
来源:[[阶段2.5_测试提前补漏]]
## 阶段2.5测试提前补漏要产出什么?
主要产出 `11_测试用例初稿与需求补漏.md`,并形成需求补漏记录、阻塞问题清单和已关闭问题清单。
来源:[[阶段2.5_测试提前补漏]]、[[阶段交付物清单]]
## 什么时候需要前端提前参与需求收敛?
阶段2必须由前端深度参与。若需求涉及多页面、复杂交互、权限、状态流转、数据结构或组件复用前端应在需求收敛时提前参与。
来源:[[阶段2_高保真模型与业务对象确认]]
## 研发协作与正式开发阶段如何保证模块化、安全和可维护?
依赖统一业务对象模型、研发任务拆分、技术实现对接、代码治理与安全规范、开发问题与联调记录。AI 代码必须经过治理,不能直接堆进生产。
来源:[[阶段3_研发协作与正式开发]]
## 上线前需要检查哪些事项?
至少检查正式测试、主流程、分支流程、权限、异常、数据边界、内部培训手册、业务确认、上线问题回流机制。
来源:[[阶段4_测试培训上线回流]]、[[项目检查清单]]
## Vibe Coding 页面能不能直接进入生产?
不能。Vibe Coding 页面只是需求原型,不直接进入生产。
来源:[[阶段1_业务需求完整形成]]、[[AI驱动内部系统开发流程_V3_总览]]

View File

@@ -0,0 +1,84 @@
---
type: responsibility_matrix
tags: [项目管理流程, 角色职责, RACI]
aliases: [角色职责, 职责矩阵, RACI]
source: AI_驱动_内部系统开发流程_V3.docx
status: active
owner: 内部技术团队
updated: 2026-05
---
# 角色职责矩阵
## 总览
| 角色 | 主要负责阶段 | 核心职责 | 典型产出 |
|---|---|---|---|
| 业务主管 | 阶段0、阶段1、阶段4 | 判断项目价值、明确主流程、确认业务完整性、上线验收 | 项目入口分级、主流程说明、业务验收口径、上线验收记录 |
| 业务人员 | 阶段1 | 补充分支流程、提供样本数据、验证真实操作路径 | 分支流程、异常流程、Vibe Coding 页面验证记录 |
| 产品经理 | 阶段2 | 收敛需求、组织高保真模型、明确版本范围 | 高保真模型说明、项目周期与版本确认 |
| 前端 | 阶段2、阶段3 | 深度参与模型收敛、页面结构、按钮行为、组件复用、前端开发 | 高保真模型、前端技术评审、按钮行为矩阵、前端实现 |
| 后端 | 阶段3 | 设计接口、数据库、权限、安全、日志、回滚和服务能力 | 技术实现对接、后端服务、接口和数据库方案 |
| 算法 | 阶段3 | 判断是否需要 AI设计输入输出、置信度、人工审核和风险控制 | 算法适用性判断、算法输入输出说明、置信度规则 |
| 测试 | 阶段2.5、阶段4 | 提前写测试用例、发现需求漏洞、正式测试、培训材料、上线反馈 | 测试用例初稿、正式测试报告、内部培训手册、上线问题回流 |
| 技术负责人 | 阶段0、阶段5 | 技术分级、风险判断、技术债治理和能力沉淀 | 技术债清单、业务原子能力沉淀清单、组件库与服务复用清单 |
## 业务主管
业务主管保证方向正确、主流程清楚、需求不漏大块。
职责:
- 判断项目是否值得做。
- 定义主流程。
- 定义日常操作入口。
- 明确业务人员每天先看什么页面。
- 拆分分支流程,指定业务人员补充。
- 确认异常流程。
- 确认业务完整性。
- 参与业务验收。
## 业务人员
业务人员负责具体分支流程和真实操作细节。
职责:
- 补充分支流程。
- 提供样本数据,例如 ASIN、订单、评论、用户、表格等真实样本。
- 使用 Vibe Coding 跑页面,验证是否符合真实操作。
- 补充异常场景。
## 算法
算法保证 AI 能力可控、可解释、可人工审核。
职责:
- 判断是否需要 AI避免为了 AI 而 AI。
- 设计算法输入,明确模型需要哪些数据。
- 设计算法输出,明确 AI 返回什么结果。
- 制定置信度规则。
- 制定人工审核机制。
- 设计风险控制,确保 AI 判断错误时可以回退和纠正。
## 测试
测试不只是最后找 Bug还要提前补漏并负责内部培训材料。
职责:
- 高保真模型出来后先写测试用例。
- 用测试视角发现流程、按钮、权限遗漏。
- 正式测试主流程、分支流程、权限、异常和数据。
- 输出验收报告。
- 将测试用例转成业务操作手册。
- 记录上线问题并回流需求池。
## 关联条目
- [[AI驱动内部系统开发流程_V3_总览]]
- [[阶段0_项目入口分级]]
- [[阶段1_业务需求完整形成]]
- [[阶段2.5_测试提前补漏]]
- [[阶段4_测试培训上线回流]]

View File

@@ -0,0 +1,86 @@
---
type: process_stage
tags: [项目管理流程, 阶段0, 项目入口, 分级, 立项]
aliases: [项目入口分级, 入口分级, Gate 0, 立项分级]
source: AI_驱动_内部系统开发流程_V3.docx
status: active
owner: 业务主管 / 技术负责人
updated: 2026-05
---
# 阶段0 项目入口分级
## 核心目标
不是所有需求都应该进入完整开发流程。阶段0用于判断项目是否值得做以及走轻流程还是完整流程。
## 负责人
- 业务主管
- 技术负责人
## 输入
- 业务提出的问题或机会。
- 现有系统痛点。
- 业务收益、风险、范围的初步判断。
## 项目分类
| 类型 | 适用场景 | 流程要求 |
|---|---|---|
| S 类 | 小需求,单页面、小改动、无复杂数据 | 可简化阶段1和阶段2。 |
| M 类 | 中等需求,涉及多个页面、多个角色或状态流转 | 建议走完整阶段0-4。 |
| L 类 | 大型需求,涉及核心流程、多个部门、复杂权限、数据模型或算法 | 必须走完整流程,并强化技术预检和阶段门禁。 |
## 关键动作
- 判断需求是否值得做。
- 判断项目影响范围。
- 判断是否需要完整流程。
- 判断是否涉及复杂数据、权限、算法、外部系统或高风险流程。
- 初步指定业务负责人和技术负责人。
## 输出/交付物
- `00_项目入口分级.md`
- 项目类型S / M / L。
- 是否进入完整流程的结论。
- 初步负责人。
- 初步范围和风险。
## 检查清单
- [ ] 是否确认需求要解决的真实业务问题?
- [ ] 是否确认该需求值得做?
- [ ] 是否确认项目类型?
- [ ] 是否确认走轻流程还是完整流程?
- [ ] 是否识别复杂权限、数据、算法、并发、安全或外部系统风险?
- [ ] 是否明确业务主管和技术负责人?
## 风险点
- 小需求被过度流程化,降低效率。
- 大需求被当成小需求处理,后续返工。
- 没有识别权限、数据、安全、算法风险。
- 没有业务负责人,需求持续漂移。
## Gate 0 通过标准
项目入口通过:确认值得做,确认项目类型。
## 常见问题
### 阶段0由谁负责
由业务主管和技术负责人共同负责。业务主管判断业务价值和业务范围,技术负责人判断技术复杂度和风险。
### 小需求是否必须走完整流程?
不一定。S 类小需求可以简化阶段1和阶段2但仍应保留基本入口判断、测试和上线验收。
## 关联条目
- [[AI驱动内部系统开发流程_V3_总览]]
- [[角色职责矩阵]]
- [[阶段交付物清单]]

View File

@@ -0,0 +1,83 @@
---
type: process_stage
tags: [项目管理流程, 阶段1, 业务需求, VibeCoding, 需求完整]
aliases: [业务需求完整形成, 提需求, 需求梳理, Gate 1]
source: AI_驱动_内部系统开发流程_V3.docx
status: active
owner: 业务主管 / 业务人员
updated: 2026-05
---
# 阶段1 业务需求完整形成
## 核心目标
业务侧通过 Vibe Coding 跑完整需求。阶段1追求需求完整不追求产品完善。
## 负责人
- 业务主管
- 业务人员
## 输入
- 阶段0入口分级结论。
- 业务痛点、业务目标、现有流程。
- 业务人员真实操作经验。
## 关键动作
- 梳理主流程。
- 明确日常操作页面结构。
- 盘点功能页面和按钮。
- 补充分支流程。
- 补充异常流程。
- 使用 Vibe Coding 生成或验证需求原型。
- 记录页面验证结果。
## 输出/交付物
- `01_主流程说明.md`
- `02_日常操作页面结构.md`
- `03_功能页面按钮盘点表.md`
- `04_分支流程_XXX.md`
- `05_异常流程_XXX.md`
- `06_VibeCoding页面验证记录.md`
## 检查清单
- [ ] 主流程是否能从开始走到结束?
- [ ] 日常操作入口是否清楚?
- [ ] 页面、按钮、字段是否大致完整?
- [ ] 分支流程是否由真实业务人员补充?
- [ ] 异常流程是否覆盖无负责人、超时、数据缺失等情况?
- [ ] Vibe Coding 原型是否经过业务侧走查?
- [ ] 是否明确哪些内容只是原型,不可直接进入生产?
## 风险点
- 只描述主流程,漏掉分支和异常。
- 把 Vibe Coding 页面当成可生产代码。
- 业务主管只给方向,没有安排业务人员补充真实操作细节。
- 页面、按钮、字段未盘点导致阶段2和开发阶段返工。
## Gate 1 通过标准
需求完整通过:主流程、分支、页面、按钮、字段、状态大致完整。
## 常见问题
### 阶段1追求什么
追求需求完整,不追求产品完善。页面可以粗糙,但业务流程、分支、异常、按钮、字段不能漏大块。
### Vibe Coding 页面能不能直接上线?
不能。Vibe Coding 页面只是需求原型,不直接进入生产。
## 关联条目
- [[阶段0_项目入口分级]]
- [[阶段2_高保真模型与业务对象确认]]
- [[角色职责矩阵]]
- [[阶段交付物清单]]

View File

@@ -0,0 +1,79 @@
---
type: process_stage
tags: [项目管理流程, 阶段2.5, 测试, 需求补漏, 测试用例]
aliases: [测试提前补漏, 开发前测试, Gate 2.5, 测试用例初稿]
source: AI_驱动_内部系统开发流程_V3.docx
status: active
owner: 测试
updated: 2026-05
---
# 阶段2.5 测试提前补漏
## 核心目标
在开发前用测试视角发现需求漏洞。测试提前补漏,不只是上线前找 Bug。
## 负责人
- 测试
## 输入
- 高保真模型。
- 高保真模型说明。
- 统一业务对象模型。
- 按钮行为矩阵。
- 项目周期与版本确认。
## 关键动作
- 基于高保真模型先写测试用例初稿。
- 从主流程、分支流程、权限、异常、数据、按钮行为视角检查遗漏。
- 标记阻塞开发的问题。
- 将需求漏洞回流给业务、产品、前端补齐。
- 确认阻塞问题处理后再进入正式开发。
## 输出/交付物
- `11_测试用例初稿与需求补漏.md`
- 需求补漏记录。
- 阻塞问题清单。
- 已关闭问题清单。
## 检查清单
- [ ] 是否已基于高保真模型编写测试用例初稿?
- [ ] 是否覆盖主流程?
- [ ] 是否覆盖分支流程?
- [ ] 是否覆盖权限?
- [ ] 是否覆盖异常场景?
- [ ] 是否覆盖关键数据和状态?
- [ ] 是否覆盖按钮行为?
- [ ] 测试发现的阻塞问题是否已关闭?
## 风险点
- 测试只在上线前介入,导致需求漏洞在开发后才暴露。
- 测试用例只覆盖主流程,漏掉权限、异常、分支和数据边界。
- 阻塞问题没有关闭就进入开发。
## Gate 2.5 通过标准
测试补漏:测试用例初稿发现的阻塞问题已处理。
## 常见问题
### 阶段2.5应该在什么时候发生?
发生在高保真模型确认后、正式开发前。
### 阶段2.5要产出什么?
主要产出 `11_测试用例初稿与需求补漏.md`,并形成需求补漏记录、阻塞问题清单和已关闭问题清单。
## 关联条目
- [[阶段2_高保真模型与业务对象确认]]
- [[阶段3_研发协作与正式开发]]
- [[项目检查清单]]

View File

@@ -0,0 +1,81 @@
---
type: process_stage
tags: [项目管理流程, 阶段2, 高保真模型, 业务对象, 前端, 产品]
aliases: [高保真模型确认, 业务对象确认, Gate 2, 统一业务对象模型]
source: AI_驱动_内部系统开发流程_V3.docx
status: active
owner: 前端 / 产品经理
updated: 2026-05
---
# 阶段2 高保真模型与业务对象确认
## 核心目标
把完整但粗糙的需求收敛成可开发模型。阶段2追求模型高效前端必须深度参与。
## 负责人
- 前端
- 产品经理
## 输入
- 阶段1形成的主流程、页面结构、按钮盘点、分支流程、异常流程和 Vibe Coding 验证记录。
## 关键动作
- 将业务原型收敛为高保真模型。
- 明确页面结构、交互、按钮行为和状态变化。
- 确认业务对象、字段、状态和对象关系。
- 明确 V1/V2 范围和项目周期。
- 进行前端技术评审和技术预检。
- 识别性能、安全、权限、并发、日志、可回滚等风险。
## 输出/交付物
- `07_高保真模型.html`
- `07_高保真模型说明.md`
- `08_项目周期与版本确认.md`
- `09_前端技术评审.md`
- `10_技术预检记录.md`
- `10A_统一业务对象模型.md`
- `10B_按钮行为矩阵.md`
## 检查清单
- [ ] 页面是否已经从粗糙原型收敛成可开发模型?
- [ ] 按钮行为是否明确?
- [ ] 业务对象、字段、状态、对象关系是否明确?
- [ ] V1/V2 范围是否明确?
- [ ] 是否完成前端技术评审?
- [ ] 是否完成性能、安全、权限、并发、日志、可回滚预检?
- [ ] 是否明确高保真模型确认后才允许正式开发?
## 风险点
- 前端介入太晚,导致页面、接口、数据库互相倒逼。
- 高保真模型只画页面,没有确认业务对象和状态。
- 没有按钮行为矩阵,开发和测试无法对齐。
- 未提前识别性能、安全、权限、并发、日志、回滚风险。
## Gate 2 通过标准
高保真模型通过页面收敛、按钮行为、业务对象、状态、V1/V2 明确。
## 常见问题
### 什么时候需要前端提前参与?
阶段2必须由前端深度参与。若需求涉及多页面、复杂交互、权限、状态流转、数据结构或组件复用前端应在需求收敛时提前参与。
### 统一业务对象模型为什么重要?
统一业务对象模型是页面、接口、数据库、测试、AI 提示词的共同基础。
## 关联条目
- [[阶段1_业务需求完整形成]]
- [[阶段2.5_测试提前补漏]]
- [[../01_业务流程/业务对象字典]]
- [[阶段交付物清单]]

View File

@@ -0,0 +1,77 @@
---
type: process_stage
tags: [项目管理流程, 阶段3, 研发协作, 正式开发, 代码治理, 安全]
aliases: [研发协作, 正式开发, Gate 3, 开发联调]
source: AI_驱动_内部系统开发流程_V3.docx
status: active
owner: 前端 / 后端 / 算法
updated: 2026-05
---
# 阶段3 研发协作与正式开发
## 核心目标
基于高保真模型进行模块化、安全、可维护开发。研发阶段以代码质量、模块化、安全性、可维护性为中心。
## 负责人
- 前端
- 后端
- 算法
## 输入
- 高保真模型。
- 统一业务对象模型。
- 按钮行为矩阵。
- 测试用例初稿与需求补漏结果。
- 技术预检记录。
## 关键动作
- 拆分研发任务与协作计划。
- 进行前端、后端、算法技术实现对接。
- 明确接口、数据库、权限、安全、日志和回滚方案。
- 按代码治理与安全规范开发。
- 记录开发问题与联调结果。
- 治理 AI 生成代码,不能直接堆进生产。
## 输出/交付物
- `12_研发任务拆分与协作计划.md`
- `13_技术实现对接.md`
- `14_代码治理与安全规范.md`
- `15_开发问题与联调记录.md`
## 检查清单
- [ ] 研发任务是否已拆分?
- [ ] 前后端、数据库、权限、安全、主要流程是否联调完成?
- [ ] 是否按统一业务对象模型设计接口和数据库?
- [ ] 是否处理权限、安全、日志、可回滚?
- [ ] AI 生成代码是否经过人工审查和治理?
- [ ] 是否避免重复代码和不可维护堆叠?
## 风险点
- 开发直接从 Vibe Coding 原型开始,跳过高保真模型。
- AI 生成代码未经治理直接进入生产。
- 缺少模块边界、权限、安全、日志和回滚方案。
- 前后端、数据库、测试使用的业务对象不一致。
## Gate 3 通过标准
开发联调通过:前后端、数据库、权限、安全、主要流程联调完成。
## 常见问题
### 阶段3如何保证模块化、安全和可维护
依赖统一业务对象模型、研发任务拆分、技术实现对接、代码治理与安全规范、开发问题与联调记录。AI 代码必须经过治理,不能直接堆进生产。
## 关联条目
- [[阶段2.5_测试提前补漏]]
- [[阶段4_测试培训上线回流]]
- [[阶段交付物清单]]

View File

@@ -0,0 +1,77 @@
---
type: process_stage
tags: [项目管理流程, 阶段4, 测试, 培训, 上线, 回流]
aliases: [测试培训上线回流, 上线验收, Gate 4]
source: AI_驱动_内部系统开发流程_V3.docx
status: active
owner: 测试 / 业务主管
updated: 2026-05
---
# 阶段4 测试培训上线回流
## 核心目标
完成测试、培训、上线验收和问题回流。测试保证系统真实可用,并帮助业务人员正确使用。
## 负责人
- 测试
- 业务主管
## 输入
- 开发联调完成的系统。
- 测试用例。
- 高保真模型和业务对象模型。
- 开发问题与联调记录。
## 关键动作
- 进行正式测试。
- 验证主流程、分支流程、权限、异常和数据。
- 输出正式测试报告。
- 将测试用例转成业务操作手册或内部培训材料。
- 组织业务确认和上线验收。
- 记录上线问题并回流需求池。
## 输出/交付物
- `16_正式测试报告.md`
- `17_内部培训手册.md`
- `18_上线验收记录.md`
- `19_上线问题与回流需求.md`
## 检查清单
- [ ] 正式测试是否通过?
- [ ] 主流程是否验证通过?
- [ ] 分支流程是否验证通过?
- [ ] 权限是否验证通过?
- [ ] 异常和数据边界是否验证通过?
- [ ] 内部培训手册是否完成?
- [ ] 业务主管是否完成上线确认?
- [ ] 上线问题是否记录并回流?
## 风险点
- 只测功能,不测权限、异常、数据和实际操作路径。
- 没有培训材料,业务人员不会用。
- 上线问题没有进入回流需求池。
- 业务主管未验收就上线。
## Gate 4 通过标准
上线验收通过:测试通过、业务确认、培训完成。
## 常见问题
### 上线前需要检查哪些事项?
至少检查正式测试、主流程、分支流程、权限、异常、数据边界、内部培训手册、业务确认、上线问题回流机制。
## 关联条目
- [[阶段3_研发协作与正式开发]]
- [[项目检查清单]]
- [[阶段交付物清单]]

View File

@@ -0,0 +1,42 @@
---
type: deliverable_index
tags: [项目管理流程, 交付物, 文件清单]
aliases: [交付物清单, 文件结构, 产出物]
source: AI_驱动_内部系统开发流程_V3.docx
status: active
owner: 内部技术团队
updated: 2026-05
---
# 阶段交付物清单
## 完整版交付物
| 阶段 | 交付物 |
|---|---|
| 阶段0 | `00_项目入口分级.md` |
| 阶段1 | `01_主流程说明.md``02_日常操作页面结构.md``03_功能页面按钮盘点表.md``04_分支流程_XXX.md``05_异常流程_XXX.md``06_VibeCoding页面验证记录.md` |
| 阶段2 | `07_高保真模型.html``07_高保真模型说明.md``08_项目周期与版本确认.md``09_前端技术评审.md``10_技术预检记录.md``10A_统一业务对象模型.md``10B_按钮行为矩阵.md` |
| 阶段2.5 | `11_测试用例初稿与需求补漏.md` |
| 阶段3 | `12_研发任务拆分与协作计划.md``13_技术实现对接.md``14_代码治理与安全规范.md``15_开发问题与联调记录.md` |
| 阶段4 | `16_正式测试报告.md``17_内部培训手册.md``18_上线验收记录.md``19_上线问题与回流需求.md` |
| 阶段5 | `20_技术债清单.md``21_业务原子能力沉淀清单.md``22_组件库与服务复用清单.md``23_AI开发上下文模板更新记录.md` |
## 轻量版交付物
| 阶段包 | 交付物 |
|---|---|
| 入口 | `00_项目入口分级.md` |
| 需求 | `01_业务需求包.md` |
| 模型 | `02_高保真模型包.md` |
| 预检 | `03_项目版本与技术预检.md` |
| 测试补漏 | `04_测试用例初稿与需求补漏.md` |
| 研发 | `05_研发协作与技术实现包.md` |
| 治理 | `06_代码治理与安全规范.md` |
| 上线 | `07_测试培训上线包.md` |
| 沉淀 | `08_技术债与能力沉淀包.md` |
## 关联条目
- [[AI驱动内部系统开发流程_V3_总览]]
- [[项目检查清单]]

View File

@@ -0,0 +1,70 @@
---
type: checklist
tags: [项目管理流程, 检查清单, 门禁]
aliases: [项目门禁检查, 上线检查, 流程检查]
source: AI_驱动_内部系统开发流程_V3.docx
status: active
owner: 内部技术团队
updated: 2026-05
---
# 项目检查清单
## Gate 0 项目入口
- [ ] 确认项目值得做。
- [ ] 确认项目类型S / M / L。
- [ ] 确认走轻流程还是完整流程。
- [ ] 确认业务主管和技术负责人。
## Gate 1 需求完整
- [ ] 主流程完整。
- [ ] 分支流程完整。
- [ ] 页面、按钮、字段大致完整。
- [ ] 状态大致完整。
- [ ] Vibe Coding 页面已验证。
## Gate 2 高保真模型
- [ ] 页面已经收敛。
- [ ] 按钮行为明确。
- [ ] 业务对象明确。
- [ ] 状态明确。
- [ ] V1/V2 明确。
- [ ] 性能、安全、权限、并发、日志、可回滚已预检。
## Gate 2.5 测试补漏
- [ ] 测试用例初稿已完成。
- [ ] 主流程、分支、权限、异常、数据、按钮行为已检查。
- [ ] 阻塞开发的问题已处理。
## Gate 3 开发联调
- [ ] 前后端联调完成。
- [ ] 数据库联调完成。
- [ ] 权限和安全联调完成。
- [ ] 主要流程联调完成。
- [ ] AI 代码已治理。
## Gate 4 上线验收
- [ ] 正式测试通过。
- [ ] 业务确认完成。
- [ ] 培训完成。
- [ ] 上线问题回流机制明确。
## Gate 5 技术债治理
- [ ] 技术债已分类。
- [ ] 必须立即处理的已处理。
- [ ] 可延后的进入技术债池。
- [ ] 可复用组件已沉淀。
- [ ] 可复用后端服务已沉淀。
- [ ] AI 开发上下文模板已更新。
## 关联条目
- [[AI驱动内部系统开发流程_V3_总览]]
- [[阶段交付物清单]]

View File

@@ -0,0 +1,41 @@
---
type: template
tags: [模板, 上线检查]
aliases: [上线模板, 验收模板]
source: manual
status: active
owner: 测试 / 业务主管
updated: 2026-05
---
# 上线检查模板
## 基本信息
- 项目名称:
- 上线版本:
- 上线时间:
- 负责人:
## 上线前检查
- [ ] 正式测试通过。
- [ ] 主流程通过。
- [ ] 分支流程通过。
- [ ] 权限通过。
- [ ] 异常和数据边界通过。
- [ ] 培训材料完成。
- [ ] 业务主管确认。
- [ ] 回滚方案明确。
## 上线验收
| 验收项 | 验收人 | 结果 | 备注 |
|---|---|---|---|
| | | | |
## 上线问题回流
| 问题 | 影响 | 处理优先级 | 负责人 | 状态 |
|---|---|---|---|---|
| | | | | |

View File

@@ -0,0 +1,15 @@
---
type: template
tags: [模板, 业务流程]
aliases: [流程梳理模板]
source: manual
status: active
owner: 业务主管
updated: 2026-05
---
# 业务流程梳理模板
见 [[../01_业务流程/业务流程模板]]。
使用时复制该模板,并按真实业务流程命名保存到 `01_业务流程/` 下。

View File

@@ -0,0 +1,115 @@
---
type: template
tags: [模板, 业务规则, 需求补充, Agent检索]
aliases: [业务补充模板, 规则补充模板, 需求增量模板]
source: manual
status: active
owner: 业务主管 / 产品经理
updated: 2026-05
---
# 业务规则与需求补充模板
> 使用方式:每次新增或修订业务规则时,复制本模板到 `01_业务流程/` 下,并按 `业务域_规则或需求名称_YYYYMMDD.md` 命名。
## 1. 基本信息
| 字段 | 内容 |
|---|---|
| 业务域 | |
| 规则/需求名称 | |
| 提出人 | |
| 负责部门 | |
| 适用角色 | |
| 关联系统 | |
| 版本 | v1.0 |
| 生效状态 | draft / active / deprecated |
| 生效时间 | |
| 最近更新时间 | |
## 2. 背景与目标
- 当前问题:
- 业务目标:
- 不解决的问题:
## 3. 适用范围
- 适用场景:
- 不适用场景:
- 前置条件:
## 4. 业务规则
| 编号 | 规则描述 | 触发条件 | 处理结果 | 优先级 | 例外情况 |
|---|---|---|---|---|---|
| BR-001 | | | | 高/中/低 | |
## 5. 业务流程
### 5.1 主流程
1.
2.
3.
### 5.2 分支流程
| 分支场景 | 判断条件 | 处理方式 | 输出结果 |
|---|---|---|---|
| | | | |
### 5.3 异常处理
| 异常场景 | 识别方式 | 处理方式 | 负责人 |
|---|---|---|---|
| | | | |
## 6. 数据与业务对象
| 业务对象 | 字段 | 字段含义 | 必填 | 来源 | 去向 |
|---|---|---|---|---|---|
| | | | 是/否 | | |
## 7. 权限与操作
| 角色 | 可见范围 | 可执行操作 | 禁止操作 |
|---|---|---|---|
| | | | |
## 8. 验收口径
| 验收点 | 通过标准 | 测试问题 |
|---|---|---|
| | | |
## 9. Agent 检索字段
### 9.1 推荐关键词
-
### 9.2 同义词/口语问法
| 用户可能问法 | 标准术语 | 推荐命中文件 |
|---|---|---|
| | | |
### 9.3 标准问答
| 问题 | 期望答案要点 | 来源章节 |
|---|---|---|
| | | |
## 10. 关联条目
- 关联业务流程:
- 关联项目管理阶段:
- 关联需求说明:
- 关联测试用例:
## 11. 变更记录
| 日期 | 版本 | 变更内容 | 变更人 |
|---|---|---|---|
| | v1.0 | 新增 | |

View File

@@ -0,0 +1,36 @@
---
type: template
tags: [模板, 会议纪要]
aliases: [会议记录模板]
source: manual
status: active
owner: 内部技术团队
updated: 2026-05
---
# 会议纪要模板
## 基本信息
- 会议主题:
- 时间:
- 参会人:
- 记录人:
## 结论
| 编号 | 结论 | 负责人 | 截止时间 |
|---|---|---|---|
| | | | |
## 待办
| 事项 | 负责人 | 截止时间 | 状态 |
|---|---|---|---|
| | | | |
## 风险与问题
| 问题 | 影响 | 处理方式 |
|---|---|---|
| | | |

View File

@@ -0,0 +1,52 @@
---
type: template
tags: [模板, 需求说明]
aliases: [需求模板, 业务需求包]
source: manual
status: active
owner: 产品经理 / 业务主管
updated: 2026-05
---
# 需求说明模板
## 背景与目标
- 背景:
- 要解决的问题:
- 目标用户:
- 预期收益:
## 范围
- V1 范围:
- V2 范围:
- 不包含范围:
## 主流程
1.
2.
3.
## 页面与按钮
| 页面 | 按钮/操作 | 行为说明 | 权限 | 备注 |
|---|---|---|---|---|
| | | | | |
## 业务对象
| 对象 | 字段 | 状态 | 说明 |
|---|---|---|---|
| | | | |
## 分支与异常
| 场景 | 处理方式 | 负责人 |
|---|---|---|
| | | |
## 验收口径
-

View File

@@ -0,0 +1,41 @@
---
type: keyword_index
tags: [Agent, 关键词, 索引]
aliases: [关键词映射]
source: manual
status: active
owner: 内部技术团队
updated: 2026-05
---
# 关键词索引
| 关键词 | 推荐检索文件 |
|---|---|
| 内部系统开发流程 | `02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md` |
| ERP 开发流程 | `02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md` |
| 项目入口 | `02_项目管理流程/阶段0_项目入口分级.md` |
| 项目分级 | `02_项目管理流程/阶段0_项目入口分级.md` |
| S 类 / M 类 / L 类 | `02_项目管理流程/阶段0_项目入口分级.md` |
| 业务需求 | `02_项目管理流程/阶段1_业务需求完整形成.md` |
| Vibe Coding | `02_项目管理流程/阶段1_业务需求完整形成.md` |
| 高保真模型 | `02_项目管理流程/阶段2_高保真模型与业务对象确认.md` |
| 业务对象 | `02_项目管理流程/阶段2_高保真模型与业务对象确认.md``01_业务流程/业务对象字典.md` |
| 按钮行为 | `02_项目管理流程/阶段2_高保真模型与业务对象确认.md` |
| 测试提前补漏 | `02_项目管理流程/阶段2.5_测试提前补漏.md` |
| 测试用例初稿 | `02_项目管理流程/阶段2.5_测试提前补漏.md` |
| 正式开发 | `02_项目管理流程/阶段3_研发协作与正式开发.md` |
| 研发协作 | `02_项目管理流程/阶段3_研发协作与正式开发.md` |
| 代码治理 | `02_项目管理流程/阶段3_研发协作与正式开发.md``02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md` |
| 上线验收 | `02_项目管理流程/阶段4_测试培训上线回流.md` |
| 内部培训 | `02_项目管理流程/阶段4_测试培训上线回流.md` |
| 问题回流 | `02_项目管理流程/阶段4_测试培训上线回流.md` |
| 技术债 | `02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md``02_项目管理流程/项目检查清单.md` |
| 门禁 | `02_项目管理流程/项目检查清单.md` |
| 交付物 | `02_项目管理流程/阶段交付物清单.md` |
| 谁负责 | `02_项目管理流程/角色职责矩阵.md` |
| 业务规则补充 | `03_规范与模板/业务规则与需求补充模板.md``04_Agent检索/知识库持续更新与验证流程.md` |
| 需求补充 | `03_规范与模板/业务规则与需求补充模板.md``03_规范与模板/需求说明模板.md` |
| 新增业务流程 | `03_规范与模板/业务规则与需求补充模板.md``03_规范与模板/业务流程梳理模板.md` |
| 检索验证 | `04_Agent检索/知识库持续更新与验证流程.md``01_业务流程/业务补充验证记录.md` |
| Agent 问答验证 | `04_Agent检索/知识库持续更新与验证流程.md``01_业务流程/业务补充验证记录.md` |

View File

@@ -0,0 +1,31 @@
---
type: synonym_table
tags: [Agent, 同义词, 检索]
aliases: [口语映射, 术语映射]
source: manual
status: active
owner: 内部技术团队
updated: 2026-05
---
# 同义词表
| 用户说法 | 标准术语 | 推荐检索文件 |
|---|---|---|
| 提需求 | 业务需求完整形成 / 项目入口分级 | `阶段1_业务需求完整形成.md``阶段0_项目入口分级.md` |
| 立项 | 项目入口分级 | `阶段0_项目入口分级.md` |
| 原型 | Vibe Coding 页面 / 高保真模型 | `阶段1_业务需求完整形成.md``阶段2_高保真模型与业务对象确认.md` |
| 页面模型 | 高保真模型 | `阶段2_高保真模型与业务对象确认.md` |
| 字段字典 | 业务对象模型 | `阶段2_高保真模型与业务对象确认.md``业务对象字典.md` |
| 开发前测试 | 测试提前补漏 | `阶段2.5_测试提前补漏.md` |
| 测试先看 | 测试提前补漏 | `阶段2.5_测试提前补漏.md` |
| 开发怎么开始 | 研发协作与正式开发 | `阶段3_研发协作与正式开发.md` |
| 上线前要做什么 | 测试培训上线回流 / Gate 4 | `阶段4_测试培训上线回流.md``项目检查清单.md` |
| 谁来做 | 角色职责 | `角色职责矩阵.md` |
| 要交什么 | 阶段交付物 | `阶段交付物清单.md` |
| 检查点 | 阶段门禁 / 项目检查清单 | `项目检查清单.md` |
| AI 写的代码 | AI 代码治理 | `阶段3_研发协作与正式开发.md` |
| 加一条业务规则 | 业务规则补充 | `业务规则与需求补充模板.md``知识库持续更新与验证流程.md` |
| 补需求 | 需求补充 | `业务规则与需求补充模板.md``需求说明模板.md` |
| 新规则怎么写 | 业务规则与需求补充 | `业务规则与需求补充模板.md` |
| 怎么验证能不能搜到 | Agent 检索验证 | `知识库持续更新与验证流程.md``业务补充验证记录.md` |

View File

@@ -0,0 +1,56 @@
---
type: source_index
tags: [来源, 索引, Agent]
aliases: [来源索引, 原始文件]
source: manual
status: active
owner: 内部技术团队
updated: 2026-05
---
# 来源文件索引
## 原始来源
| 来源文件 | 路径 | 用途 | 状态 |
|---|---|---|---|
| AI_驱动_内部系统开发流程_V3.docx | `D:\\AIcoding\\WishFulfilled\\知识库\\AI_驱动_内部系统开发流程_V3.docx` | 项目管理流程权威来源 | active |
## 拆解后的知识条目
| 条目 | 来源 |
|---|---|
| `02_项目管理流程/AI驱动内部系统开发流程_V3_总览.md` | AI_驱动_内部系统开发流程_V3.docx |
| `02_项目管理流程/阶段0_项目入口分级.md` | AI_驱动_内部系统开发流程_V3.docx |
| `02_项目管理流程/阶段1_业务需求完整形成.md` | AI_驱动_内部系统开发流程_V3.docx |
| `02_项目管理流程/阶段2_高保真模型与业务对象确认.md` | AI_驱动_内部系统开发流程_V3.docx |
| `02_项目管理流程/阶段2.5_测试提前补漏.md` | AI_驱动_内部系统开发流程_V3.docx |
| `02_项目管理流程/阶段3_研发协作与正式开发.md` | AI_驱动_内部系统开发流程_V3.docx |
| `02_项目管理流程/阶段4_测试培训上线回流.md` | AI_驱动_内部系统开发流程_V3.docx |
| `02_项目管理流程/角色职责矩阵.md` | AI_驱动_内部系统开发流程_V3.docx |
| `02_项目管理流程/阶段交付物清单.md` | AI_驱动_内部系统开发流程_V3.docx |
| `02_项目管理流程/项目检查清单.md` | AI_驱动_内部系统开发流程_V3.docx |
| `02_项目管理流程/常见问题FAQ.md` | AI_驱动_内部系统开发流程_V3.docx |
## 业务补充来源
| 来源文件 | 路径 | 用途 | 状态 |
|---|---|---|---|
| 需求文档目录 | `05_需求文档/` | 持续存放新增业务需求、业务规则和需求变更文档 | active |
| 需求文档索引.md | `05_需求文档/需求文档索引.md` | 登记新增需求文档及 Agent 检索验证状态 | active |
| 业务规则与需求补充模板.md | `03_规范与模板/业务规则与需求补充模板.md` | 新增业务规则、需求、流程的标准模板 | active |
| 知识库持续更新与验证流程.md | `04_Agent检索/知识库持续更新与验证流程.md` | 规范新增文档后的索引同步和 Agent 检索验证 | active |
| 业务补充验证记录.md | `01_业务流程/业务补充验证记录.md` | 记录新增业务文档是否能被 Agent 检索并回答 | active |
| 里程碑目录 | `06_里程碑/` | 存放里程碑计划、阶段评审和项目节点材料 | active |
| 技术文档目录 | `07_技术文档/` | 存放架构、接口、数据模型、实现方案和技术决策 | active |
| 测试相关目录 | `08_测试相关/` | 存放测试计划、测试用例、缺陷、验收和上线检查材料 | active |
## 维护要求
- 从原始 docx 更新流程时需要同步更新阶段文件、角色职责矩阵、交付物清单、检查清单、FAQ、关键词索引和同义词表。
- 新增业务规则、需求或流程文档时,原始需求文档统一放入 `05_需求文档/`,并同步更新需求文档索引、业务规则索引、业务对象字典、关键词索引、同义词表和本来源文件索引。
- 新增里程碑材料统一放入 `06_里程碑/`,并同步更新里程碑索引。
- 新增技术材料统一放入 `07_技术文档/`,并同步更新技术文档索引。
- 新增测试材料统一放入 `08_测试相关/`,并同步更新测试用例索引或对应测试记录。
- Agent 回答项目管理流程问题时,应优先引用拆解后的 Markdown 文件。
- Agent 回答具体业务规则和需求问题时,应优先引用 `05_需求文档/` 下的正式需求文档;稳定流程可再引用 `01_业务流程/` 下的业务流程条目。

View File

@@ -0,0 +1,68 @@
---
type: agent_retrieval_guide
tags: [Agent, 检索, 规则]
aliases: [Agent检索说明, 检索规则]
source: manual
status: active
owner: 内部技术团队
updated: 2026-05
---
# Agent 检索说明
## 目标
让 Agent 在回答业务流程和项目管理流程问题时,优先基于本地 Markdown 知识库检索,而不是凭空回答。
## 检索优先级
1. `05_需求文档/`:持续新增的业务需求、业务规则、需求变更和补充说明。
2. `06_里程碑/`:项目节点、阶段计划、阶段评审和上线节奏。
3. `07_技术文档/`:系统架构、数据模型、接口说明、实现方案和技术决策。
4. `08_测试相关/`:测试计划、测试用例、缺陷记录、验收记录和上线检查。
5. `02_项目管理流程/`:内部系统开发流程、阶段、角色、门禁、交付物、检查清单。
6. `01_业务流程/`:真实业务流程、业务对象、业务规则。
7. `04_Agent检索/`:关键词、同义词、来源索引、回答规则。
8. `03_规范与模板/`:需要产出模板或文档时使用。
## 问题类型与命中文件
| 问题类型 | 优先文件 |
|---|---|
| 流程阶段 | `AI驱动内部系统开发流程_V3_总览.md`、各阶段文件 |
| 角色职责 | `角色职责矩阵.md` |
| 交付物 | `阶段交付物清单.md` |
| 门禁/检查 | `项目检查清单.md` |
| 常见问答 | `常见问题FAQ.md` |
| 业务对象 | `01_业务流程/业务对象字典.md``阶段2_高保真模型与业务对象确认.md` |
| 业务规则 | `05_需求文档/``05_需求文档/需求文档索引.md``01_业务流程/业务规则索引.md` |
| 业务需求 | `05_需求文档/``05_需求文档/需求文档索引.md` |
| 项目里程碑 | `06_里程碑/``06_里程碑/里程碑索引.md` |
| 技术实现 | `07_技术文档/``07_技术文档/技术文档索引.md` |
| 接口/数据模型 | `07_技术文档/接口说明模板.md`、具体接口文档、具体数据模型文档 |
| 测试用例 | `08_测试相关/``08_测试相关/测试用例索引.md` |
| 缺陷/验收/上线检查 | `08_测试相关/缺陷记录模板.md``08_测试相关/验收记录模板.md``08_测试相关/上线检查模板.md` |
## 回答规则
- 先回答结论,再展开依据。
- 流程问题按“阶段、负责人、输入、动作、输出、检查点”组织。
- 角色问题按“负责阶段、核心职责、典型产出”组织。
- 交付物问题列出文件名。
- 业务规则和需求问题优先检索 `05_需求文档/` 下的正式需求文档,再检索 `05_需求文档/需求文档索引.md``01_业务流程/业务规则索引.md``关键词索引.md``同义词表.md`
- 里程碑问题优先检索 `06_里程碑/``06_里程碑/里程碑索引.md`
- 技术问题优先检索 `07_技术文档/``07_技术文档/技术文档索引.md`
- 测试问题优先检索 `08_测试相关/``08_测试相关/测试用例索引.md`
- 必须注明来源文件名。
- 如果知识库未明确记录,不要推测,应回答“知识库未明确记录”,并建议补充到具体文件。
## 持续更新验证
新增业务规则、需求或流程文档后,按 [[知识库持续更新与验证流程]] 执行验证。
新增文档应使用 `03_规范与模板/业务规则与需求补充模板.md`,正式需求文档保存到 `05_需求文档/`,验证结果记录到 `05_需求文档/需求文档索引.md``01_业务流程/业务补充验证记录.md`
## 引用格式
建议在回答末尾使用:
> 来源:`02_项目管理流程/阶段2.5_测试提前补漏.md`

View File

@@ -0,0 +1,162 @@
---
type: validation_process
tags: [Agent, 检索, 知识库更新, 验证流程]
aliases: [知识库更新验证, Agent检索验证, 补充文档验证流程]
source: manual
status: active
owner: 内部技术团队 / 产品经理
updated: 2026-05
---
# 知识库持续更新与验证流程
## 1. 目标
确保业务规则、业务需求和流程补充后Agent 能通过文件检索命中新内容,并基于知识库给出可追溯回答。
## 2. 更新入口
业务新增或修订时,优先使用:
- `03_规范与模板/业务规则与需求补充模板.md`
- `03_规范与模板/需求说明模板.md`
- `03_规范与模板/业务流程梳理模板.md`
补充后的正式需求文档统一保存到:
- `05_需求文档/`
如果文档已经沉淀为稳定业务流程,再同步拆解或引用到:
- `01_业务流程/`
推荐命名:
```text
业务域_规则或需求名称_YYYYMMDD.md
```
示例:
```text
采购_供应商准入规则_20260526.md
库存_出入库审批规则_20260526.md
销售_客户授信额度规则_20260526.md
```
## 3. 标准更新流程
### 步骤 1新增补充文档
1. 复制 `业务规则与需求补充模板.md`
2. 保存到 `05_需求文档/`
3. 补全 Frontmatter`type``tags``aliases``source``status``owner``updated`
4. 补全正文中的业务规则、流程、异常、权限、验收口径和 Agent 检索字段。
### 步骤 2更新索引
新增业务文档后,同步更新:
| 文件 | 更新内容 |
|---|---|
| `05_需求文档/需求文档索引.md` | 增加需求/规则名称、业务域、来源文件、状态和验证状态 |
| `01_业务流程/业务规则索引.md` | 增加规则名称、业务域、适用场景、来源文件 |
| `01_业务流程/业务对象字典.md` | 增加新增或变更的业务对象、字段、状态 |
| `04_Agent检索/关键词索引.md` | 增加关键词到新文件的映射 |
| `04_Agent检索/同义词表.md` | 增加口语问法与标准术语映射 |
| `04_Agent检索/来源文件索引.md` | 登记新增知识条目来源 |
### 步骤 3执行文件级检查
检查项:
- 文件是否位于 `05_需求文档/`
- 文件名是否包含业务域、规则/需求名称、日期。
- Frontmatter 是否完整。
- 是否包含 `业务规则``业务流程``验收口径``Agent 检索字段`
- 索引文件是否已同步更新。
### 步骤 4执行关键词检索验证
用新增文档中的关键词、别名、口语问法进行检索。
验证标准:
- 至少 1 个正式关键词能命中新文档。
- 至少 1 个口语问法能通过 `同义词表.md``关键词索引.md` 定位到新文档。
- 检索结果能定位到具体文件,而不是只命中模板。
### 步骤 5执行 Agent 问答验证
每次新增文档至少准备 3 类问题:
| 类型 | 示例 | 通过标准 |
|---|---|---|
| 规则类 | `供应商准入有什么条件?` | 能回答规则条件、触发条件、处理结果 |
| 流程类 | `供应商准入流程怎么走?` | 能按步骤回答主流程和分支流程 |
| 异常类 | `供应商资料不完整怎么办?` | 能回答异常处理方式和负责人 |
Agent 回答必须满足:
1. 结论来自新增文档或已索引文件。
2. 回答末尾注明来源文件名。
3. 如果文档未记录,明确回答“知识库未明确记录”。
4. 不得凭经验补充没有来源的业务规则。
### 步骤 6记录验证结果
在新增业务文档末尾的 `变更记录` 或单独验证记录中记录:
| 日期 | 验证问题 | 是否命中 | 来源文件 | 结果 | 待补充 |
|---|---|---|---|---|---|
| | | 是/否 | | 通过/失败 | |
## 4. 验证用例模板
复制以下内容到新增业务文档的 `Agent 检索字段` 或验证记录中:
```markdown
## Agent 检索验证
| 编号 | 用户问题 | 期望命中文件 | 期望答案要点 | 实际结果 | 状态 |
|---|---|---|---|---|---|
| Q1 | | | | | 未验证 |
| Q2 | | | | | 未验证 |
| Q3 | | | | | 未验证 |
```
## 5. 通过/失败判定
### 通过
- 新文档能被关键词检索到。
- Agent 能引用新文档回答至少 3 个验证问题。
- 回答没有明显幻觉。
- 来源文件引用正确。
### 失败
出现任一情况视为失败:
- 新文档只保存了,但没有更新关键词索引或同义词表。
- Agent 命中了旧文件,未命中新文档。
- Agent 回答没有引用来源。
- Agent 编造了文档中不存在的业务规则。
- 问题能检索到模板,但不能检索到正式业务文档。
失败后处理:
1. 补充 `aliases``tags`、推荐关键词和同义词。
2. 更新 `关键词索引.md``同义词表.md`
3. 将标准问答补充到新增文档的 `Agent 检索字段`
4. 重新执行验证。
## 6. Agent 验证提示词
```text
请只基于 D:\AIcoding\WishFulfilled\知识库\如愿知识库 下的 Markdown 文件回答。
优先检索 05_需求文档、01_业务流程、02_项目管理流程、04_Agent检索。
如果知识库没有明确记录,请回答“知识库未明确记录”,并说明建议补充到哪个文件。
回答末尾必须列出来源文件。
现在验证问题是:{用户问题}
```

View File

@@ -0,0 +1,48 @@
---
type: agent_prompt
tags: [Agent, 提示词, 问答]
aliases: [Agent提示词, 知识库问答Prompt]
source: manual
status: active
owner: 内部技术团队
updated: 2026-05
---
# 问答提示词
## 系统提示词
你是如愿内部知识库问答 Agent。你必须优先检索本地 Markdown 知识库,再回答业务流程、项目管理流程、角色职责、交付物、检查清单和模板相关问题。
回答要求:
1. 不要凭空编造知识库未记录的信息。
2. 优先检索 `02_项目管理流程``01_业务流程`
3. 流程类问题按阶段、负责人、输入、关键动作、输出、检查点回答。
4. 角色类问题优先检索 `角色职责矩阵.md`
5. 交付物类问题优先检索 `阶段交付物清单.md`
6. 门禁和检查类问题优先检索 `项目检查清单.md`
7. 每次回答末尾必须注明来源文件。
8. 如果没有明确答案,回答“知识库未明确记录”,并说明建议补充到哪个文件。
## 用户问题改写规则
- “提需求”可映射为“项目入口分级”或“业务需求完整形成”。
- “开发前测试”可映射为“阶段2.5 测试提前补漏”。
- “原型”可映射为“Vibe Coding 页面”或“高保真模型”,需结合上下文区分。
- “上线前检查”可映射为“Gate 4 上线验收”和“项目检查清单”。
- “谁负责”优先查角色职责矩阵。
## 标准回答模板
结论:
要点:
1. 阶段/角色:
2. 输入:
3. 关键动作:
4. 输出:
5. 检查点:
来源:

78
05_需求文档/README.md Normal file
View File

@@ -0,0 +1,78 @@
---
type: requirement_inbox
tags: [需求文档, 需求收集, 知识库更新, Agent]
aliases: [需求文档目录, 需求收集目录, 需求入口]
source: manual
status: active
owner: 产品经理 / 业务主管
updated: 2026-05
---
# 需求文档
本目录用于集中存放后续持续补充的业务需求文档、业务规则文档、流程补充文档和需求变更文档。
## 使用方式
1. 所有新增需求文档优先放入本目录。
2. 建议使用 `03_规范与模板/需求说明模板.md``03_规范与模板/业务规则与需求补充模板.md` 创建文档。
3. 文档确认有效后,同步更新业务流程索引和 Agent 检索索引。
4. Agent 回答具体业务需求时,应优先检索本目录。
## 推荐命名
```text
业务域_需求或规则名称_YYYYMMDD.md
```
示例:
```text
采购_供应商准入规则_20260526.md
库存_出入库审批规则_20260526.md
销售_客户授信额度需求_20260526.md
```
## 文档状态
每个需求文档建议在 Frontmatter 中维护 `status`
| 状态 | 含义 |
|---|---|
| draft | 草稿,尚未确认 |
| reviewing | 评审中 |
| active | 已确认,可作为 Agent 回答依据 |
| deprecated | 已废弃,仅归档参考 |
## 必填内容
每个需求文档至少包含:
- 需求背景
- 适用范围
- 涉及角色
- 业务规则
- 业务流程
- 异常处理
- 权限要求
- 验收口径
- Agent 检索字段
- 变更记录
## 索引维护
新增或修改需求文档后,需要同步更新:
- `05_需求文档/需求文档索引.md`
- `01_业务流程/业务规则索引.md`
- `01_业务流程/业务对象字典.md`
- `04_Agent检索/关键词索引.md`
- `04_Agent检索/同义词表.md`
- `04_Agent检索/来源文件索引.md`
## 验证流程
新增需求文档后,按 `04_Agent检索/知识库持续更新与验证流程.md` 执行验证,并将验证结果记录到:
- `05_需求文档/需求文档索引.md`
- `01_业务流程/业务补充验证记录.md`

View File

@@ -0,0 +1,39 @@
---
type: requirement_index
tags: [需求文档, 索引, Agent检索]
aliases: [需求索引, 需求文档清单, 需求清单]
source: manual
status: active
owner: 产品经理 / 业务主管
updated: 2026-05
---
# 需求文档索引
本文件记录 `05_需求文档/` 下所有正式需求文档,供人工维护和 Agent 检索定位。
## 需求文档清单
| 编号 | 业务域 | 需求/规则名称 | 文件 | 状态 | 负责人 | 更新时间 | 验证状态 |
|---|---|---|---|---|---|---|---|
| | | | | | | | 未验证 |
## Agent 检索关键词
| 关键词/问法 | 标准术语 | 命中文件 | 答案要点 |
|---|---|---|---|
| | | | |
## 维护规则
1. 新增需求文档后,必须在“需求文档清单”新增一行。
2. 每个需求文档至少维护 3 个可检索问法。
3. `状态=active` 的文档可作为 Agent 回答依据。
4. `status=draft/reviewing` 的文档只能作为草稿参考Agent 回答时需说明尚未确认。
5. `status=deprecated` 的文档不得作为当前规则依据,只能说明历史背景。
## 验证记录摘要
| 日期 | 文件 | 验证问题数 | 通过数 | 失败数 | 结论 |
|---|---|---:|---:|---:|---|
| | | | | | |

42
06_里程碑/README.md Normal file
View File

@@ -0,0 +1,42 @@
---
type: milestone_home
tags: [里程碑, 项目管理, 知识库]
aliases: [里程碑入口, 项目里程碑]
source: manual
status: active
owner: 项目经理
updated: 2026-05
---
# 里程碑
本目录用于存放项目阶段计划、里程碑节点、阶段评审记录和上线节奏说明。
## 二级入口
- [[里程碑索引]]
- [[阶段计划模板]]
- [[里程碑评审记录]]
## 存放内容
- 项目启动节点
- 需求评审节点
- 原型/高保真确认节点
- 开发启动节点
- 测试准入节点
- 上线检查节点
- 复盘回流节点
## 命名建议
```text
项目名_里程碑计划_YYYYMMDD.md
项目名_阶段评审记录_YYYYMMDD.md
```
## 关联目录
- 需求依据:[[../05_需求文档/README|需求文档]]
- 流程依据:[[../02_项目管理流程/AI驱动内部系统开发流程_V3_总览|项目管理流程]]
- 测试准入:[[../08_测试相关/README|测试相关]]

View File

@@ -0,0 +1,29 @@
---
type: milestone_index
tags: [里程碑, 索引, Agent检索]
aliases: [里程碑清单, 项目节点索引]
source: manual
status: active
owner: 项目经理
updated: 2026-05
---
# 里程碑索引
## 里程碑文档清单
| 项目 | 里程碑名称 | 文件 | 阶段 | 负责人 | 计划时间 | 当前状态 |
|---|---|---|---|---|---|---|
| | | | | | | |
## Agent 检索关键词
| 问法 | 标准术语 | 命中文件 | 答案要点 |
|---|---|---|---|
| | | | |
## 维护规则
- 新增里程碑计划后,在本索引登记。
- 每个里程碑应关联至少一个需求文档或项目管理阶段。
- Agent 回答项目进度、节点、准入问题时,应引用本索引或具体里程碑文件。

View File

@@ -0,0 +1,15 @@
---
type: milestone_review_log
tags: [里程碑, 评审, 记录]
aliases: [阶段评审记录, 里程碑评审]
source: manual
status: active
owner: 项目经理
updated: 2026-05
---
# 里程碑评审记录
| 日期 | 项目 | 阶段 | 评审结论 | 遗留问题 | 负责人 | 后续动作 |
|---|---|---|---|---|---|---|
| | | | | | | |

View File

@@ -0,0 +1,53 @@
---
type: milestone_template
tags: [里程碑, 阶段计划, 模板]
aliases: [阶段计划, 里程碑模板]
source: manual
status: active
owner: 项目经理
updated: 2026-05
---
# 阶段计划模板
## 基本信息
| 项目 | 内容 |
|---|---|
| 项目名称 | |
| 关联需求 | |
| 当前阶段 | |
| 负责人 | |
| 计划开始 | |
| 计划结束 | |
## 阶段目标
## 输入材料
- 需求文档:
- 业务流程:
- 技术文档:
- 测试材料:
## 关键任务
| 任务 | 负责人 | 截止时间 | 输出物 | 状态 |
|---|---|---|---|---|
| | | | | |
## 阶段交付物
## 准入/准出条件
## 风险与阻塞
## Agent 检索字段
- 关键词:
- 同义词:
- 典型问法:

44
07_技术文档/README.md Normal file
View File

@@ -0,0 +1,44 @@
---
type: technical_docs_home
tags: [技术文档, 架构, 开发, 知识库]
aliases: [技术文档入口, 技术资料]
source: manual
status: active
owner: 技术负责人
updated: 2026-05
---
# 技术文档
本目录用于存放系统架构、数据模型、接口说明、实现方案、部署说明和技术决策记录。
## 二级入口
- [[技术文档索引]]
- [[系统架构说明模板]]
- [[接口说明模板]]
- [[技术决策记录]]
## 存放内容
- 系统架构说明
- 模块设计说明
- 数据表/业务对象设计
- API 接口说明
- 权限与安全设计
- 部署与配置说明
- 技术决策记录
## 命名建议
```text
系统或模块_技术方案_YYYYMMDD.md
系统或模块_接口说明_YYYYMMDD.md
系统或模块_数据模型_YYYYMMDD.md
```
## 关联目录
- 需求依据:[[../05_需求文档/README|需求文档]]
- 测试依据:[[../08_测试相关/README|测试相关]]
- 里程碑:[[../06_里程碑/README|里程碑]]

View File

@@ -0,0 +1,15 @@
---
type: adr_log
tags: [技术文档, 技术决策, ADR]
aliases: [技术决策, ADR]
source: manual
status: active
owner: 技术负责人
updated: 2026-05
---
# 技术决策记录
| 日期 | 决策主题 | 背景 | 决策结论 | 影响范围 | 关联需求/技术文档 |
|---|---|---|---|---|---|
| | | | | | |

View File

@@ -0,0 +1,29 @@
---
type: technical_docs_index
tags: [技术文档, 索引, Agent检索]
aliases: [技术索引, 技术资料清单]
source: manual
status: active
owner: 技术负责人
updated: 2026-05
---
# 技术文档索引
## 技术文档清单
| 模块/系统 | 文档类型 | 文件 | 关联需求 | 负责人 | 更新时间 | 状态 |
|---|---|---|---|---|---|---|
| | | | | | | |
## Agent 检索关键词
| 问法 | 标准术语 | 命中文件 | 答案要点 |
|---|---|---|---|
| | | | |
## 维护规则
- 新增技术方案、接口说明、数据模型后,在本索引登记。
- 技术文档必须关联需求文档或业务流程。
- Agent 回答技术实现、接口、数据结构问题时,应优先检索本目录。

View File

@@ -0,0 +1,51 @@
---
type: api_template
tags: [技术文档, 接口, 模板]
aliases: [接口模板, API说明模板]
source: manual
status: active
owner: 技术负责人
updated: 2026-05
---
# 接口说明模板
## 基本信息
| 项目 | 内容 |
|---|---|
| 接口名称 | |
| 所属模块 | |
| 关联需求 | |
| 负责人 | |
| 状态 | draft |
## 接口用途
## 请求说明
| 字段 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| | | | | |
## 响应说明
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| | | | |
## 业务规则
## 异常码
| 异常码 | 含义 | 处理方式 |
|---|---|---|
| | | |
## Agent 检索字段
- 关键词:
- 同义词:
- 典型问法:

View File

@@ -0,0 +1,53 @@
---
type: architecture_template
tags: [技术文档, 架构, 模板]
aliases: [架构说明模板]
source: manual
status: active
owner: 技术负责人
updated: 2026-05
---
# 系统架构说明模板
## 基本信息
| 项目 | 内容 |
|---|---|
| 系统/模块 | |
| 关联需求 | |
| 负责人 | |
| 状态 | draft |
## 背景与目标
## 架构说明
## 模块划分
| 模块 | 职责 | 输入 | 输出 | 依赖 |
|---|---|---|---|---|
| | | | | |
## 数据模型
## 接口关系
## 权限与安全
## 异常与边界
## 部署与配置
## Agent 检索字段
- 关键词:
- 同义词:
- 典型问法:

48
08_测试相关/README.md Normal file
View File

@@ -0,0 +1,48 @@
---
type: testing_home
tags: [测试, 测试用例, 验收, 知识库]
aliases: [测试相关入口, 测试文档]
source: manual
status: active
owner: 测试负责人
updated: 2026-05
---
# 测试相关
本目录用于存放测试计划、测试用例、测试报告、缺陷记录、验收记录和上线检查材料。
## 二级入口
- [[测试用例索引]]
- [[测试用例模板]]
- [[测试计划模板]]
- [[缺陷记录模板]]
- [[验收记录模板]]
- [[上线检查模板]]
## 存放内容
- 测试计划
- 测试用例
- 测试执行记录
- 缺陷记录
- 验收记录
- 上线检查记录
- 回归测试说明
## 命名建议
```text
项目或模块_测试用例_YYYYMMDD.md
项目或模块_测试计划_YYYYMMDD.md
项目或模块_缺陷记录_YYYYMMDD.md
项目或模块_验收记录_YYYYMMDD.md
```
## 关联目录
- 需求依据:[[../05_需求文档/README|需求文档]]
- 技术依据:[[../07_技术文档/README|技术文档]]
- 里程碑依据:[[../06_里程碑/README|里程碑]]
- 流程依据:[[../02_项目管理流程/阶段2.5_测试提前补漏|阶段2.5 测试提前补漏]]、[[../02_项目管理流程/阶段4_测试培训上线回流|阶段4 测试培训上线回流]]

View File

@@ -0,0 +1,44 @@
---
type: go_live_checklist_template
tags: [上线检查, 测试, 模板]
aliases: [上线检查, 发布检查]
source: manual
status: active
owner: 测试负责人 / 项目经理
updated: 2026-05
---
# 上线检查模板
## 基本信息
| 项目 | 内容 |
|---|---|
| 项目/模块 | |
| 关联需求 | |
| 关联里程碑 | |
| 负责人 | |
| 检查日期 | |
## 上线前检查项
| 检查项 | 负责人 | 结果 | 备注 |
|---|---|---|---|
| 需求已确认 | | | |
| 测试用例已执行 | | | |
| P0/P1 缺陷已关闭 | | | |
| 用户培训已完成 | | | |
| 回滚方案已确认 | | | |
| 数据备份已确认 | | | |
## 上线结论
## 回滚条件
## Agent 检索字段
- 关键词:
- 同义词:
- 典型问法:

View File

@@ -0,0 +1,45 @@
---
type: test_case_template
tags: [测试用例, 测试, 模板]
aliases: [用例模板, 测试用例]
source: manual
status: active
owner: 测试负责人
updated: 2026-05
---
# 测试用例模板
## 基本信息
| 项目 | 内容 |
|---|---|
| 项目/模块 | |
| 关联需求 | |
| 关联技术文档 | |
| 测试负责人 | |
| 状态 | draft |
## 测试范围
## 前置条件
## 测试用例
| 用例编号 | 场景 | 前置条件 | 操作步骤 | 预期结果 | 优先级 | 状态 |
|---|---|---|---|---|---|---|
| TC-001 | | | | | P1 | 未执行 |
## 边界与异常场景
## 验收口径
## Agent 检索字段
- 关键词:
- 同义词:
- 典型问法:

View File

@@ -0,0 +1,30 @@
---
type: test_case_index
tags: [测试用例, 测试, 索引, Agent检索]
aliases: [测试用例清单, 用例索引]
source: manual
status: active
owner: 测试负责人
updated: 2026-05
---
# 测试用例索引
## 测试用例清单
| 编号 | 项目/模块 | 用例集名称 | 文件 | 关联需求 | 关联技术文档 | 负责人 | 状态 | 更新时间 |
|---|---|---|---|---|---|---|---|---|
| | | | | | | | 未验证 | |
## Agent 检索关键词
| 问法 | 标准术语 | 命中文件 | 答案要点 |
|---|---|---|---|
| | | | |
## 维护规则
- 新增测试用例后,必须在本索引登记。
- 每个测试用例文件必须关联至少一个需求文档。
- 若测试用例依赖接口、数据模型或技术方案,应关联技术文档。
- Agent 回答测试范围、验收口径、缺陷复现问题时,应优先检索本目录。

View File

@@ -0,0 +1,54 @@
---
type: test_plan_template
tags: [测试计划, 测试, 模板]
aliases: [测试计划模板]
source: manual
status: active
owner: 测试负责人
updated: 2026-05
---
# 测试计划模板
## 基本信息
| 项目 | 内容 |
|---|---|
| 项目/模块 | |
| 关联需求 | |
| 关联里程碑 | |
| 测试负责人 | |
| 计划周期 | |
## 测试目标
## 测试范围
## 不在范围内
## 测试资源
## 测试安排
| 阶段 | 时间 | 负责人 | 输出物 |
|---|---|---|---|
| | | | |
## 准入条件
## 准出条件
## 风险
## Agent 检索字段
- 关键词:
- 同义词:
- 典型问法:

View File

@@ -0,0 +1,53 @@
---
type: defect_template
tags: [缺陷, 测试, 模板]
aliases: [Bug记录模板, 缺陷记录]
source: manual
status: active
owner: 测试负责人
updated: 2026-05
---
# 缺陷记录模板
## 基本信息
| 项目 | 内容 |
|---|---|
| 缺陷编号 | BUG- |
| 项目/模块 | |
| 关联需求 | |
| 关联用例 | |
| 严重级别 | |
| 当前状态 | open |
| 负责人 | |
## 问题描述
## 复现步骤
1.
2.
3.
## 实际结果
## 预期结果
## 影响范围
## 修复结论
## 回归验证
## Agent 检索字段
- 关键词:
- 同义词:
- 典型问法:

View File

@@ -0,0 +1,43 @@
---
type: acceptance_template
tags: [验收, 测试, 模板]
aliases: [验收记录, UAT模板]
source: manual
status: active
owner: 测试负责人 / 业务负责人
updated: 2026-05
---
# 验收记录模板
## 基本信息
| 项目 | 内容 |
|---|---|
| 项目/模块 | |
| 关联需求 | |
| 关联测试用例 | |
| 验收负责人 | |
| 验收日期 | |
| 验收结论 | |
## 验收范围
## 验收结果
| 验收项 | 预期结果 | 实际结果 | 结论 | 备注 |
|---|---|---|---|---|
| | | | | |
## 遗留问题
## 上线建议
## Agent 检索字段
- 关键词:
- 同义词:
- 典型问法:

360
Git使用说明.md Normal file
View File

@@ -0,0 +1,360 @@
---
type: git_guide
tags: [Git, 版本管理, 知识库, 使用说明]
aliases: [Git说明, 仓库使用说明, 知识库提交说明]
source: manual
status: active
owner: 内部技术团队
updated: 2026-05
---
# Git 使用说明
本文档说明如愿知识库的 Git 仓库地址、目录结构、日常提交流程、多人协作规则和 Obsidian 图谱注意事项。
## 1. 仓库信息
远程仓库地址:
```bash
https://wdxz-gitea.best-envision.com/qiaoxinjiu/Fulfilled-Knowledge.git
```
本地知识库目录:
```text
D:\AIcoding\WishFulfilled\知识库\如愿知识库
```
推荐使用 Obsidian 打开该目录作为 Vault。
## 2. 知识库主目录说明
```text
如愿知识库/
├─ 00_首页/ # 知识库入口、知识地图、Agent 问答入口
├─ 01_业务流程/ # 业务流程、业务对象、业务规则、补充验证记录
├─ 02_项目管理流程/ # 项目阶段、角色职责、交付物、检查清单、FAQ
├─ 03_规范与模板/ # 需求、业务规则、会议、上线检查等模板
├─ 04_Agent检索/ # 检索说明、关键词、同义词、来源文件索引
├─ 05_需求文档/ # 正式需求文档、需求索引
├─ 06_里程碑/ # 里程碑计划、阶段计划、评审记录
├─ 07_技术文档/ # 技术方案、架构、接口、技术决策
├─ 08_测试相关/ # 测试用例、测试计划、缺陷、验收、上线检查
├─ 99_归档/ # 废弃或历史参考内容
├─ 欢迎.md # Obsidian 入口
└─ Git使用说明.md # 本文档
```
## 3. 推荐阅读入口
首次使用时建议按以下顺序阅读:
1. `欢迎.md`
2. `00_首页/知识库首页.md`
3. `00_首页/知识地图.md`
4. `00_首页/Agent问答入口.md`
5. `04_Agent检索/检索说明.md`
6. `04_Agent检索/来源文件索引.md`
## 4. Agent 检索优先级
Agent 回答问题时,建议按以下顺序检索:
1. `05_需求文档/`:正式需求、业务规则、需求变更。
2. `06_里程碑/`:阶段节点、项目计划、评审记录。
3. `07_技术文档/`:架构、接口、实现方案、技术决策。
4. `08_测试相关/`:测试用例、测试计划、缺陷、验收、上线检查。
5. `02_项目管理流程/`:项目阶段、角色、交付物、门禁、检查清单。
6. `01_业务流程/`:业务流程、业务对象、业务规则。
7. `04_Agent检索/`:关键词、同义词、来源索引、回答规则。
8. `03_规范与模板/`:需要产出模板或文档时使用。
回答业务问题时,必须注明来源文件。
## 5. 新增文档规则
### 5.1 新增需求文档
放入目录:
```text
05_需求文档/
```
推荐命名:
```text
业务域_需求或规则名称_YYYYMMDD.md
```
新增后同步维护:
- `05_需求文档/需求文档索引.md`
- `01_业务流程/业务规则索引.md`
- `01_业务流程/业务对象字典.md`
- `04_Agent检索/关键词索引.md`
- `04_Agent检索/同义词表.md`
- `04_Agent检索/来源文件索引.md`
### 5.2 新增里程碑文档
放入目录:
```text
06_里程碑/
```
推荐命名:
```text
项目名_里程碑计划_YYYYMMDD.md
项目名_阶段评审记录_YYYYMMDD.md
```
新增后同步维护:
- `06_里程碑/里程碑索引.md`
- `00_首页/知识地图.md`,如需新增主入口或二级入口。
### 5.3 新增技术文档
放入目录:
```text
07_技术文档/
```
推荐命名:
```text
系统或模块_技术方案_YYYYMMDD.md
系统或模块_接口说明_YYYYMMDD.md
系统或模块_数据模型_YYYYMMDD.md
```
新增后同步维护:
- `07_技术文档/技术文档索引.md`
- `04_Agent检索/关键词索引.md`
- `04_Agent检索/来源文件索引.md`
### 5.4 新增测试用例
放入目录:
```text
08_测试相关/
```
推荐命名:
```text
项目名_模块名_测试用例_YYYYMMDD.md
项目名_模块名_测试计划_YYYYMMDD.md
项目名_模块名_缺陷记录_YYYYMMDD.md
```
新增后同步维护:
- `08_测试相关/测试用例索引.md`
- `08_测试相关/测试计划模板.md`,如计划结构发生变化。
- `08_测试相关/缺陷记录模板.md`,如缺陷字段发生变化。
## 6. Obsidian 图谱说明
Obsidian 图谱会显示两类节点:
1. 已存在的 Markdown 文件。
2. 文档中链接到、但本地还不存在的 Markdown 文件。
例如文档中存在:
```markdown
[工作基线 v1.2](20260517_USER评价业务闭环主流程与后续工作基线_v1.2.md)
```
即使该文件还没有放入目录Obsidian 图谱也可能显示这个节点。这是“未创建链接 / dangling link”不是目录里真的多了文件。
如果只想显示真实存在的文件,可以在 Obsidian 图谱里开启:
```text
图谱视图 → 筛选 → 仅显示已有文件
```
如果希望知识链路完整,应把被引用的上游文档也补充到对应目录。
## 7. 首次拉取仓库
在目标目录执行:
```bash
git clone https://wdxz-gitea.best-envision.com/qiaoxinjiu/Fulfilled-Knowledge.git
```
然后用 Obsidian 打开克隆出的目录。
## 8. 日常更新流程
### 8.1 拉取最新内容
开始编辑前先拉取远程更新:
```bash
git pull origin master
```
如果主分支后续改名为 `main`,则使用:
```bash
git pull origin main
```
### 8.2 查看变更
```bash
git status
```
### 8.3 暂存变更
提交全部变更:
```bash
git add .
```
只提交指定文件:
```bash
git add 05_需求文档/需求文档索引.md
```
### 8.4 提交变更
提交信息建议包含动作和范围:
```bash
git commit -m "docs: 更新需求文档索引"
```
常用提交前缀:
| 前缀 | 用途 |
|---|---|
| `docs:` | 文档新增或修改 |
| `chore:` | 目录、配置、维护性调整 |
| `fix:` | 修正文档错误、链接错误 |
| `refactor:` | 调整结构但不改变内容含义 |
| `archive:` | 归档历史内容 |
### 8.5 推送到远程
```bash
git push origin master
```
如果主分支为 `main`,则使用:
```bash
git push origin main
```
## 9. 推荐的完整提交流程
```bash
git pull origin master
git status
git add .
git commit -m "docs: 更新如愿知识库"
git push origin master
```
## 10. 冲突处理原则
多人同时修改同一个文档时,可能出现冲突。
处理原则:
1. 不要直接覆盖别人内容。
2. 先阅读冲突区块。
3. 保留双方有效内容。
4. 删除 Git 冲突标记。
5. 再执行提交。
冲突标记示例:
```text
<<<<<<< HEAD
本地内容
=======
远程内容
>>>>>>> origin/master
```
处理完成后:
```bash
git add 冲突文件.md
git commit -m "fix: 解决知识库文档冲突"
git push origin master
```
## 11. 不建议提交的内容
一般不建议提交:
- 临时截图。
- 临时导出文件。
- 个人草稿。
- 含账号、密码、Token、密钥的文件。
- 含客户隐私或敏感原文的未脱敏文件。
如需沉淀敏感业务规则,应先脱敏,再放入知识库。
## 12. 提交前检查清单
提交前确认:
- [ ] 新文档放在正确目录。
- [ ] 文件名清晰,能表达业务域和用途。
- [ ] 重要文档已写 Frontmatter。
- [ ] 新增需求已维护 `05_需求文档/需求文档索引.md`
- [ ] 新增测试用例已维护 `08_测试相关/测试用例索引.md`
- [ ] 新增技术文档已维护 `07_技术文档/技术文档索引.md`
- [ ] 需要 Agent 检索的关键词已同步到 `04_Agent检索/关键词索引.md`
- [ ] 链接能正常跳转,或确认它是故意保留的上游虚链接。
- [ ] 不包含密码、Token、密钥和未脱敏敏感数据。
## 13. 常见问题
### 13.1 为什么我只放了一个文档,图谱里出现多个节点?
因为文档中引用了其他 Markdown 文件。Obsidian 会把被链接但尚未创建的文件也显示为节点。
解决方式:
- 图谱开启“仅显示已有文件”。
- 或补齐被引用的上游文档。
### 13.2 README.md 为什么也会出现在图谱里?
因为 README.md 也是 Markdown 文件Obsidian 会把它作为普通节点显示。
### 13.3 删除文件后图谱还有节点怎么办?
检查是否仍有其他文档链接到该文件。只要有链接,图谱仍可能显示虚节点。
### 13.4 Agent 回答问题应该依赖哪个目录?
优先依赖 `05_需求文档/`,其次是 `06_里程碑/``07_技术文档/``08_测试相关/`,再查流程、业务和检索规则目录。
## 14. 维护原则
1. 知识库不是文件堆积,而是可检索、可追溯、可回答的知识网络。
2. 正式需求必须有索引。
3. 关键业务规则必须有来源。
4. 测试用例必须能追溯到需求。
5. 技术文档必须能追溯到需求或业务流程。
6. 里程碑必须能追溯到阶段目标和交付物。
7. Agent 回答必须说明来源文件。

1
未命名.canvas Normal file
View File

@@ -0,0 +1 @@
{}

23
欢迎.md Normal file
View File

@@ -0,0 +1,23 @@
---
type: index
tags: [知识库, 入口]
aliases: [欢迎, 首页]
source: manual
status: active
owner: 内部技术团队
updated: 2026-05
---
# 欢迎使用如愿知识库
请从 [[00_首页/知识库首页]] 开始。
常用入口:
- [[00_首页/知识地图]]
- [[00_首页/Agent问答入口]]
- [[05_需求文档/README|需求文档]]
- [[06_里程碑/README|里程碑]]
- [[07_技术文档/README|技术文档]]
- [[08_测试相关/README|测试相关]]
- [[04_Agent检索/检索说明]]