长机科技客户项目KB Release v1.2.1

AGENTS.md

+# 长机科技 SAP S/4HANA Cloud 项目 — Agent Guide
+
+## 项目本质
+
+宜昌长机科技 SAP S/4HANA Cloud Public Edition 2602 实施项目（2023.08–2024.01）。乙方：帛丝云商（BOS Cloud）。纯文档仓库，无可执行代码。
+
+## 目录结构
+
+```
+客户项目KB_长机科技/  — 客户项目 KB（14个文件：决策、真实值、操作特例、集成、问题）
+KB_SA/                 — SA KB（Presales Agent，28文件）
+KB_SC/                 — SC KB（Solution Consultant，107文件）
+```
+
+> **精简部署说明**：本包仅含 KB 运行时必需文件。原始项目档案（蓝图签字版、问题清单、配置文档、测试记录等）不包含在内，需时可联系 KB Owner 索取。所有决策、真实值、操作差异已提取至 `客户项目KB_长机科技/`，KB 可独立运行。
+
+## Agent 运行模式
+
+### SA Agent（KB_SA/）
+- **Mode 0**：查客户项目 KB（`客户项目KB_长机科技/`）
+- **Mode 1A–1E**：查标准 KB 事实
+- **Mode 2**：分析/判断
+- **Mode 3**：其他
+- 系统提示词：`KB_SA/SYSTEM_PROMPT_Agent1_v1.67.md`
+- 导航图：`KB_SA/KB_00_Navigation_Map.md`
+
+### SC Agent（KB_SC/）
+- **Mode B**：仅 Base KB
+- **Mode B+蓝图**：Base + 蓝图文档
+- **Mode B+CustomerKB**：Base + 客户项目 KB
+- **Mode Full**：三层全开
+- 运行时提示词：`KB_SC/PROMPT_SC_Agent_Runtime_v2.1.md`
+- 导航图：`KB_SC/KB_00_SC_Navigation_Map.md`
+
+## 关键约束
+
+- **SAP Cloud only**：禁止 OP 事务码（SE16N/SPRO/SM30 等），必须映射到 Fiori App 或 SSCUI
+    - 映射表：`KB_SC/KB_REFERENCE_OPOnly_Tools.md`（60 个映射）
+- **KB 样本数据**：组织 1310、客户 13100003、物料 TG11 等均为占位值，需确认
+- **文件来源**：所有 `.md` 文件由 Office 文档转换而来，头部标注源文件路径
+
+## 核心速查
+
+| 文件 | 路径 | 用途 |
+|------|------|------|
+| 项目概况 | `客户项目KB_长机科技/00_项目概况.md` | 客户信息、实施范围、关键干系人、KB生命周期 |
+| 蓝图决策 | `客户项目KB_长机科技/蓝图决策记录.md` | 40条模块配置决策（含日期/负责人/依据） |
+| 真实值 | `客户项目KB_长机科技/组织与主数据_真实值.md` | 组织编码、物料/客户/供应商编码规则 |
+| 操作特例 | `客户项目KB_长机科技/操作特例_[模块].md` | 各模块与标准SAP的差异操作 |
+| 未决问题 | `客户项目KB_长机科技/未决问题清单.md` | 16条未决/进行中事项及Release影响 |
+| 上线问题 | `客户项目KB_长机科技/上线问题记录.md` | Hypercare报错与解法 |
+| 集成约定 | `客户项目KB_长机科技/集成约定.md` | SRM/宜搭/PDM接口约定 |
+| 证据索引 | `客户项目KB_长机科技/KB_EVIDENCE_INDEX.md` | 源文档追溯映射（源材料需另索取） |
+| 导航路由 | `客户项目KB_长机科技/KB_00_项目导航与路由.md` | 问题类型→文件路由表
+
+## 已知约定
+
+- 客户在文档中代号"丰隆"
+- KB_SC 文件脚注含版本号（如 `v4.2 | 2026-06-26`）
+- 附录文件命名带 `_附录.md` 后缀
+
+<!-- BOS-KB-START -->
+
+## BOS SAP Cloud ERP Knowledge Base
+
+> 本专区由 bos-env-config skill 自动生成。KB 文件已部署到项目本地目录。
+
+### SA KB（Presales Agent）
+
+**KB 文件目录**：`KB_SA/`（28 个文件）
+
+#### SA KB 导航图
+
+`KB_SA/KB_00_Navigation_Map.md` — 5 层架构：E2E 流程 → 产品概览 → 业务流程 → Scope Item 选型 → FSD 功能描述
+
+关键文件入口：
+- 流程架构：`KB_SA/L2C_08_Process_Architecture.md` / `KB_SA/S2P_09_Process_Architecture.md` / `KB_SA/I2M_10_Process_Architecture.md`
+- Scope Item 目录：`KB_SA/SAP_Scope_Item_Catalog_RAG.md`（672 项，含 RAG 标识）
+- Scope 选型指南：`KB_SA/Scope_Selection_Guide.md`
+- 产品概览：`KB_SA/SAP_Product_Overview.md`
+- 领域映射：`KB_SA/SAP_Domain_Mapping.md`
+
+#### SA Agent System Prompt
+
+`KB_SA/SYSTEM_PROMPT_Agent1_v1.67.md` — 定义 Mode 0–3 工作模式、KB 两层查找法（先导航图定位→再读具体文件）、客户项目文档引用规则
+
+### SC KB（Solution Consultant Agent）
+
+**KB 文件目录**：`KB_SC/`（107 个文件）
+
+#### SC KB 导航图
+
+`KB_SC/KB_00_SC_Navigation_Map.md` — 按模块（SD/MM/FI-CO/PP/QM/WM/PS/PM）组织的操作文件索引
+
+模块 KB 文件覆盖：
+
+| 模块 | 文件数 | 入口索引 |
+|------|--------|----------|
+| SD | 22 | `KB_SC/KB_SD_INDEX.md` |
+| MM | 10 | `KB_SC/KB_MM_INDEX.md` |
+| FI/CO | 8 | `KB_SC/KB_FI_CO_INDEX.md` |
+| PP | 7 | `KB_SC/KB_PP_INDEX.md` |
+| PS | 7 | `KB_SC/KB_PS_INDEX.md` |
+| PM | 6 | `KB_SC/KB_PM_INDEX.md` |
+| WM | 5 | `KB_SC/KB_WM_INDEX.md` |
+| QM | 4 | `KB_SC/KB_QM_INDEX.md` |
+
+配置参考：`KB_SC/KB_CONFIG_SD.md` / `KB_SC/KB_CONFIG_MM.md` / `KB_SC/KB_CONFIG_PP.md` / `KB_SC/KB_CONFIG_FI.md` / `KB_SC/KB_CONFIG_QM.md` / `KB_SC/KB_CONFIG_WM.md` / `KB_SC/KB_CONFIG_PS.md` / `KB_SC/KB_CONFIG_PM.md`
+
+主数据参考：`KB_SC/KB_MASTERDATA_Material.md` / `KB_SC/KB_MASTERDATA_Customer.md` / `KB_SC/KB_MASTERDATA_Supplier.md` / `KB_SC/KB_MASTERDATA_Equipment.md` / `KB_SC/KB_MASTERDATA_WorkCenter.md`
+
+#### SC KB OP-Only 工具映射表
+
+`KB_SC/KB_REFERENCE_OPOnly_Tools.md` — 60 个 OP 事务码 → SAP Cloud Fiori App / SSCUI 映射，运行时拦截 OP-only 请求时查此表
+
+#### SC Agent System Prompt
+
+`KB_SC/PROMPT_SC_Agent_Runtime_v2.1.md` — 定义 Mode B/B+蓝图/B+CustomerKB/Full 四层模式、§1.4 OP 拦截规则、占位值标注要求、弹窗处理流程
+
+<!-- BOS-KB-END -->