docs(xingbang): 适配项目开发流程并建立经验驱动预审新版文档
verify / test-and-build (push) Canceled after 0s

This commit is contained in:
2026-09-28 17:02:33 +08:00
parent 4d5a420671
commit 9d2399feed
26 changed files with 1164 additions and 266 deletions
+16 -8
View File
@@ -1,7 +1,7 @@
# URD 模板(User Requirements Document)
> **定位**:URD(用户需求文档,与 PRD 等价)是**产品级**需求描述——定义"产品是什么、为谁服务、用户要完成哪些任务、每个功能如何被用户感知和使用"。它是软件项目**一切后续文档的输入**:阶段 ① 需求规格(BR/E/AC)、② 架构、③ 详细设计、④ UI Spec、测试用例,都必须能追溯到本文档的功能条目。
> **适用**:本模板用于 DK Forge 及后续所有软件项目的产品需求文档撰写。
> **适用**:本模板用于兴邦金租 AI 评审平台及新版 AI 预审的用户需求撰写;正文按业务人员语言描述,区分演示、真实数据试点与正式审批。
> **用法**:复制本文件为 `<产品名>-URD-<版本>-<日期>.md`,按占位符 `<...>` 填写;删除不适用章节并记录删除理由;编号规则见第 0 节,不得破坏。
---
@@ -20,7 +20,7 @@
```
- URD 回答 **"用户要什么、为什么、长什么样、做到什么程度算好"**;
- 阶段 ① 规格回答 **"这一版改动具体怎么实现、怎么验收"**;
- URD 讲用户语言,不写内部实现(不写表结构、类名、IPC 通道);确有底层约束须写"约束与假设"。
- URD 讲用户语言,不写内部实现(不写表结构、类名、内部工具调用);确有底层约束须写"约束与假设"。
### 0.2 编号规则(只追加、不重排、弃用标记 withdrawn)
| 前缀 | 含义 | 示例 |
@@ -95,7 +95,7 @@
| `<例如:开放第三方市场>` | `<例如:首版只支持受控模板>` | V2+ |
### 2.5 成功标准(产品级,一句话可判)
- `<首个版本成功的硬性标志,如:不写代码的业务人员可在 60 分钟内发布一个可用 Agent>`
- `<首个版本成功的硬性标志,如:客户经理可完成一次带证据引用和补件清单的项目预审>`
---
@@ -120,7 +120,7 @@
| 角色 | 画像 | 主要任务 | 成功标准 | 常用模块 |
|---|---|---|---|---|
| `<角色>` | `<谁,技术背景>` | `<日常要完成什么>` | `<做到什么算好>` | MOD-xx |
| 例:培训者 | 懂业务不写代码 | 制作并发布一个 Agent | 不改代码完成首版 | MOD-02/05 |
| 例:客户经理 | 熟悉融资租赁业务 | 提交材料并理解预审意见 | 明确项目障碍与下一步 | MOD-02/05 |
### 4.3 角色 × 模块 关注矩阵(可选)
| | MOD-01 | MOD-02 | MOD-03 | … |
@@ -145,7 +145,7 @@
`<模块之间的依赖与数据走向一句话说明。>`
### 5.3 核心用户流程(端到端)
`<步骤表:用户从进入到完成一次价值闭环的全过程>`(例:安装 → 授权 → 首次运行 → 理解 → 协作)
`<步骤表:用户从进入到完成一次价值闭环的全过程>`(例:选择项目 → 确认材料 → 发起预审 → 查看证据 → 补件复核)
### 5.4 体验原则
1. `<先给结果,再邀请对话>`(示例原则,按产品改写)
@@ -157,7 +157,7 @@
### 5.5 交付面与平台约束
| 交付面 | 说明 | 优先级 |
|---|---|---|
| `<桌面 Electron / Web / 移动 / 硬件>` | `<能力边界、离线、多端同步>` | P0/P1 |
| `<客户经理工作台 / 评审工作台 / 管理配置>` | `<项目权限、材料来源、运行状态、异常恢复>` | P0/P1 |
---
@@ -194,8 +194,8 @@
**功能点详述**
##### FR-XXX-01 `<功能名称>`(P0)
- **功能描述**:`<该功能是什么;用户可用它完成什么;关键行为逐条列出,如:>`
1. `<行为一>`
- **功能描述**:`<该功能是什么;用户可用它完成什么;关键行为逐条列出,如:>`
1. `<行为一>`
2. `<行为二>`
- **前置条件**:`<进入该功能前必须满足的条件,如已登录、已有数据源授权>`(无则写"无")
- **主流程**:
@@ -303,3 +303,11 @@
---
> **模板维护**:本模板本身受仓库 ⑧ 学习与沉淀 约束——使用中发现结构缺陷,更新本文档并记入"变更记录"(放文末)。
## 兴邦填写约束(XB-1.0 · 2026-09-28)
- 写清主审 Agent、专项判断模型和正式审批的职责;不把 Jev 单题输出当作审批决定。
- 历史经验须描述争议、核查、证据和判断变化;仅有最终结果时标过程缺失。
- 每项功能明确材料来源、项目/数据域权限、模拟与正式结果边界、失败与人工复核路径。
- 没有真实校准数据时不承诺通过率、准确率或改善幅度;未决项有 owner 和进入阶段。
- 规格、架构、UI 和测试均回链到功能编号。可参考 [兴邦v2 URD](../../v2/URD.md)。