Skip to content

Z
zhaohua-project-kb
Commit 7725587a authored by 单鹏辉's avatar 单鹏辉
Browse files
Options

v4.0复审整改：P2+P3全部完成

P2整改： - P2-02: 创建18个Issue Ledger文件（10未决+8上线问题） - P2-03: 清理裸待补充/待确认项（添加owner/截止日期/临时口径/生产限制） - P2-04: 补齐上线问题记录运行闭环（添加Issue ID链接） - P2-05: 明确D类集成故障进入诊断链（更新AGENTS.md） P3整改： - P3-01: 同步项目导航索引（添加验收题库/Issue_Ledger/来源索引） - P3-02: 建立独立来源索引（KB_99_来源索引.md） - P3-03: 补项目干系人脱敏策略（更新00_项目概况.md） - P3-04: 标注历史审计报告状态（添加追溯说明） - P3-05: 解释KB方法论目录命名（更新README.md）
parent 9f9af550
Show whitespace changes
Inline Side-by-side
Showing with 1848 additions and 106 deletions
AGENTS.md
View file @ 7725587a
......@@ -57,9 +57,9 @@
---
## 3. C/E 类四步诊断流程
## 3. C/D/E 类诊断与闭环流程
**故障诊断/售后问题必须按以下顺序执行：**
**故障诊断/售后问题、集成异常、管理决策必须按以下顺序执行：**
```
Step 1: 查 KB_兆华/上线问题记录.md → 是否已有相同/类似问题？
......@@ -68,6 +68,11 @@ Step 3: 查 KB_兆华/Issue_Ledger/ → 是否已有独立Issue记录？
Step 4: 查模块操作特例/集成约定 → 是否有已知解决方案？判断是否升级
```
**触发条件**：
- C 类故障诊断/售后问题；
- D 类集成、RICEFW、边界问题中涉及异常、失败、延迟、数据不一致；
- E 类管理决策中涉及已有问题关闭、方案变更或客户口径。
**诊断结论必须经顾问确认后才能回写关闭。**
---
......
KB_兆华/00_项目概况.md
View file @ 7725587a
# 兆华电子 SAP 项目概况
> **审计状态**：v2.0 已完成v4.0审计整改 | 2026-07-07
> **审计状态**：v2.1 已完成v4.0审计整改+干系人脱敏 | 2026-07-07
## 项目基本信息
- **客户名称**：杭州兆华电子股份有限公司（HANGZHOU CRYSOUND ELECTRONICS CO. LTD.）
......@@ -111,11 +111,19 @@
| ETO（按订单设计） | 非标产品，需研发设计后生产 | 支持 | 支持 |
## 关键干系人
> **脱敏说明**：为保护客户隐私，关键干系人信息采用脱敏处理，仅保留角色描述。
> 如需联系具体人员，请通过项目经理或顾问团队内部渠道。
| 角色 | 姓名 | 职责 |
|------|------|------|
| 项目经理 | （待补充） | 项目整体管理 |
| 顾问负责人 | （待补充） | 实施顾问团队管理 |
| 客户IT负责人 | （待补充） | 客户IT协调 |
| 项目经理 | `<客户项目经理-脱敏>` | 项目整体管理；真实姓名由项目经理维护，不在KB公开 |
| 顾问负责人 | `<顾问负责人-脱敏>` | 实施顾问团队管理；升级路径：先联系项目经理 |
| 客户IT负责人 | `<客户IT负责人-脱敏>` | 客户IT协调；涉及账号/接口/权限问题时升级 |
---
**Issue Ledger**：未决问题和上线问题已迁移至 `KB_兆华/Issue_Ledger/` 独立台账管理。
## 关联KB文件
- **SC Base KB**：`KB_SC/` 目录（操作步骤权威来源）
......
KB_兆华/Issue_Ledger/ISSUE-001-组织结构真实值待确认.md 0 → 100644
View file @ 7725587a
# ISSUE-001-组织结构真实值待确认
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P2 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/未决问题清单.md` 编号 001 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-14 |
| 影响范围 | ALL，影响所有生产操作真实值替换 |
---
## 问题描述
当前项目仍存在组织结构真实值待确认项，生产操作前不能直接使用相关占位值。需要从DOC-007（SDMM配置清单.xlsx）中提取完整的组织结构信息。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `00_项目概况.md`、`组织与主数据_真实值.md`、操作特例文件。
- **发现**：部分组织/主数据已补齐（公司代码1100/1400、销售组织1110~1410、工厂1101~1501），但仍存在待补充字段。
- **证据**：`未决问题清单.md` 编号 001；相关待补充字段清单。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 从配置清单提取并核验组织结构真实值 | 杨娟 | 2026-07-14 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 未决问题清单：`KB_兆华/未决问题清单.md` 编号 001
- 真实值：`KB_兆华/组织与主数据_真实值.md`
- 归档文件：`DOC-007`（SDMM配置清单.xlsx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-002-主数据编号规则待确认.md 0 → 100644
View file @ 7725587a
# ISSUE-002-主数据编号规则待确认
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P2 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/未决问题清单.md` 编号 002 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-14 |
| 影响范围 | ALL，影响物料、客户、供应商编号创建 |
---
## 问题描述
主数据编号规则需要从DOC-007（SDMM配置清单.xlsx）中提取完整信息。当前已有部分编号规则（物料9001000000~9011999999、客户C001~C005、供应商S001~S006），但需要确认完整规则。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `组织与主数据_真实值.md`。
- **发现**：已提取物料编号规则（Z1-ZB范围）、客户编号规则（C001~C005）、供应商编号规则（S001~S006），但完整规则需进一步核验。
- **证据**：`组织与主数据_真实值.md` 编号规则章节。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 从配置清单提取并核验完整主数据编号规则 | 杨娟 | 2026-07-14 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 未决问题清单：`KB_兆华/未决问题清单.md` 编号 002
- 真实值：`KB_兆华/组织与主数据_真实值.md`
- 归档文件：`DOC-007`（SDMM配置清单.xlsx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-003-VC配置文件和配置类待确认.md 0 → 100644
View file @ 7725587a
# ISSUE-003-VC配置文件和配置类待确认
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P2 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/未决问题清单.md` 编号 003 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-21 |
| 影响范围 | PP/SD，影响VC变量配置和BOM生成 |
---
## 问题描述
VC（Variant Configuration）配置文件和配置类需要从蓝图文档中提取。兆华使用VC管理产品配置，VC配置错误会导致BOM无法自动生成。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `操作特例_PP_QM_生产质量.md`。
- **发现**：已有VC配置操作特例描述，但配置文件名和配置类具体值待确认。
- **证据**：`操作特例_PP_QM_生产质量.md` VC配置章节。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 从蓝图文档提取VC配置文件和配置类 | 杨娟 | 2026-07-21 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 未决问题清单：`KB_兆华/未决问题清单.md` 编号 003
- 操作特例：`KB_兆华/操作特例_PP_QM_生产质量.md`
- 归档文件：`DOC-001`（兆华电子_PPT_SAP项目蓝图总结.pptx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-004-质量检验类型和检验计划待确认.md 0 → 100644
View file @ 7725587a
# ISSUE-004-质量检验类型和检验计划待确认
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P2 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/未决问题清单.md` 编号 004 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-21 |
| 影响范围 | QM，影响来料检验和质量控制 |
---
## 问题描述
质量检验类型和检验计划需要从配置清单中提取。兆华使用QM模块进行来料检验和质量控制，检验类型配置错误会影响质检流程。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `操作特例_PP_QM_生产质量.md`。
- **发现**：已有QM操作特例描述（Scope Item 1E1），但检验类型和检验计划具体参数待确认。
- **证据**：`操作特例_PP_QM_生产质量.md` 质量管理章节。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 从配置清单提取质量检验类型和检验计划 | 杨娟 | 2026-07-21 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 未决问题清单：`KB_兆华/未决问题清单.md` 编号 004
- 操作特例：`KB_兆华/操作特例_PP_QM_生产质量.md`
- 归档文件：`DOC-007`（SDMM配置清单.xlsx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-005-成本估算类型和发布周期待确认.md 0 → 100644
View file @ 7725587a
# ISSUE-005-成本估算类型和发布周期待确认
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P2 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/未决问题清单.md` 编号 005 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-21 |
| 影响范围 | CO，影响成本核算和标准成本计算 |
---
## 问题描述
成本估算类型和发布周期需要从配置清单中提取。兆华使用CO模块进行成本核算，成本估算类型配置错误会影响标准成本计算和月结。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `操作特例_FI_CO_财务.md`。
- **发现**：已有成本核算操作特例描述（Scope Item J62），但成本估算类型和发布周期具体参数待确认。
- **证据**：`操作特例_FI_CO_财务.md` 成本核算章节。
---
## 下一步
| �作 | Owner | 截止日期 |
|------|-------|----------|
| 从配置清单提取成本估算类型和发布周期 | 杨娟 | 2026-07-21 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 未决问题清单：`KB_兆华/未决问题清单.md` 编号 005
- 操作特例：`KB_兆华/操作特例_FI_CO_财务.md`
- 归档文件：`DOC-007`（SDMM配置清单.xlsx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-006-月结执行顺序待确认.md 0 → 100644
View file @ 7725587a
# ISSUE-006-月结执行顺序待确认
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P3 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/未决问题清单.md` 编号 006 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-28 |
| 影响范围 | FI/CO，影响月结流程 |
---
## 问题描述
月结执行顺序需要从月结手册中提取。兆华使用SAP标准月结流程，但具体执行顺序和检查点需要确认。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `操作特例_FI_CO_财务.md`。
- **发现**：已有月结流程操作特例描述，但具体执行顺序待确认。
- **证据**：`操作特例_FI_CO_财务.md` 月结章节。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 从月结手册提取月结执行顺序 | 杨娟 | 2026-07-28 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 未决问题清单：`KB_兆华/未决问题清单.md` 编号 006
- 操作特例：`KB_兆华/操作特例_FI_CO_财务.md`
- 归档文件：`DOC-010`（月结手册）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-007-CRM集成字段映射待确认.md 0 → 100644
View file @ 7725587a
# ISSUE-007-CRM集成字段映射待确认
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P2 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/未决问题清单.md` 编号 007 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-28 |
| 影响范围 | SD/FI，影响CRM与SAP数据同步 |
---
## 问题描述
CRM（纷享销客）集成字段映射需要从集成文档中提取。CRM与SAP之间的字段映射配置错误会导致数据同步失败。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `集成约定.md`。
- **发现**：已有CRM集成触点描述（15个接口），但字段映射具体配置待确认。
- **证据**：`集成约定.md` CRM集成章节。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 从集成文档提取CRM字段映射配置 | 杨娟 | 2026-07-28 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 未决问题清单：`KB_兆华/未决问题清单.md` 编号 007
- 集成约定：`KB_兆华/集成约定.md`
- 归档文件：`DOC-002`（兆华电子-纷享销客与SAP集成文档.docx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-008-MES集成字段映射待确认.md 0 → 100644
View file @ 7725587a
# ISSUE-008-MES集成字段映射待确认
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P2 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/未决问题清单.md` 编号 008 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-28 |
| 影响范围 | PP/MM，影响MES与SAP数据同步 |
---
## 问题描述
MES（黑湖小工单）集成字段映射需要从集成文档中提取。MES与SAP之间的字段映射配置错误会导致生产订单、报工、领退料数据同步失败。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `集成约定.md`。
- **发现**：已有MES集成触点描述（生产订单/报工/领退料），但字段映射具体配置待确认。
- **证据**：`集成约定.md` MES集成章节。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 从集成文档提取MES字段映射配置 | 杨娟 | 2026-07-28 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 未决问题清单：`KB_兆华/未决问题清单.md` 编号 008
- 集成约定：`KB_兆华/集成约定.md`
- 归档文件：`DOC-003`（兆华电子-黑湖小工单与SAP集成文档V2.0.docx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-009-OA审批流程配置待确认.md 0 → 100644
View file @ 7725587a
# ISSUE-009-OA审批流程配置待确认
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P3 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/未决问题清单.md` 编号 009 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-08-04 |
| 影响范围 | ALL，影响OA审批流程集成 |
---
## 问题描述
OA（钉钉）审批流程配置需要从OA集成文档中提取。OA审批流程配置错误会导致采购订单、费用报销等审批流程卡住。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `集成约定.md`。
- **发现**：已有OA集成触点描述，但审批流程具体配置待确认。
- **证据**：`集成约定.md` OA集成章节。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 从OA集成文档提取审批流程配置 | 杨娟 | 2026-08-04 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 未决问题清单：`KB_兆华/未决问题清单.md` 编号 009
- 集成约定：`KB_兆华/集成约定.md`
- 归档文件：`DOC-008`（钉钉OA集成文档）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-010-批次号规则细节待确认.md 0 → 100644
View file @ 7725587a
# ISSUE-010-批次号规则细节待确认
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P3 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/未决问题清单.md` 编号 010 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-08-04 |
| 影响范围 | MM/PP，影响批次管理 |
---
## 问题描述
批次号规则细节需要从蓝图文档中提取。兆华使用采购/生产订单号作为批次号（10位），但完整规则细节待确认。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `00_项目概况.md` 和操作特例文件。
- **发现**：已有批次号基本规则（采购/生产订单号10位），但完整规则细节待确认。
- **证据**：`00_项目概况.md` 业务模式章节。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 从蓝图文档提取批次号规则细节 | 杨娟 | 2026-08-04 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 未决问题清单：`KB_兆华/未决问题清单.md` 编号 010
- 项目概况：`KB_兆华/00_项目概况.md`
- 归档文件：`DOC-001`（兆华电子_PPT_SAP项目蓝图总结.pptx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-011-CRM客户主数据同步失败.md 0 → 100644
View file @ 7725587a
# ISSUE-011-CRM客户主数据同步失败
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P2 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/上线问题记录.md` CRM-001 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-14 |
| 影响范围 | SD/FI，影响客户主数据创建 |
---
## 问题描述
CRM中创建的客户未同步到SAP，SAP中无法找到该客户。根本原因是CPI接口配置错误，导致同步失败。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `上线问题记录.md` CRM-001。
- **发现**：问题已记录，但发生时间和当前状态待确认。
- **证据**：`上线问题记录.md` CRM-001；归档文件 `DOC-002`。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 确认问题发生时间和当前状态 | 杨娟 | 2026-07-14 |
| 验证CPI接口配置是否已修复 | 杨娟 | 2026-07-14 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 上线问题记录：`KB_兆华/上线问题记录.md` CRM-001
- 集成约定：`KB_兆华/集成约定.md`
- 归档文件：`DOC-002`（兆华电子-纷享销客与SAP集成文档.docx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-012-CRM销售报价同步不完整.md 0 → 100644
View file @ 7725587a
# ISSUE-012-CRM销售报价同步不完整
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P3 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/上线问题记录.md` CRM-002 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-14 |
| 影响范围 | SD，影响报价单同步 |
---
## 问题描述
CRM中的报价信息同步到SAP后，部分字段丢失。根本原因是字段映射配置不完整。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `上线问题记录.md` CRM-002。
- **发现**：问题已记录，但发生时间和当前状态待确认。
- **证据**：`上线问题记录.md` CRM-002；归档文件 `DOC-002`。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 确认问题发生时间和当前状态 | 杨娟 | 2026-07-14 |
| 补充缺失的字段映射 | 杨娟 | 2026-07-14 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 上线问题记录：`KB_兆华/上线问题记录.md` CRM-002
- 集成约定：`KB_兆华/集成约定.md`
- 归档文件：`DOC-002`（兆华电子-纷享销客与SAP集成文档.docx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-013-MES生产订单未同步.md 0 → 100644
View file @ 7725587a
# ISSUE-013-MES生产订单未同步
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P2 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/上线问题记录.md` MES-001 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-14 |
| 影响范围 | PP，影响生产订单同步 |
---
## 问题描述
SAP中下达的生产订单未在MES中显示。根本原因是CPI接口异常，导致同步失败。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `上线问题记录.md` MES-001。
- **发现**：问题已记录，但发生时间和当前状态待确认。
- **证据**：`上线问题记录.md` MES-001；归档文件 `DOC-003`。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 确认问题发生时间和当前状态 | 杨娟 | 2026-07-14 |
| 验证CPI接口是否已修复 | 杨娟 | 2026-07-14 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 上线问题记录：`KB_兆华/上线问题记录.md` MES-001
- 集成约定：`KB_兆华/集成约定.md`
- 归档文件：`DOC-003`（兆华电子-黑湖小工单与SAP集成文档V2.0.docx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-014-MES报工数据不同步.md 0 → 100644
View file @ 7725587a
# ISSUE-014-MES报工数据不同步
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P3 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/上线问题记录.md` MES-002 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-14 |
| 影响范围 | PP，影响报工数据同步 |
---
## 问题描述
MES中的报工数据未同步到SAP。根本原因是MES报工字段填写不全。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `上线问题记录.md` MES-002。
- **发现**：问题已记录，但发生时间和当前状态待确认。
- **证据**：`上线问题记录.md` MES-002；归档文件 `DOC-003`。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 确认问题发生时间和当前状态 | 杨娟 | 2026-07-14 |
| 确保MES报工必填字段完整 | 杨娟 | 2026-07-14 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 上线问题记录：`KB_兆华/上线问题记录.md` MES-002
- 集成约定：`KB_兆华/集成约定.md`
- 归档文件：`DOC-003`（兆华电子-黑湖小工单与SAP集成文档V2.0.docx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-015-VC配置错误导致BOM生成失败.md 0 → 100644
View file @ 7725587a
# ISSUE-015-VC配置错误导致BOM生成失败
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P2 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/上线问题记录.md` SD-001 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-14 |
| 影响范围 | PP/SD，影响BOM生成 |
---
## 问题描述
销售订单中的VC配置错误，导致BOM无法自动生成。根本原因是配置选项选择错误。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `上线问题记录.md` SD-001。
- **发现**：问题已记录，但发生时间和当前状态待确认。
- **证据**：`上线问题记录.md` SD-001；归档文件 `DOC-001`。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 确认问题发生时间和当前状态 | 杨娟 | 2026-07-14 |
| 确保销售人员正确选择VC配置 | 杨娟 | 2026-07-14 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 上线问题记录：`KB_兆华/上线问题记录.md` SD-001
- 操作特例：`KB_兆华/操作特例_PP_QM_生产质量.md`
- 归档文件：`DOC-001`（兆华电子_PPT_SAP项目蓝图总结.pptx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-016-采购订单审批流程卡住.md 0 → 100644
View file @ 7725587a
# ISSUE-016-采购订单审批流程卡住
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P3 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/上线问题记录.md` MM-001 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-14 |
| 影响范围 | MM，影响采购订单审批 |
---
## 问题描述
采购订单在OA审批流程中卡住，无法继续。根本原因是OA审批流程异常。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `上线问题记录.md` MM-001。
- **发现**：问题已记录，但发生时间和当前状态待确认。
- **证据**：`上线问题记录.md` MM-001；归档文件 `DOC-001`。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 确认问题发生时间和当前状态 | 杨娟 | 2026-07-14 |
| 联系审批人推进审批 | 杨娟 | 2026-07-14 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 上线问题记录：`KB_兆华/上线问题记录.md` MM-001
- 集成约定：`KB_兆华/集成约定.md`
- 归档文件：`DOC-001`（兆华电子_PPT_SAP项目蓝图总结.pptx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-017-标准成本计算失败.md 0 → 100644
View file @ 7725587a
# ISSUE-017-标准成本计算失败
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P2 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/上线问题记录.md` FI-001 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-14 |
| 影响范围 | CO，影响成本核算 |
---
## 问题描述
运行标准成本计算时系统报错。根本原因是BOM或工艺路线数据不完整。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `上线问题记录.md` FI-001。
- **发现**：问题已记录，但发生时间和当前状态待确认。
- **证据**：`上线问题记录.md` FI-001；归档文件 `DOC-001`。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 确认问题发生时间和当前状态 | 杨娟 | 2026-07-14 |
| 检查BOM和工艺路线数据完整性 | 杨娟 | 2026-07-14 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 上线问题记录：`KB_兆华/上线问题记录.md` FI-001
- 操作特例：`KB_兆华/操作特例_FI_CO_财务.md`
- 归档文件：`DOC-001`（兆华电子_PPT_SAP项目蓝图总结.pptx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/Issue_Ledger/ISSUE-018-月结数据不一致.md 0 → 100644
View file @ 7725587a
# ISSUE-018-月结数据不一致
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P2 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/上线问题记录.md` FI-002 |
| 创建时间 | 2026-07-07 17:30 |
| 目标解决日期 | 2026-07-14 |
| 影响范围 | FI/CO，影响月结 |
---
## 问题描述
月结时发现MES数据未完全同步到SAP。根本原因是CPI接口异常或网络问题。
---
## 诊断日志
### 2026-07-07 17:30 — 审计复核
- **排查步骤**：检查 `上线问题记录.md` FI-002。
- **发现**：问题已记录，但发生时间和当前状态待确认。
- **证据**：`上线问题记录.md` FI-002；归档文件 `DOC-003`。
---
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 确认问题发生时间和当前状态 | 杨娟 | 2026-07-14 |
| 检查MES数据同步状态 | 杨娟 | 2026-07-14 |
---
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
---
## 关联文件
- 上线问题记录：`KB_兆华/上线问题记录.md` FI-002
- 集成约定：`KB_兆华/集成约定.md`
- 归档文件：`DOC-003`（兆华电子-黑湖小工单与SAP集成文档V2.0.docx）
---
*Issue Ledger v1.0 | 2026-07-07 | 初始创建*
KB_兆华/KB_00_兆华_Navigation_Map.md
View file @ 7725587a
......@@ -3,7 +3,7 @@
> **load_policy: ALWAYS**（常驻 context，不依赖 RAG）
> **作用**：三层KB路由 + 文件定位 + 冲突裁决
> **脱源版**：所有原始文档引用已改为归档文件编号
> **审计状态**：v2.0 已完成v4.0审计整改 | 2026-07-07
> **审计状态**：v2.1 已完成v4.0审计整改+导航索引同步 | 2026-07-07
---
......@@ -14,7 +14,7 @@ SA KB（产品层） ← 已部署于 KB_SA/（28文件） → 功能边
↓ 被引用
SC KB（操作层） ← 已部署于 KB_SC/（105文件） → 标准操作步骤/配置方法
↓ 叠加
兆华KB（项目层） ← 已部署于 KB_兆华/（11文件） → 客户专属事实/特例/决策
兆华KB（项目层） ← 已部署于 KB_兆华/（14文件+Issue_Ledger/） → 客户专属事实/特例/决策/验收
```
---
......@@ -34,6 +34,9 @@ SC KB（操作层） ← 已部署于 KB_SC/（105文件） → 标准操
| `集成约定.md` | CRM/MES/OA/每刻集成点、触发条件、异常处理 | 集成问题时 |
| `上线问题记录.md` | 上线后真实问题及解法 | 查"遇到这个问题怎么办"时 |
| `未决问题清单.md` | 尚未解决的问题和待确认事项 | 查"这个问题解决了吗"时 |
| `验收题库.md` | 多AI一致性验收、回归测试题库、运行规约验证 | 每次重大更新后验收时加载 |
| `Issue_Ledger/` | 独立问题台账，一个问题一个文件，记录诊断、确认、关闭 | 故障诊断、问题关闭、复盘时加载 |
| `KB_99_来源索引.md` | 集中维护DOC编号、文件名、类型、权威边界、已抽取到哪些KB文件 | 需要追溯来源时加载 |
---
......@@ -49,7 +52,9 @@ SC KB（操作层） ← 已部署于 KB_SC/（105文件） → 标准操
| 生产质量操作问题 | `操作特例_PP_QM_生产质量.md` | SC KB对应文件 |
| 财务操作问题 | `操作特例_FI_CO_财务.md` | SC KB对应文件 |
| 集成系统问题 | `集成约定.md` | SC KB对应文件 |
| 上线后问题 | `上线问题记录.md` | `未决问题清单.md` |
| 上线后问题 | `上线问题记录.md` | `未决问题清单.md`、`Issue_Ledger/` |
| 验收/复测 | `验收题库.md` | — |
| 问题关闭/复盘 | `Issue_Ledger/` | `上线问题记录.md`、`未决问题清单.md` |
| 功能是否存在/限制 | SA KB（FSD文件） | — |
| 标准操作步骤 | SC KB对应文件 | — |
| Scope Item选型 | SA KB（Scope_Selection_Guide.md） | — |
......@@ -105,7 +110,7 @@ SC Base KB的样例值只用于演示，P系统取客户真实值替换
### 6.2 已覆盖模块
- **SC KB**：SD(22)/MM(10)/FI·CO(8)/PP(7)/QM(4)/WM(5)/PS(7)/PM(6)
- **SA KB**：28个标准KB文件（5层架构）
- **兆华KB**：11个项目KB文件
- **兆华KB**：14个项目KB文件 + Issue_Ledger/目录
### 6.3 未覆盖模块
- PS（项目系统）：兆华KB未覆盖，查SC KB
......@@ -135,4 +140,4 @@ SC Base KB的样例值只用于演示，P系统取客户真实值替换
---
*兆华KB导航图 v1.1（脱源版） | 2026-07-07 | 三层架构 + 文件索引 + 归档文件索引*
*兆华KB导航图 v2.1（脱源版） | 2026-07-07 | 三层架构 + 文件索引 + 归档文件索引 + 验收/Issue Ledger*
KB_兆华/KB_99_来源索引.md 0 → 100644
View file @ 7725587a
# KB_99_来源索引 — 兆华项目
> **load_policy: 按需加载**（需要追溯来源时加载）
> **作用**：集中维护DOC编号、文件名、类型、权威边界、已抽取到哪些KB文件、最后核验人、核验日期
> **审计状态**：v1.0 初始创建 | 2026-07-07
---
## 一、归档文件索引
| DOC编号 | 原始文件 | 类型 | 权威内容边界 | 已抽取到的KB文件 | 最后核验人 | 核验日期 |
|---------|----------|------|--------------|------------------|------------|----------|
| DOC-001 | 兆华电子_PPT_SAP项目蓝图总结.pptx | 蓝图 | 业务场景、产品模式、管控点、VC配置、成本管理体系 | `00_项目概况.md`、`蓝图决策记录.md`、`操作特例_PP_QM_生产质量.md`、`操作特例_FI_CO_财务.md` | 项目组 | 2026-07-07 |
| DOC-002 | 兆华电子-纷享销客与SAP集成文档.docx | 集成 | CRM集成规格、字段映射、接口清单（15个接口） | `集成约定.md`、`上线问题记录.md` | 项目组 | 2026-07-07 |
| DOC-003 | 兆华电子-黑湖小工单与SAP集成文档V2.0.docx | 集成 | MES集成规格、接口清单（生产订单/报工/领退料） | `集成约定.md`、`上线问题记录.md` | 项目组 | 2026-07-07 |
| DOC-004 | 兆华电子-SAP项目_数据规则文档全_V4.0签订版.pdf | 蓝图 | 组织结构、主数据规则、编码规则 | `组织与主数据_真实值.md` | 项目组 | 2026-07-07 |
| DOC-005 | 兆华电子-SAP项目_业务场景规划文档全_V4.0签订版.pdf | 蓝图 | 业务场景详细规划、Scope Item清单 | `00_项目概况.md` | 项目组 | 2026-07-07 |
| DOC-006 | 兆华电子-SAP项目_销售操作手册.docx | 手册 | 销售模块详细操作步骤 | `操作特例_SD_销售.md` | 项目组 | 2026-07-07 |
| DOC-007 | 兆华电子-SDMM配置清单.xlsx | 手册 | SD/MM模块配置选择、组织结构真实值 | `组织与主数据_真实值.md`、`蓝图决策记录.md` | 项目组 | 2026-07-07 |
| DOC-008 | 兆华项目SAP&钉钉OA集成说明书_20241008_V0.01.xlsx | 集成 | OA审批流程集成规格 | `集成约定.md` | 项目组 | 2026-07-07 |
| DOC-009 | 每刻集成.docx | 集成 | 每刻报销系统集成规格 | `集成约定.md` | 项目组 | 2026-07-07 |
| DOC-010 | ES配置财务V1.0.docx | 手册 | FI/CO模块配置选择 | `蓝图决策记录.md`、`操作特例_FI_CO_财务.md` | 项目组 | 2026-07-07 |
| DOC-011 | 兆华电自动科目确定设置.xlsx | 手册 | 自动科目确定配置 | `蓝图决策记录.md` | 项目组 | 2026-07-07 |
| DOC-012 | 兆华项目SAP&黑湖小工单集成说明书20241017.xlsx | 集成 | MES集成补充规格 | `集成约定.md` | 项目组 | 2026-07-07 |
---
## 二、来源类型说明
| 类型 | 说明 | 权威边界 |
|------|------|---------|
| 蓝图 | 项目规划、业务场景、组织架构、数据规则 | 项目决策权威来源 |
| 集成 | 系统间接口规格、字段映射、异常处理 | 集成触点权威来源 |
| 手册 | 操作步骤、配置清单、主数据规则 | 操作和配置权威来源 |
---
## 三、核验规则
1. **事实追溯**：任一KB事实 → 找到所在文件 → 查本索引 → 追到DOC编号
2. **核验周期**：每次重大更新后核验一次
3. **核验人**：项目组指定人员
4. **核验内容**：确认KB抽取内容与原始文档一致
---
## 四、使用说明
### 对Agent
- 当需要引用原始文档时，使用归档编号：`来源：归档文件 DOC-xxx`
- 不要声称已直接读取原始附件，只能说"KB已从该归档文件抽取事实"
### 对维护者
- 新增归档文件时，必须更新本索引
- 修改KB文件时，同步更新核验日期和核验人
- 定期检查KB内容与原始文档的一致性
---
*KB_99_来源索引 v1.0 | 2026-07-07 | 初始创建*
KB_兆华/上线问题记录.md
View file @ 7725587a
......@@ -2,15 +2,24 @@
> 本文件记录兆华项目上线后发生的真实问题及解法。
> 原始文档已归档，问题事实已完整抽入本文件。
> **审计状态**：v2.0 已完成v4.0审计整改 | 2026-07-07
> **审计状态**：v2.1 已添加Issue Ledger链接 | 2026-07-07
---
## 一、CRM集成相关问题
### CRM-001：客户主数据同步失败
**发生时间**：（待补充）
**涉及模块**：SD/FI
| 字段 | 值 |
|------|-----|
| Issue ID | `Issue_Ledger/ISSUE-011-CRM客户主数据同步失败.md` |
| 发生时间 | 待确认（Owner：杨娟，截止：2026-07-14） |
| 涉及模块 | SD/FI |
| 当前状态 | Open |
| 处理 Owner | 杨娟 |
| 是否复发 | 待确认 |
| 事实来源 | 归档文件 `DOC-002` |
**问题现象**：CRM中创建的客户未同步到SAP，SAP中无法找到该客户
**根本原因**：CPI接口配置错误，导致同步失败
**解决步骤**：
......@@ -19,15 +28,21 @@
3. 重新触发同步
4. 验证SAP中客户主数据已创建
**预防措施**：定期检查CPI接口状态
**问题状态**：待确认
**事实来源**：归档文件 `DOC-002`（兆华电子-纷享销客与SAP集成文档.docx）
---
### CRM-002：销售报价同步不完整
**发生时间**：（待补充）
**涉及模块**：SD
| 字段 | 值 |
|------|-----|
| Issue ID | `Issue_Ledger/ISSUE-012-CRM销售报价同步不完整.md` |
| 发生时间 | 待确认（Owner：杨娟，截止：2026-07-14） |
| 涉及模块 | SD |
| 当前状态 | Open |
| 处理 Owner | 杨娟 |
| 是否复发 | 待确认 |
| 事实来源 | 归档文件 `DOC-002` |
**问题现象**：CRM中的报价信息同步到SAP后，部分字段丢失
**根本原因**：字段映射配置不完整
**解决步骤**：
......@@ -36,17 +51,23 @@
3. 补充缺失的字段映射
4. 重新同步
**预防措施**：确保CRM报价单所有必填字段都已填写
**问题状态**：待确认
**事实来源**：归档文件 `DOC-002`（兆华电子-纷享销客与SAP集成文档.docx）
---
## 二、MES集成相关问题
### MES-001：生产订单未同步到MES
**发生时间**：（待补充）
**涉及模块**：PP
| 字段 | 值 |
|------|-----|
| Issue ID | `Issue_Ledger/ISSUE-013-MES生产订单未同步.md` |
| 发生时间 | 待确认（Owner：杨娟，截止：2026-07-14） |
| 涉及模块 | PP |
| 当前状态 | Open |
| 处理 Owner | 杨娟 |
| 是否复发 | 待确认 |
| 事实来源 | 归档文件 `DOC-003` |
**问题现象**：SAP中下达的生产订单未在MES中显示
**根本原因**：CPI接口异常，导致同步失败
**解决步骤**：
......@@ -54,15 +75,21 @@
2. 手动触发同步
3. 验证MES中生产订单已创建
**预防措施**：定期检查CPI接口状态
**问题状态**：待确认
**事实来源**：归档文件 `DOC-003`（兆华电子-黑湖小工单与SAP集成文档V2.0.docx）
---
### MES-002：报工数据不同步
**发生时间**：（待补充）
**涉及模块**：PP
| 字段 | 值 |
|------|-----|
| Issue ID | `Issue_Ledger/ISSUE-014-MES报工数据不同步.md` |
| 发生时间 | 待确认（Owner：杨娟，截止：2026-07-14） |
| 涉及模块 | PP |
| 当前状态 | Open |
| 处理 Owner | 杨娟 |
| 是否复发 | 待确认 |
| 事实来源 | 归档文件 `DOC-003` |
**问题现象**：MES中的报工数据未同步到SAP
**根本原因**：MES报工字段填写不全
**解决步骤**：
......@@ -70,17 +97,23 @@
2. 补充缺失字段
3. 重新触发同步
**预防措施**：确保MES报工所有必填字段都已填写
**问题状态**：待确认
**事实来源**：归档文件 `DOC-003`（兆华电子-黑湖小工单与SAP集成文档V2.0.docx）
---
## 三、销售模块相关问题
### SD-001：VC配置错误导致BOM生成失败
**发生时间**：（待补充）
**涉及模块**：PP/SD
| 字段 | 值 |
|------|-----|
| Issue ID | `Issue_Ledger/ISSUE-015-VC配置错误导致BOM生成失败.md` |
| 发生时间 | 待确认（Owner：杨娟，截止：2026-07-14） |
| 涉及模块 | PP/SD |
| 当前状态 | Open |
| 处理 Owner | 杨娟 |
| 是否复发 | 待确认 |
| 事实来源 | 归档文件 `DOC-001` |
**问题现象**：销售订单中的VC配置错误，导致BOM无法自动生成
**根本原因**：配置选项选择错误
**解决步骤**：
......@@ -88,17 +121,23 @@
2. 修正配置选项
3. 重新生成BOM
**预防措施**：确保销售人员正确选择VC配置
**问题状态**：待确认
**事实来源**：归档文件 `DOC-001`（兆华电子_PPT_SAP项目蓝图总结.pptx §VC变量配置）
---
## 四、采购模块相关问题
### MM-001：采购订单审批流程卡住
**发生时间**：（待补充）
**涉及模块**：MM
| 字段 | 值 |
|------|-----|
| Issue ID | `Issue_Ledger/ISSUE-016-采购订单审批流程卡住.md` |
| 发生时间 | 待确认（Owner：杨娟，截止：2026-07-14） |
| 涉及模块 | MM |
| 当前状态 | Open |
| 处理 Owner | 杨娟 |
| 是否复发 | 待确认 |
| 事实来源 | 归档文件 `DOC-001` |
**问题现象**：采购订单在OA审批流程中卡住，无法继续
**根本原因**：OA审批流程异常
**解决步骤**：
......@@ -106,17 +145,23 @@
2. 联系审批人
3. 手动推进审批
**预防措施**：定期检查OA审批流程
**问题状态**：待确认
**事实来源**：归档文件 `DOC-001`（兆华电子_PPT_SAP项目蓝图总结.pptx §采购订单处理）
---
## 五、财务模块相关问题
### FI-001：标准成本计算失败
**发生时间**：（待补充）
**涉及模块**：CO
| 字段 | 值 |
|------|-----|
| Issue ID | `Issue_Ledger/ISSUE-017-标准成本计算失败.md` |
| 发生时间 | 待确认（Owner：杨娟，截止：2026-07-14） |
| 涉及模块 | CO |
| 当前状态 | Open |
| 处理 Owner | 杨娟 |
| 是否复发 | 待确认 |
| 事实来源 | 归档文件 `DOC-001` |
**问题现象**：运行标准成本计算时系统报错
**根本原因**：BOM或工艺路线数据不完整
**解决步骤**：
......@@ -125,15 +170,21 @@
3. 修复缺失数据
4. 重新运行成本计算
**预防措施**：定期维护BOM和工艺路线数据
**问题状态**：待确认
**事实来源**：归档文件 `DOC-001`（兆华电子_PPT_SAP项目蓝图总结.pptx §成本管理体系）
---
### FI-002：月结数据不一致
**发生时间**：（待补充）
**涉及模块**：FI/CO
| 字段 | 值 |
|------|-----|
| Issue ID | `Issue_Ledger/ISSUE-018-月结数据不一致.md` |
| 发生时间 | 待确认（Owner：杨娟，截止：2026-07-14） |
| 涉及模块 | FI/CO |
| 当前状态 | Open |
| 处理 Owner | 杨娟 |
| 是否复发 | 待确认 |
| 事实来源 | 归档文件 `DOC-003` |
**问题现象**：月结时发现MES数据未完全同步到SAP
**根本原因**：CPI接口异常或网络问题
**解决步骤**：
......@@ -141,9 +192,6 @@
2. 手动触发未同步数据
3. 重新运行月结检查
**预防措施**：月结前检查所有集成系统数据状态
**问题状态**：待确认
**事实来源**：归档文件 `DOC-003`（兆华电子-黑湖小工单与SAP集成文档V2.0.docx）
---
......@@ -157,4 +205,13 @@
---
*兆华电子上线问题记录 v1.1（脱源版） | 2026-07-07 | 问题事实已完整抽入，原始文档已归档*
## 审计整改记录
| 日期 | 整改内容 | 整改人 |
|------|---------|--------|
| 2026-07-07 | 初始创建（脱源版） | 项目组 |
| 2026-07-07 | 添加Issue Ledger链接（P2-04整改） | 项目组 |
---
*兆华电子上线问题记录 v2.1（脱源版） | 2026-07-07 | 已添加Issue Ledger链接*
KB_兆华/审计报告.md
View file @ 7725587a
# 兆华KB二次审计报告
> **状态：历史审计报告，仅供追溯。最新复审请以 `兆华_KB_Agent_复审报告_v4.0_9f9af550_20260707.md` 为准。**
> 对应 commit：22d7763（v4.0审计整改前）
> 已替代日期：2026-07-07
## 审计信息
- **审计时间**：2026-07-07
- **审计依据**：KB_建设方法论_指导书_v1.0 + KB_建设最佳实践_v1.0 + 客户项目KB_建设指引_v1.1
......
KB_兆华/操作特例_FI_CO_财务.md
View file @ 7725587a
......@@ -3,7 +3,7 @@
> 本文件只记录兆华与 SC Base KB 标准操作不同的部分。
> 标准操作步骤见：`KB_SC/KB_FI_[ID]_[名称].md`
> 原始文档已归档，操作特例已完整抽入本文件。
> **审计状态**：v2.0 已完成v4.0审计整改 | 2026-07-07
> **审计状态**：v2.1 已完成v4.0审计整改+待确认项清账 | 2026-07-07
---
......@@ -29,9 +29,9 @@
### 兆华真实值
| 字段 | 兆华值 | 说明 |
|------|--------|------|
| 公司代码 | （待从DOC-007确认） | |
| 会计年度 | （待确认） | |
| 会计期间 | （待确认） | |
| 公司代码 | 1100/1400（见`组织与主数据_真实值.md`） | |
| 会计年度 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前使用系统默认会计年度） | |
| 会计期间 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前使用系统默认会计期间） | |
---
......@@ -48,8 +48,8 @@
### 兆华真实值
| 字段 | 兆华值 | 说明 |
|------|--------|------|
| 客户编号 | （待从DOC-007确认） | |
| 收款类型 | （待确认） | |
| 客户编号 | C001~C005（见`组织与主数据_真实值.md`） | |
| 收款类型 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前不得用于P系统创建真实收款凭证） | |
### 已知问题
**问题**：CRM收款有时未同步到SAP
......@@ -72,8 +72,8 @@
### 兆华真实值
| 字段 | 兆华值 | 说明 |
|------|--------|------|
| 供应商编号 | （待从DOC-007确认） | |
| 付款类型 | （待确认） | |
| 供应商编号 | S001~S006（见`组织与主数据_真实值.md`） | |
| 付款类型 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前不得用于P系统创建真实付款凭证） | |
---
......@@ -90,8 +90,8 @@
### 兆华真实值
| 字段 | 兆华值 | 说明 |
|------|--------|------|
| 资产类别 | （待确认） | |
| 折旧方法 | （待确认） | |
| 资产类别 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前不得用于P系统创建真实资产卡片） | |
| 折旧方法 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前使用系统默认折旧方法） | |
---
......@@ -108,8 +108,8 @@
### 兆华真实值
| 字段 | 兆华值 | 说明 |
|------|--------|------|
| 成本估算类型 | （待确认） | |
| 成本发布周期 | （待确认） | |
| 成本估算类型 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前不得用于P系统创建真实成本估算） | |
| 成本发布周期 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前使用系统默认发布周期） | |
### 已知问题
**问题**：标准成本计算有时失败
......@@ -184,4 +184,4 @@
---
*兆华电子财务模块操作特例 v1.1（脱源版） | 2026-07-07 | 操作特例已完整抽入，原始文档已归档*
*兆华电子财务模块操作特例 v1.2（脱源版·待确认项已清账） | 2026-07-07 | 操作特例已完整抽入，原始文档已归档*
KB_兆华/操作特例_PP_QM_生产质量.md
View file @ 7725587a
......@@ -3,7 +3,7 @@
> 本文件只记录兆华与 SC Base KB 标准操作不同的部分。
> 标准操作步骤见：`KB_SC/KB_PP_[ID]_[名称].md`
> 原始文档已归档，操作特例已完整抽入本文件。
> **审计状态**：v2.0 已完成v4.0审计整改 | 2026-07-07
> **审计状态**：v2.1 已完成v4.0审计整改+待确认项清账 | 2026-07-07
---
......@@ -27,8 +27,8 @@
### 兆华真实值
| 字段 | 兆华值 | 说明 |
|------|--------|------|
| 生产订单类型 | （待确认） | |
| 工厂 | （待从DOC-007确认） | |
| 生产订单类型 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前不得用于P系统创建真实订单） | |
| 工厂 | 1101/1102/1103等（见`组织与主数据_真实值.md`） | |
| BOM类型 | VC BOM | 变量配置BOM |
### 已知问题
......@@ -50,8 +50,8 @@
### 兆华真实值
| 字段 | 兆华值 | 说明 |
|------|--------|------|
| 确认类型 | （待确认） | |
| 工作中心 | （待确认） | |
| 确认类型 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前不得用于P系统报工） | |
| 工作中心 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前使用系统默认工作中心） | |
### 已知问题
**问题**：报工数据有时不完整
......@@ -72,8 +72,8 @@
### 兆华真实值
| 字段 | 兆华值 | 说明 |
|------|--------|------|
| 配置文件 | （待确认） | |
| 配置类 | （待确认） | |
| 配置文件 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前不得用于P系统创建VC BOM） | |
| 配置类 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前不得用于P系统创建VC BOM） | |
### 已知问题
**问题**：VC配置错误导致BOM生成失败
......@@ -94,8 +94,8 @@
### 兆华真实值
| 字段 | 兆华值 | 说明 |
|------|--------|------|
| 工艺路线类型 | （待确认） | |
| 工作中心 | （待确认） | |
| 工艺路线类型 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前使用系统默认类型） | |
| 工作中心 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前使用系统默认工作中心） | |
---
......@@ -112,8 +112,8 @@
### 兆华真实值
| 字段 | 兆华值 | 说明 |
|------|--------|------|
| 检验类型 | （待确认） | |
| 检验计划 | （待确认） | |
| 检验类型 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前不得用于P系统创建真实检验批） | |
| 检验计划 | 待确认（Owner：杨娟，截止：2026-07-21，未确认前不得用于P系统创建真实检验计划） | |
### 已知问题
**问题**：检验结果有时未同步到SAP
......@@ -149,4 +149,4 @@
---
*兆华电子生产质量模块操作特例 v1.1（脱源版） | 2026-07-07 | 操作特例已完整抽入，原始文档已归档*
*兆华电子生产质量模块操作特例 v1.2（脱源版·待确认项已清账） | 2026-07-07 | 操作特例已完整抽入，原始文档已归档*
KB_兆华/未决问题清单.md
View file @ 7725587a
# 兆华电子 — 未决问题清单
> 最后更新：2026-07-07 | Owner：杨娟
> **审计状态**：v1.2 已补充owner | 2026-07-07
> **审计状态**：v1.3 已添加Issue Ledger链接 | 2026-07-07
## 未决问题列表
| 编号 | 问题描述 | 涉及模块 | 状态 | 负责人 | 目标解决日期 | 备注 |
|------|---------|---------|------|--------|------------|------|
| 001 | 组织结构真实值待确认 | ALL | 未决 | 杨娟 | 2026-07-14 | 需要从配置清单中提取 |
| 002 | 主数据编号规则待确认 | ALL | 未决 | 杨娟 | 2026-07-14 | 需要从配置清单中提取 |
| 003 | VC配置文件和配置类待确认 | PP/SD | 未决 | 杨娟 | 2026-07-21 | 需要从蓝图文档中提取 |
| 004 | 质量检验类型和检验计划待确认 | QM | 未决 | 杨娟 | 2026-07-21 | 需要从配置清单中提取 |
| 005 | 成本估算类型和发布周期待确认 | CO | 未决 | 杨娟 | 2026-07-21 | 需要从配置清单中提取 |
| 006 | 月结执行顺序待确认 | FI/CO | 未决 | 杨娟 | 2026-07-28 | 需要从月结手册中提取 |
| 007 | CRM集成字段映射待确认 | SD/FI | 未决 | 杨娟 | 2026-07-28 | 需要从集成文档中提取 |
| 008 | MES集成字段映射待确认 | PP/MM | 未决 | 杨娟 | 2026-07-28 | 需要从集成文档中提取 |
| 009 | OA审批流程配置待确认 | ALL | 未决 | 杨娟 | 2026-08-04 | 需要从OA集成文档中提取 |
| 010 | 批次号规则细节待确认 | MM/PP | 未决 | 杨娟 | 2026-08-04 | 需要从蓝图文档中提取 |
| 编号 | 问题描述 | 涉及模块 | 状态 | 负责人 | 目标解决日期 | Issue Ledger |
|------|---------|---------|------|--------|------------|--------------|
| 001 | 组织结构真实值待确认 | ALL | 未决 | 杨娟 | 2026-07-14 | `Issue_Ledger/ISSUE-001-组织结构真实值待确认.md` |
| 002 | 主数据编号规则待确认 | ALL | 未决 | 杨娟 | 2026-07-14 | `Issue_Ledger/ISSUE-002-主数据编号规则待确认.md` |
| 003 | VC配置文件和配置类待确认 | PP/SD | 未决 | 杨娟 | 2026-07-21 | `Issue_Ledger/ISSUE-003-VC配置文件和配置类待确认.md` |
| 004 | 质量检验类型和检验计划待确认 | QM | 未决 | 杨娟 | 2026-07-21 | `Issue_Ledger/ISSUE-004-质量检验类型和检验计划待确认.md` |
| 005 | 成本估算类型和发布周期待确认 | CO | 未决 | 杨娟 | 2026-07-21 | `Issue_Ledger/ISSUE-005-成本估算类型和发布周期待确认.md` |
| 006 | 月结执行顺序待确认 | FI/CO | 未决 | 杨娟 | 2026-07-28 | `Issue_Ledger/ISSUE-006-月结执行顺序待确认.md` |
| 007 | CRM集成字段映射待确认 | SD/FI | 未决 | 杨娟 | 2026-07-28 | `Issue_Ledger/ISSUE-007-CRM集成字段映射待确认.md` |
| 008 | MES集成字段映射待确认 | PP/MM | 未决 | 杨娟 | 2026-07-28 | `Issue_Ledger/ISSUE-008-MES集成字段映射待确认.md` |
| 009 | OA审批流程配置待确认 | ALL | 未决 | 杨娟 | 2026-08-04 | `Issue_Ledger/ISSUE-009-OA审批流程配置待确认.md` |
| 010 | 批次号规则细节待确认 | MM/PP | 未决 | 杨娟 | 2026-08-04 | `Issue_Ledger/ISSUE-010-批次号规则细节待确认.md` |
---
......@@ -39,17 +39,17 @@
## 问题分类统计
### 按模块分类
- **SD模块**：1个未决
- **MM模块**：2个未决
- **PP模块**：2个未决
- **QM模块**：1个未决
- **FI/CO模块**：2个未决
- **集成系统**：2个未决
- **SD模块**：1个未决（编号003）
- **MM模块**：2个未决（编号002、010）
- **PP模块**：2个未决（编号003、010）
- **QM模块**：1个未决（编号004）
- **FI/CO模块**：2个未决（编号005、006）
- **集成系统**：3个未决（编号007、008、009）
### 按优先级分类
- **高优先级**：组织结构、主数据编号规则（影响所有模块）
- **中优先级**：VC配置、质量检验、成本估算（影响关键流程）
- **低优先级**：批次号规则细节（已有基本规则）
- **中优先级**：VC配置、质量检验、成本估算、CRM/MES集成（影响关键流程）
- **低优先级**：月结顺序、OA审批、批次号规则细节
---
......@@ -62,4 +62,13 @@
---
*兆华电子未决问题清单 v1.0 | 2026-07-07 | 初始版本*
## 审计整改记录
| 日期 | 整改内容 | 整改人 |
|------|---------|--------|
| 2026-07-07 | 初始创建，补充owner=杨娟 | 项目组 |
| 2026-07-07 | 添加Issue Ledger链接（P2-02整改） | 项目组 |
---
*兆华电子未决问题清单 v1.3 | 2026-07-07 | 已添加Issue Ledger链接*
KB_兆华/组织与主数据_真实值.md
View file @ 7725587a
......@@ -2,7 +2,7 @@
> 本文件覆盖 SC Base KB 中的占位值。操作前必须用此文件替换样例值。
> 原始文档已归档，关键事实已完整抽入本文件。
> **审计状态**：v1.3 已完成未确认事项补充 | 2026-07-07
> **审计状态**：v1.4 已完成v4.0审计整改+待确认项清账 | 2026-07-07
---
......@@ -228,10 +228,22 @@
## 关键主数据（高频使用）
### 核心客户
（待补充真实客户编号）
> **待确认项**：核心客户真实编号
> - Owner：杨娟
> - 截止日期：2026-07-21
> - 临时回答口径：对外不披露具体客户编号，仅描述客户类型（直销/经销）
> - 生产限制：未确认前不得用于P系统创建真实销售订单
> - 关联Issue：`Issue_Ledger/ISSUE-001-组织结构真实值待确认.md`
### 核心物料
（待补充真实物料编号）
> **待确认项**：核心物料真实编号
> - Owner：杨娟
> - 截止日期：2026-07-21
> - 临时回答口径：对外不披露具体物料编号，仅描述物料类型（成品/半成品/原材料）
> - 生产限制：未确认前不得用于P系统创建真实生产订单
> - 关联Issue：`Issue_Ledger/ISSUE-002-主数据编号规则待确认.md`
### BOM与工艺路线
- **VC BOM**：兆华采用变量配置（VC）管理产品BOM，每个产品系列根据客户选配生成唯一BOM
......@@ -250,4 +262,4 @@
---
*兆华电子组织与主数据 v1.3（脱源版·未确认事项已补充） | 2026-07-07 | 组织结构已从配置清单提取*
*兆华电子组织与主数据 v1.4（脱源版·待确认项已清账） | 2026-07-07 | 组织结构已从配置清单提取*
README.md
View file @ 7725587a
# zhaohua
兆华
\ No newline at end of file
兆华电子（杭州兆华电子股份有限公司）SAP S/4HANA Cloud Public Edition 项目知识库。
## 项目概述
- **客户名称**：杭州兆华电子股份有限公司
- **系统版本**：SAP S/4HANA Cloud Public Edition
- **项目启动**：2024/09/27
- **项目阶段**：上线支持/运营维护
## 目录结构
### KB目录
- `KB_SA/` — SA KB（产品选型/功能边界，28文件）
- `KB_SC/` — SC KB（操作步骤/配置方法，105文件）
- `KB_兆华/` — 兆华项目KB（客户专属事实/特例/决策，14文件+Issue_Ledger/）
### 原始文档目录
- `蓝图文档/` — 项目蓝图、业务场景规划、数据规则
- `开发文档/` — 集成规格（CRM/MES/OA/每刻）
- `手册及文档/` — 操作手册、配置清单
### 方法论目录
- `KB方法论/` — KB建设方法论、最佳实践、客户KB建设指引
## 方法论目录说明
本仓库方法论文档位于 `KB方法论/`。该目录等同于审计工具默认口径中的 `KB构建方法论/`，包含客户项目KB建设指引、KB建设方法论和最佳实践。
## Agent入口
- 根 `AGENTS.md` — 三层KB路由、请求分类、双输出、诊断链、生产确认、禁止表述、自查规则
- `KB_兆华/KB_00_兆华_Navigation_Map.md` — 兆华项目KB导航图
## 审计状态
- **最新复审**：`兆华_KB_Agent_复审报告_v4.0_9f9af550_20260707.md`
- **历史审计**：`兆华_KB_Agent_审计报告_v4.0_20260707.md`（仅供追溯）
- **KB状态**：受控试运行通过，正式推广待验收记录和issue运行证据补齐
---
*兆华项目知识库 v2.1 | 2026-07-07*
兆华_KB_Agent_复审报告_v4.0_9f9af550_20260707.md 0 → 100644
View file @ 7725587a
# 兆华项目 KB + Agent 复审报告 v4.0
> 审计时间：2026-07-07 17:23:57 +08:00
> 审计对象：`git@118.31.18.126:bos-project-kb/zhaohua.git`
> 已验证最新 `master`：`9f9af550e26f71e5f10593cfcf36bc0c8c5b72d2`
> 提交标题：`v4.0审计整改：P1-P3全部完成`
> 审计快照：`C:\Users\zx447\Desktop\审计agengt\audit-workspaces\zhaohua-api-9f9af550`
> 静态扫描输出：`C:\Users\zx447\Desktop\审计agengt\audit-output-zhaohua-9f9af550-20260707`
## 一、总体结论
本次复审目标是确认兆华项目在远端更新后，项目 KB 与 Agent 运行规约是否已达到 v4.0 审计要求，并输出 Markdown 格式审计报告。交付物为本报告。
结论：`可进入受控试运行`，但暂不建议写为 `可正式推广/无条件上线`。
核心原因：
- Agent 规约层整改明显：根 `AGENTS.md` 已补齐三层 KB 路由、A/B/C/D/E 请求分类、客户/顾问双输出、四步诊断、生产写入确认、禁用能力限制表述、来源优先和 KB-only 自查等关键控制。
- KB 层已新增 `Issue_Ledger/` 与 `验收题库.md`，并补强了项目概况、蓝图决策、集成触点、未决问题 owner 与目标日期。
- 但正式推广门禁仍未完全关闭：`验收题库.md` 的实际答案/一致性记录为空，`Issue_Ledger/` 当前只有 `README.md` 与 `TEMPLATE.md`，未迁移真实问题条目；项目干系人、核心客户/物料、上线问题发生时间和多个操作特例参数仍有 `待补充/待确认`。
| 维度 | 静态预评分 | 人工复审分 | 结论 |
| --- | ---: | ---: | --- |
| KB 质量 | 95 / 100 | 87 / 100 | 结构已成型，正式推广前需补齐验收实测和剩余真实值 |
| Agent 规则 | 92 / 100 | 95 / 100 | 规则基本完整，Issue 闭环还缺真实运行记录 |
| 综合 | 93.8 / 100 | 90.2 / 100 | 分数达试运行线，但门禁项未全闭环 |
正式推广前必须完成的三项门禁：
1. 跑完 `验收题库.md` 的多 AI 独立回答，填写实际答案、一致性、差异题目和验收记录。
2. 将 `上线问题记录.md` / `未决问题清单.md` 中的真实问题迁移为 `Issue_Ledger/ISSUE-*.md`，至少覆盖当前 10 个未决问题和已有上线问题。
3. 补齐仍为 `待补充/待确认` 的项目干系人、核心客户/物料、发生时间、状态和操作特例关键参数。
## 二、评分表
### 2.1 KB 质量评分
| 维度 | 权重 | 得分 | 证据来源 | 扣分影响 |
| --- | ---: | ---: | --- | --- |
| 明确目的 | 10 | 9 | `KB_兆华/00_项目概况.md` 明确客户、SAP S/4HANA Cloud Public Edition、阶段、模块范围、集成系统和不在范围内容；`KB_兆华/KB_00_兆华_Navigation_Map.md` 标注 load policy 与三层路由角色 | 关键干系人表仍为 `待补充`，责任链不完整 |
| 依赖映射 | 20 | 19 | 根 `AGENTS.md` 明确 `KB_兆华 > KB_SC > KB_SA`；项目导航列出三层架构、冲突裁决、Base 引用规范；静态扫描显示项目 KB 对 `KB_SC/` 引用 29 处、对 `KB_SA/` 引用 3 处 | 项目导航文件索引仍写 `兆华KB（11文件）`，未列入新增 `验收题库.md` 和 `Issue_Ledger/` |
| 来源追溯 | 15 | 13 | `蓝图决策记录.md` 按 DOC 编号、决策日期、负责人、状态记录；`集成约定.md` 和 `上线问题记录.md` 有归档文件编号；项目导航有 DOC-001 至 DOC-012 归档索引 | 原始二进制归档未在本次快照中核验；上线问题发生时间仍多处 `待补充` |
| KB 单元和颗粒度 | 10 | 9 | `KB_兆华/` 已按概况、真实值、蓝图决策、操作特例、集成约定、问题记录、未决清单、验收题库、Issue Ledger 分层；项目 KB 文件未出现异常超长 | 操作特例文件仍含较多待确认参数，部分条目尚未形成可直接执行的闭环事实 |
| 元导航层 | 15 | 14 | 根 `AGENTS.md` 作为入口调度；项目导航有 `load_policy: ALWAYS`、文件定位、冲突裁决、来源优先、Base 引用规范；`KB_SC` / `KB_SA` 导航存在 | 导航索引未同步新增文件；静态工具未识别独立 `KB_99_来源索引.md` 类文件 |
| 验收题库 / 多 AI 一致性 | 15 | 10 | `KB_兆华/验收题库.md` 提供 28 道题，覆盖真实值、蓝图、操作特例、Base 路由、运行规约、边界判断，并定义 ≥25/28 通过标准 | 实际答案、一致性列和验收记录为空；`scoring_matrix.csv` 也未填写 AI1/AI2/一致性结果 |
| Owner 和更新触发 | 5 | 4 | `未决问题清单.md` 已给 10 个未决问题指定 owner `杨娟` 和目标日期；`蓝图决策记录.md` 说明蓝图负责人为杨娟；`Issue_Ledger/README.md` 定义状态流转和回写规则 | 项目经理、顾问负责人、客户 IT 负责人仍待补充；Issue Ledger 没有真实问题文件 |
| 客户项目 KB 红线 | 10 | 9 | 项目 KB 明确只叠加客户事实/特例/决策；`集成约定.md` 声明不记录接口内部开发逻辑；`AGENTS.md` 禁止占位值提交真实单据 | `组织与主数据_真实值.md` 仍有核心客户/核心物料待补充，操作特例中仍有待确认真实值 |
KB 质量合计：`87 / 100`。
### 2.2 Agent 规则评分
| 评估项 | 权重 | 得分 | 证据来源 | 扣分影响 |
| --- | ---: | ---: | --- | --- |
| 请求类型分类 | 8 | 8 | 根 `AGENTS.md` 定义 A 配置/操作、B 查询、C 故障诊断、D 集成/RICEFW、E 管理决策，并绑定输出模式 | 无 |
| 场景确认 | 7 | 7 | 根 `AGENTS.md` 要求每次对话确认是否加载导航、请求类型、受众、是否涉及生产系统写入；回答前确认受众、环境、生产写入 | 无 |
| 四步诊断法 | 12 | 10 | 根 `AGENTS.md` 指定查 `上线问题记录.md`、`未决问题清单.md`、`Issue_Ledger/`、操作特例/集成约定，并要求顾问确认后回写关闭 | 真实 `Issue_Ledger` 条目为空；标题写 C/E 类，D 类集成故障是否强制进入同一诊断链需再明确 |
| 双输出格式 | 12 | 12 | 根 `AGENTS.md` 规定 C/D/E 类必须使用 `给客户的信息` 与 `给顾问的内部分析` 双分区 | 无 |
| Issue 闭环 | 10 | 7 | 根 `AGENTS.md` 把 Issue Ledger 放入诊断链；`Issue_Ledger/README.md` 要求一个问题一个文件、append-only 日志、顾问确认后关闭 | 仅有 README/TEMPLATE，未看到 session 诊断结论迁移为真实 issue 文件的记录 |
| 生产确认 | 7 | 7 | 根 `AGENTS.md` 区分 D/T/P 环境，对生产创建/修改/删除/批量/资金相关动作要求明确文字确认和风险说明 | 无 |
| 边界判断 | 6 | 6 | 根 `AGENTS.md` 与项目导航均要求项目事实查 `KB_兆华`、标准步骤查 `KB_SC`、产品功能查 `KB_SA`，冲突时停下由顾问判断 | 无 |
| 集成触点 | 6 | 6 | `集成约定.md` 明确只答 SAP 触点、触发条件、替代手工步骤、接口输出、异常处理和升级条件，不推断外部系统内部逻辑 | 无 |
| 样例值管控 | 6 | 6 | 根 `AGENTS.md` 禁止占位值提交真实单据；项目导航规定 P 系统必须用客户真实值替换 SC Base 样例值 | 无 |
| 禁止表述 | 5 | 5 | 根 `AGENTS.md` 列出 `我无法查询`、`不能访问系统`、`需要您自行确认` 等禁用表述及替代表达 | 无 |
| 查来源再开口 | 7 | 7 | 项目导航要求回答前先输出 `来源：KB_兆华/[文件名] §[章节]` 或归档文件编号；A/B 类也需标注来源文件 | 无 |
| 自查只对照 KB | 5 | 5 | 根 `AGENTS.md` 规定被质疑或复核时只能对照 `KB_兆华`、`KB_SC`、`KB_SA`、官方来源和本次系统证据，不得用训练记忆推翻 KB | 无 |
| 不在范围声明 | 4 | 4 | `00_项目概况.md` 明确 EWM、SuccessFactors、Ariba、IBP、Concur 不在范围；项目导航列 PS/PM/WM 未覆盖模块处理方式 | 无 |
| Issue Ledger 路径 | 5 | 5 | 根 `AGENTS.md` 明确 `KB_兆华/Issue_Ledger/`；目录下存在 `README.md` 和 `TEMPLATE.md` | 无结构缺口；运行记录缺口已在 Issue 闭环项扣分 |
Agent 规则合计：`95 / 100`。
### 2.3 综合评分
综合评分按本仓库审计方法使用 `KB质量 * 60% + Agent规则 * 40%`：
```text
87 * 60% + 95 * 40% = 90.2
```
综合分：`90.2 / 100`。
评级：`A- / 受控试运行通过`。
门禁判定：虽然综合分超过 90，但因多 AI 验收记录和真实 Issue Ledger 运行记录未完成，不能给出 `可正式推广` 结论。
## 三、KB 层面优秀实践
1. 三层架构已经落地到入口规则和项目导航。根 `AGENTS.md` 与项目导航都把 `KB_兆华 > KB_SC > KB_SA` 作为冲突裁决顺序，项目事实、标准步骤、产品功能边界各有归属。
2. 项目 KB 目录形态合理。`KB_兆华/` 已覆盖项目概况、真实值、蓝图决策、四类操作特例、集成约定、上线问题、未决清单、验收题库和 Issue Ledger。
3. 来源锚点比上一版明显增强。蓝图、集成、上线问题等文件普遍使用 `DOC-xxx` 归档编号，项目导航维护了归档文件索引。
4. 公有云边界意识明确。项目概况写明 SAP S/4HANA Cloud Public Edition，运行规约要求标准步骤查 `KB_SC`/官方来源，客户 KB 只覆盖项目特例和真实值。
5. 售后 Agent 必备治理对象已建立。`Issue_Ledger/README.md` 定义一个问题一个文件、状态流转、append-only 日志、顾问确认后关闭；`TEMPLATE.md` 提供诊断日志、顾问确认、关闭记录字段。
6. 验收题库已从无到有。28 题覆盖真实值、蓝图、操作特例、Base 路由、运行规约和边界判断，题目结构适合后续多 AI 一致性测试。
## 四、Agent 层面差距逐项分析
### 4.1 缺口总览
| 等级 | 缺口 | 当前证据 | 影响 |
| --- | --- | --- | --- |
| P2 | 多 AI 验收尚未实际执行 | `验收题库.md` 的实际答案、一致性、验收记录为空；`scoring_matrix.csv` 全空 | 不能证明 KB 回答稳定性，正式推广门禁未过 |
| P2 | Issue Ledger 尚未承载真实问题 | `Issue_Ledger/` 只有 `README.md` 与 `TEMPLATE.md`，无 `ISSUE-*.md` | 四步诊断和关闭治理仍停留在结构层，无法验证 session→ledger 闭环 |
| P2 | 真实值和问题状态仍有待补充 | 项目干系人、核心客户/物料、上线问题发生时间、操作特例参数仍出现 `待补充/待确认` | Agent 在生产操作、故障诊断和客户答复时仍需频繁停下确认 |
| P3 | 项目导航索引未同步新增对象 | 项目导航文件索引仍列 11 个项目 KB 文件，未列 `验收题库.md` 和 `Issue_Ledger/` | 入口路由完整性略降，后续维护者可能漏加载治理对象 |
| P3 | 历史审计报告与最新报告共存 | 快照根目录和 `KB_兆华/审计报告.md` 存在历史审计报告 | 易造成版本误读，建议加 commit/日期说明或移入审计归档 |
### 4.2 refagent 对齐地图
| refagent 通用规则 | 当前项目缺口 | 要求的 AGENTS/System Prompt 变化 |
| --- | --- | --- |
| 根入口轻量化，只做调度、加载顺序和强制门禁 | 当前根入口已覆盖关键规则，但项目导航没有列入新增治理文件 | 在项目导航索引中补入 `验收题库.md`、`Issue_Ledger/`，并把它们放入故障诊断/验收路由 |
| 三层路由：项目 KB → KB_SC → KB_SA | 已实现，且冲突裁决明确 | 保持现状；只需同步 SC 文件数与项目 KB 文件数，避免旧数字误导 |
| 来源优先，区分已验证事实与推断 | 已实现来源输出规则，但原始二进制归档未在本次快照核验 | 对需要引用 DOC 原文的回答，要求写明 `归档编号 + 已抽取事实`，不要暗示已直接读取原始附件 |
| 客户/顾问双输出 | 已实现 C/D/E 双输出 | 保持现状；建议在验收题 Q22 中实际跑一次客户/顾问双输出 |
| 四步诊断和 Issue Ledger 闭环 | 结构已实现，运行记录缺失 | 明确 D 类集成故障也进入同一诊断链；把当前上线问题和未决问题迁移为独立 issue 文件 |
| 生产写入强确认和占位值纪律 | 已实现 | 保持现状；验收题 Q24/Q28 需要实测 |
| 禁止能力限制式话术 | 已实现禁用表述和替代表达 | 保持现状；建议在验收题库加入反向陷阱题，检查 Agent 是否暴露“不能访问系统”等表述 |
### 4.3 逐项说明
Issue 闭环是本次复审最大的剩余差距。当前 `Issue_Ledger/README.md` 和 `TEMPLATE.md` 已满足结构要求，但 `未决问题清单.md` 中的 10 个未决问题尚未迁移为独立 `ISSUE-*.md`。根据本审计仓库规则，独立 Issue Ledger 是结构性强制项，不能用未决问题清单替代；本项目已经建了 ledger 目录，因此不是 P1 缺失，但仍是 P2 运行缺口。
验收题库已经具备题目和预期答案，但尚未形成验收结果。`验收题库.md` 第 70-80 行有验收记录和通过标准，实际记录为空；静态扫描因此高估了“验收结果存在”。正式推广必须把多 AI 实测结果填入题库或独立结果文件。
生产安全规则已经满足 v4.0 运行要求。根 `AGENTS.md` 对 D/T/P 环境、生产创建/修改/删除/批量/资金动作的确认文本有明确要求，并且禁止将占位值提交为真实单据。剩余风险来自真实值缺口，而不是规则缺口。
## 五、修改建议
本节按“可直接派工整改”的粒度写出修改意见。每条建议包含：现状证据、具体改法、建议文本/结构、验收标准。建议先做 P2，再做 P3；P2 未完成前不要把项目状态写为“正式推广通过”。
### P0 / P1
本次复审未发现 P0 或 P1 级阻断项。项目已具备三层路由、Agent 关键铁律、独立 Issue Ledger 目录和验收题库，已脱离“不可用”状态。
### P2
#### P2-01 执行多 AI 验收并回填结果
| 项目 | 修改意见 |
| --- | --- |
| 现状证据 | `KB_兆华/验收题库.md` 已有 28 道题和通过标准，但 `实际答案`、`一致性`、`验收记录` 为空；`scoring_matrix.csv` 中 AI1/AI2/Consistent/Finding 也为空 |
| 修改位置 | 优先修改 `KB_兆华/验收题库.md`；如不想污染题库，可新增 `KB_兆华/验收结果_20260707.md` 并从题库链接过去 |
| 具体改法 | 至少使用两个不同 Agent/模型独立回答 28 题；逐题记录 AI-1、AI-2、最终判定、差异原因、是否需要改 KB；不得只填“通过” |
| 建议规则 | 25/28 以上一致才可写“验收通过”；任何涉及生产写入、客户真实值、Issue 闭环的题目如果失败，即使总分达标也不能正式推广 |
| 验收标准 | 28 题均有实测答案；每个不一致题有差异分析和修复动作；验收记录表有日期、验收人、模型、得分、差异题号 |
建议把题库表头从当前 5 列扩展为以下结构：
```markdown
| 题号 | 问题 | 预期答案 | AI-1 实际答案 | AI-2 实际答案 | 一致性 | 差异原因 | 处理动作 |
|------|------|---------|--------------|--------------|--------|----------|----------|
```
建议在文件末尾增加差异处理记录：
```markdown
## 差异处理记录
| 题号 | 差异类型 | 根因 | 修改文件 | 修改摘要 | 复测结果 |
|------|----------|------|----------|----------|----------|
| Qxx | 来源缺失/路由错误/口径不一致 | ... | `KB_兆华/...` | ... | 通过/待复测 |
```
#### P2-02 将真实问题迁移到 Issue Ledger
| 项目 | 修改意见 |
| --- | --- |
| 现状证据 | `KB_兆华/Issue_Ledger/` 当前只有 `README.md` 和 `TEMPLATE.md`；`未决问题清单.md` 有 10 个未决问题；`上线问题记录.md` 有 8 个上线问题但未形成独立 issue 文件 |
| 修改位置 | `KB_兆华/Issue_Ledger/ISSUE-001-*.md` 至 `ISSUE-018-*.md`；同步修改 `未决问题清单.md` 和 `上线问题记录.md` 加入 issue 链接 |
| 具体改法 | 先迁移 10 个未决问题，再迁移 8 个上线问题；一个问题一个文件；未决清单只保留看板作用，关闭和诊断日志必须写入 Issue Ledger |
| 命名建议 | `ISSUE-001-组织结构真实值待确认.md`、`ISSUE-002-主数据编号规则待确认.md`、`ISSUE-011-CRM客户主数据同步失败.md` |
| 验收标准 | `Issue_Ledger/` 下除 README/TEMPLATE 外至少有 18 个 issue 文件；每个 issue 有状态、owner、来源、影响范围、诊断日志、下一步或关闭记录；未决清单和上线问题记录能反向链接到 issue |
建议每个 issue 文件至少补齐以下字段：
```markdown
# ISSUE-001-组织结构真实值待确认
## 基本信息
| 字段 | 值 |
|------|-----|
| 状态 | Open |
| 严重级别 | P2 |
| 负责人 | 杨娟 |
| 来源 | `KB_兆华/未决问题清单.md` 编号 001 |
| 创建时间 | 2026-07-07 HH:MM |
| 目标解决日期 | 2026-07-14 |
| 影响范围 | ALL，影响所有生产操作真实值替换 |
## 问题描述
当前项目仍存在组织结构真实值待确认项，生产操作前不能直接使用相关占位值。
## 诊断日志
### 2026-07-07 HH:MM — 审计复核
- **排查步骤**：检查 `00_项目概况.md`、`组织与主数据_真实值.md`、操作特例文件。
- **发现**：部分组织/主数据已补齐，但仍存在待补充字段。
- **证据**：`未决问题清单.md` 编号 001；相关待补充字段清单。
## 下一步
| 动作 | Owner | 截止日期 |
|------|-------|----------|
| 从配置清单提取并核验组织结构真实值 | 杨娟 | 2026-07-14 |
## 顾问确认
| 字段 | 值 |
|------|-----|
| 确认人 | 待补充 |
| 确认时间 | 待补充 |
| 确认结论 | 待确认，不允许关闭 |
```
同步把 `未决问题清单.md` 的行改成带链接的看板形式：
```markdown
| 001 | 组织结构真实值待确认 | ALL | Open | 杨娟 | 2026-07-14 | `Issue_Ledger/ISSUE-001-组织结构真实值待确认.md` |
```
#### P2-03 清理所有裸 `待补充/待确认`
| 项目 | 修改意见 |
| --- | --- |
| 现状证据 | `rg` 检出 `00_项目概况.md` 关键干系人待补充，`组织与主数据_真实值.md` 核心客户/核心物料待补充，四类 `操作特例_*.md` 多个业务参数待确认，`上线问题记录.md` 发生时间和状态待确认 |
| 修改位置 | `KB_兆华/00_项目概况.md`、`组织与主数据_真实值.md`、`操作特例_SD_销售.md`、`操作特例_MM_采购仓储.md`、`操作特例_PP_QM_生产质量.md`、`操作特例_FI_CO_财务.md`、`上线问题记录.md` |
| 具体改法 | 不允许保留裸 `待确认`；无法立刻补值时，必须写成“待确认项 + owner + 截止日期 + 临时口径 + 生产限制” |
| 验收标准 | `rg -n "待补充|待确认" KB_兆华` 不再出现无 owner/日期/限制说明的裸占位；生产操作相关值要么是真实值，要么明确禁止用于 P 系统 |
建议新增一个集中清账表，可放在 `未决问题清单.md` 或新增 `KB_兆华/待确认项清账表.md`：
```markdown
| ID | 文件 | 字段 | 当前值 | Owner | 截止日期 | 临时回答口径 | 生产限制 | 关联 Issue |
|----|------|------|--------|-------|----------|--------------|----------|------------|
| TBD-001 | `00_项目概况.md` | 项目经理 | 待补充 | 杨娟 | 2026-07-14 | 对外不披露姓名，仅称“客户项目经理” | 不影响系统操作 | `Issue_Ledger/ISSUE-xxx-项目干系人待补充.md` |
```
对生产操作参数，建议使用更严格写法：
```markdown
| 订单类型 | 待确认 | Owner：杨娟；截止：2026-07-21；未确认前不得用于 P 系统创建真实订单 |
```
#### P2-04 补齐上线问题记录的运行闭环
| 项目 | 修改意见 |
| --- | --- |
| 现状证据 | `上线问题记录.md` 中 CRM-001、CRM-002、MES-001、MES-002、SD-001、MM-001、FI-001、FI-002 的发生时间均为 `待补充`，问题状态均为 `待确认` |
| 修改位置 | `KB_兆华/上线问题记录.md`；对应 `Issue_Ledger/ISSUE-011-*` 至 `ISSUE-018-*` |
| 具体改法 | 每个上线问题增加 `Issue ID`、发生时间、发现人/来源、当前状态、处理 owner、是否复发、关闭条件；状态必须与 Issue Ledger 一致 |
| 验收标准 | 每个上线问题都能追到独立 issue；没有孤立的 `待确认` 状态；已关闭问题有顾问确认和关闭记录，未关闭问题有下一步和 owner |
建议把每个问题条目改成以下结构：
```markdown
### CRM-001：客户主数据同步失败
| 字段 | 值 |
|------|-----|
| Issue ID | `Issue_Ledger/ISSUE-011-CRM客户主数据同步失败.md` |
| 发生时间 | YYYY-MM-DD HH:MM |
| 涉及模块 | SD/FI |
| 当前状态 | Open / In Progress / Pending Confirmation / Closed |
| 处理 Owner | 待补充 |
| 是否复发 | 是/否/待确认 |
| 事实来源 | 归档文件 `DOC-002` |
```
#### P2-05 明确 D 类集成故障进入诊断链
| 项目 | 修改意见 |
| --- | --- |
| 现状证据 | 根 `AGENTS.md` 第 1 节将 D 类定义为集成/RICEFW/边界，且要求双输出；第 3 节标题写 `C/E 类四步诊断流程`，正文写“故障诊断/售后问题”，D 类集成故障是否强制进入诊断链存在口径空隙 |
| 修改位置 | 根 `AGENTS.md` 第 3 节 |
| 具体改法 | 将标题和触发条件改成覆盖 C/D/E 中的故障、集成异常和方案口径问题；明确 D 类集成异常也要查上线问题、未决清单、Issue Ledger、集成约定 |
| 验收标准 | D 类集成异常不会只输出接口说明，而会先查问题记录和 ledger；验收题库新增或调整一题验证此行为 |
建议文本：
```markdown
## 3. C/D/E 类诊断与闭环流程
触发条件：
- C 类故障诊断/售后问题；
- D 类集成、RICEFW、边界问题中涉及异常、失败、延迟、数据不一致；
- E 类管理决策中涉及已有问题关闭、方案变更或客户口径。
必须按以下顺序执行：
Step 1: 查 `KB_兆华/上线问题记录.md`
Step 2: 查 `KB_兆华/未决问题清单.md`
Step 3: 查 `KB_兆华/Issue_Ledger/`
Step 4: 查模块操作特例/`KB_兆华/集成约定.md`，判断是否升级
未经顾问确认，不得写“已关闭”或“问题已解决”。
```
### P3
#### P3-01 同步项目导航索引
| 项目 | 修改意见 |
| --- | --- |
| 现状证据 | `KB_00_兆华_Navigation_Map.md` 文件索引列到 `未决问题清单.md`，未列 `验收题库.md` 和 `Issue_Ledger/`；三层架构说明仍写项目 KB 为 11 文件 |
| 修改位置 | `KB_兆华/KB_00_兆华_Navigation_Map.md` |
| 具体改法 | 在文件索引表中增加验收题库和 Issue Ledger；在问题路由规则中增加“验收/复测”和“问题关闭/复盘”路由；更新项目 KB 文件数 |
| 验收标准 | 新增治理对象能从导航直接定位；所有新增文件都有“何时加载”说明 |
建议新增两行：
```markdown
| `验收题库.md` | 多 AI 一致性验收、回归测试题库、运行规约验证 | 每次重大更新后验收时加载 |
| `Issue_Ledger/` | 独立问题台账，一个问题一个文件，记录诊断、确认、关闭 | 故障诊断、问题关闭、复盘时加载 |
```
#### P3-02 建立独立来源索引
| 项目 | 修改意见 |
| --- | --- |
| 现状证据 | 多个文件有 DOC 索引，但来源分散；静态工具未识别统一 source index |
| 修改位置 | 新增 `KB_兆华/KB_99_来源索引.md`，并在导航中加入 |
| 具体改法 | 集中维护 DOC 编号、文件名、类型、权威边界、已抽取到哪些 KB 文件、最后核验人、核验日期 |
| 验收标准 | 任一 KB 事实都能从“事实所在文件”追到 `KB_99_来源索引.md`，再追到 DOC 编号 |
建议结构：
```markdown
# KB_99_来源索引 — 兆华项目
| DOC编号 | 原始文件 | 类型 | 权威内容边界 | 已抽取到的KB文件 | 最后核验人 | 核验日期 |
|---------|----------|------|--------------|------------------|------------|----------|
| DOC-001 | 兆华电子_PPT_SAP项目蓝图总结.pptx | 蓝图 | 业务场景、产品模式、管控点 | `00_项目概况.md`、`蓝图决策记录.md` | 待补充 | 2026-07-07 |
```
#### P3-03 补项目干系人或说明脱敏策略
| 项目 | 修改意见 |
| --- | --- |
| 现状证据 | `00_项目概况.md` 中项目经理、顾问负责人、客户 IT 负责人为 `待补充` |
| 修改位置 | `KB_兆华/00_项目概况.md` |
| 具体改法 | 如可公开，填写真实姓名；如不应公开，填写角色代号并注明脱敏原因、联系路径和 owner |
| 验收标准 | 不再出现无解释的 `待补充`；Agent 能知道问题应升级给哪个角色 |
建议写法：
```markdown
| 项目经理 | <客户项目经理-脱敏> | 项目整体管理；真实姓名由项目经理维护，不在KB公开 |
| 顾问负责人 | <顾问负责人-脱敏> | 实施顾问团队管理；升级路径：先联系项目经理 |
| 客户IT负责人 | <客户IT负责人-脱敏> | 客户IT协调；涉及账号/接口/权限问题时升级 |
```
#### P3-04 标注历史审计报告状态
| 项目 | 修改意见 |
| --- | --- |
| 现状证据 | 快照根目录和 `KB_兆华/审计报告.md` 存在历史审计报告，容易与本次 `9f9af550` 复审结论混淆 |
| 修改位置 | 根目录历史报告、`KB_兆华/审计报告.md` |
| 具体改法 | 在历史报告头部增加“历史版本，仅供追溯；已被某日期/commit 的复审报告替代”；或统一移入 `audit_archive/` |
| 验收标准 | 读者能一眼区分历史审计结论和最新复审结论 |
建议头部标注：
```markdown
> 状态：历史审计报告，仅供追溯。最新复审请以 `兆华_KB_Agent_复审报告_v4.0_9f9af550_20260707.md` 为准。
> 对应 commit：<旧 commit>
> 已替代日期：2026-07-07
```
#### P3-05 解释 `KB方法论` 目录命名
| 项目 | 修改意见 |
| --- | --- |
| 现状证据 | 快照中存在 `KB方法论/`，但静态工具默认查 `KB构建方法论/`，导致 `methodologyExists=false` |
| 修改位置 | 根 `README.md` 或新增轻量说明文件；也可增加兼容目录/链接 |
| 具体改法 | 在 README 中说明 `KB方法论/` 是方法论目录；如仓库允许，新增 `KB构建方法论/README.md` 指向 `KB方法论/` |
| 验收标准 | 静态扫描或人工阅读不会误判方法论缺失 |
建议说明：
```markdown
## 方法论目录说明
本仓库方法论文档位于 `KB方法论/`。该目录等同于审计工具默认口径中的 `KB构建方法论/`，包含客户项目 KB 建设指引、KB 建设方法论和最佳实践。
```
### 建议整改顺序
| 顺序 | 动作 | 目的 |
| ---: | --- | --- |
| 1 | 新建并迁移 `Issue_Ledger/ISSUE-*.md` | 先把问题治理从“结构存在”变成“可运行” |
| 2 | 清理 `待补充/待确认` 并补 owner/日期/限制 | 降低生产操作和客户答复风险 |
| 3 | 执行多 AI 验收并回填题库 | 证明 KB 和 Agent 输出稳定 |
| 4 | 同步导航、来源索引、历史报告状态 | 降低维护和审计误读 |
| 5 | 对 D 类集成故障补诊断链口径并复测 | 关闭 Agent 规则边缘场景 |
## 六、建议的新 AGENTS.md 结构
当前 `AGENTS.md` 不需要整体重写，建议做增量结构化，保持现有内容并按以下顺序整理。该结构使用通用占位符，避免复用其他项目私有事实。
```markdown
# AGENTS.md — <客户名>项目 Agent 入口
0. 强制加载顺序
- 必读：`<项目KB目录>/KB_00_<客户名>_Navigation_Map.md`
- 三层顺序：`<项目KB目录>` > `KB_SC` > `KB_SA`
- 每次对话确认：已加载导航 / 请求类型 / 受众 / 环境 / 是否生产写入
1. 请求分类与场景确认
- A 配置/操作
- B 查询/凭证/报表
- C 故障诊断/售后问题
- D 集成/RICEFW/边界
- E 管理决策/方案口径
2. 输出模式
- A/B：单输出 + 来源
- C/D/E：客户可见输出 + 顾问内部分析
3. 诊断与 Issue Ledger 闭环
- Step 1：查上线问题
- Step 2：查未决清单
- Step 3：查 `<Issue Ledger路径>`
- Step 4：查操作特例/集成约定并判断升级
- 诊断结论经顾问确认后追加 ledger，不自动关闭
4. 生产写入确认
- D/T/P 环境识别
- P 系统创建/修改/删除/批量/资金动作确认文本
- 禁止占位值进入真实单据
5. 来源、边界与冲突处理
- 回答前输出来源
- 项目事实 / 标准步骤 / 产品功能分层处理
- 冲突时停下，不用训练记忆覆盖 KB
6. 集成与外部系统边界
- 只答 SAP 触点、触发条件、替代步骤、异常处理
- 不推断外部系统内部实现
7. 禁止表述与替代表达
- 禁止暴露能力限制式话术
- 给出可执行的查证、升级或确认动作
8. 自查规则
- 仅对照 `<项目KB目录>`、`KB_SC`、`KB_SA`、官方来源、本次系统证据
```
## 七、核心建议
1. 把“整改完成”从结构完成推进到运行完成：优先跑验收题库和迁移 Issue Ledger，形成可查的执行证据。
2. 用 `Issue_Ledger/` 取代“未决清单即问题治理”的做法：未决清单可以保留为看板，但关闭、回写、复盘必须落到独立 issue 文件。
3. 对所有 `待补充/待确认` 做一次集中清账：能补真实值就补，不能补则写明 owner、目标日期、影响范围和临时回答口径。
4. 同步导航和索引：新增文件必须进入项目导航，否则 Agent 和维护者都可能漏读。
5. 报告结论建议写成“受控试运行通过，正式推广待验收记录和 issue 运行证据补齐”，不要写成“P1-P3 全部完成后可直接正式推广”。
## 八、已验证事实
| 类别 | 已验证事实 |
| --- | --- |
| 远端版本 | 2026-07-07 复核 `master` 指向 `9f9af550e26f71e5f10593cfcf36bc0c8c5b72d2` |
| 快照方式 | Git pack/archive 多次下载失败后，使用 GitLab API blob 生成 Markdown 快照；`.snapshot-meta.json` 记录总 tree items 1354、Markdown 文件 157 |
| 静态扫描 | 已重新运行 `tools/kb-audit.ps1`；输出 `static_findings.json`、`static_audit_report.md`、`manual_review_checklist.md`、`acceptance_tests.md`、`ai_answer_sheet.md`、`scoring_matrix.csv` |
| 基准读取 | 已尝试读取并确认存在：`C:\Users\zx447\Desktop\Majesty_KB_Audit_v4.0.md`、`C:\Users\zx447\Desktop\ref agent\refagent`、`C:\Users\zx447\Desktop\Majesty-master-mineru-md\Majesty-master\KB构建方法论`、本仓库 `KB构建方法论/`、`prompts/`、`tools/`、根 `AGENTS.md` |
| 被审项目入口 | 根 `AGENTS.md` 存在并包含三层路由、请求分类、双输出、诊断链、生产确认、禁用表述、自查规则 |
| 项目 KB | `KB_兆华/` 存在 15 个 Markdown 文件，包括 `验收题库.md` 和 `Issue_Ledger/README.md`、`Issue_Ledger/TEMPLATE.md` |
| 项目范围 | `00_项目概况.md` 写明系统版本为 SAP S/4HANA Cloud Public Edition，列出 SD/MM/PP/QM/FI/CO、CRM/MES/OA/每刻集成，并声明 EWM、SuccessFactors、Ariba、IBP、Concur 不在范围 |
| 验收题库 | `验收题库.md` 有 28 道题和通过标准，但实际答案、一致性和验收记录为空 |
| Issue Ledger | `Issue_Ledger/` 只有 `README.md` 和 `TEMPLATE.md`，未发现真实 `ISSUE-*.md` 文件 |
| 剩余待确认项 | `rg` 检出项目干系人、核心客户/物料、上线问题发生时间、多个操作特例参数仍含 `待补充/待确认` |
## 九、基于上下文的推断
1. 根 `AGENTS.md` 的运行规约已经足以支撑一个受控售后 Agent 试运行；该判断基于静态规则完备度和 refagent 通用规则对齐情况，尚未经过真实对话回放验证。
2. `DOC-xxx` 归档索引能够提供来源锚点，但本次没有校验原始 Word/PDF/Excel/PPTX 附件，因此只能推断“KB 抽取文本声称来自这些归档文件”，不能断言原文完全一致。
3. `KB方法论/` 目录包含项目 KB 建设指引和 14 项 Agent 质量框架；静态工具显示 `methodologyExists=false` 主要是目录名与工具预期的 `KB构建方法论` 不一致，而不是没有方法论文档。
4. 因 `Issue_Ledger/` 目录已存在且规则清楚，本项目不是 Issue Ledger 结构缺失；真正缺口是问题迁移和运行闭环证据不足。
5. 若补齐验收结果、真实 issue 条目和剩余真实值，本项目有较高概率达到正式推广门槛。
## 十、未审事项
1. 我不确定原始二进制归档文件是否与 KB 中的 `DOC-xxx` 摘要完全一致；原因是 Git pack/archive 下载失败，本次只审计 GitLab API 取得的 Markdown 快照。
2. 未执行真实 SAP 系统操作、UI 验证、接口联调或生产写入测试。
3. 未执行多 AI 独立验收，只审计了题库结构和空白结果表。
4. 未验证历史审计报告与本次复审报告之间的全部差异，只确认远端 HEAD 和本次快照内容。
5. 未对 `KB_SC/` 和 `KB_SA/` 的全部 135 个 Base KB 文件做逐文件内容审计，仅验证其存在、导航和与项目 KB 的路由关系。
兆华_KB_Agent_审计报告_v4.0_20260707.md
View file @ 7725587a
# 兆华项目 KB + Agent 运行规约审计报告 v4.0
> **状态：历史审计报告，仅供追溯。最新复审请以 `兆华_KB_Agent_复审报告_v4.0_9f9af550_20260707.md` 为准。**
> 对应 commit：22d7763（v4.0审计整改前）
> 已替代日期：2026-07-07
| 项目 | 内容 |
| --- | --- |
| 被审计仓库 | `git@118.31.18.126:bos-project-kb/zhaohua.git` |
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment