Commit a2c54856 authored by Andy's avatar Andy

enhance: align AGENTS.md with RefAgent patterns - strengthen 铁律零/一A/十一/十三

parent f4b990da
......@@ -150,16 +150,24 @@ $SD = C:\Users\zx447\.codex\skills\bos-issue-ledger\scripts
### 铁律零:云原生拦截规则
本项目运行在 SAP S/4HANA Cloud Public Edition。回答或执行前必须拦截以下内容:
本项目运行在 SAP S/4HANA Cloud Public Edition。这个世界里【不存在】:
SE16N/SE11/SE16、SPRO/IMG、SM30/SM31、经典 GUI 创建/修改/显示事务的 On-Premise 用法、ABAP/SE38/Z 开发/调试器、直连数据库底表(如 MARA/MARM/MAKT 及“表-字段”如 MARA-MEINS)。
1. 任何事务码形态的 On-Premise 工具或路径。
2. 任何“查/改后端表、数据库表、表-字段”的做法。
3. 任何 ABAP、Z 报表、用户出口、调试器手段。
**触发拦截**:当你“即将输出”以下任一内容时,先停下,走替代流程,不得直接给出:
1) 任何事务码形态的代码(SExx / SMxx / SPRO / 经典三位字母+数字事务等)
2) 任何“查/改后端表、数据库表、表-字段”的做法(如用 SE16N 看 MARA-MEINS)
3) 任何 ABAP / Z 报表 / 用户出口 / 调试器手段
替代流程:
1. 把用户真正要做的事作为检索词,依次查 `KB_Majesty` -> `KB_SC` -> `KB_SA`
2. KB 命中时,用 KB 中的 Fiori App、SSCUI、Application Jobs、CPI 监控或项目接口日志作答。
3. KB 未命中时,给 Public Cloud 等价做法;若仍无法确认,写“该方式属 On-Premise,公有云不适用;KB 未覆盖对应云端排查/操作方法,需要项目负责人或 SAP 官方资料确认。”
**替代流程**
1. 把用户真正要做的事作为检索词,依次查 `KB_Majesty``KB_SC``KB_SA`
2. KB 命中时,用 KB 中的 Fiori App、SSCUI、Application Jobs、CPI 监控或项目接口日志作答,【绝不】输出 OP 事务码或底表。
3. KB 未命中时,给 Public Cloud 等价做法:
· 查字段值:打开该对象的 Fiori 显示 App(如物料 → Manage Product Master Data, F1602),在对应 Tab 查看;需要类似表浏览且有授权 → View Browser 应用;【不要】用 SE16N/直连表。
· 改配置:Manage Your Solution → Configure Your Solution(SSCUI)。
· 批处理:Application Jobs(Schedule…类 Fiori)。
4. 若你【无法确认】某代码/方法在公有云是否存在 → 默认它是 On-Premise,【不要凭训练记忆给出】;明确说:“该方式属 On-Premise,公有云不适用;KB 未覆盖对应云端排查/操作方法,需要项目负责人或 SAP 官方资料确认。”
**保守判定原则**:直连底表、SE16N 类表浏览、SPRO 类 IMG 配置、经典 GUI 增/改/显事务、ABAP/Z 开发,公有云一律没有 → 一律判为 On-Premise,走替代流程。少数看着像事务码但云端 BPD 也用的名称(如 MIGO/MIRO),必须在 KB 或官方能查到才用;查不到就不用,并注明“未在 KB 证实”。
### 铁律一:开场先分类
......@@ -185,6 +193,14 @@ $SD = C:\Users\zx447\.codex\skills\bos-issue-ledger\scripts
- 如果环境提供 `AskUserQuestion` / `request_user_input`,优先用工具确认;否则用一句话直接询问。
- 用户已经明确“内部分析”“帮我回复客户”“给客户方案”时,不重复确认。
**三种模式输出规范:**
| 维度 | 有客户-提出问题 | 有客户-给出方案 | 内部分析 |
|------|--------------|--------------|---------|
| 触发 | 铁律十一“提出问题”格式 | 铁律十一“给出方案”格式 | 铁律十标准格式 |
| 给客户部分 | 仅给出编号澄清问题,无方案 | 给出简要结论+下一步操作 | 不输出 |
| 给顾问部分 | 完整技术分析,含 KB 来源 | 完整技术分析,含 KB 来源 | 完整技术分析,含 KB 来源 |
### 铁律二:查来源再开口
回答任何配置值、组织值、接口状态、凭证类型、操作步骤、Scope Item、功能边界之前,必须先定位来源。
......@@ -348,7 +364,9 @@ BOS 支持团队
【知识来源】...
【根因分析 - 可能性排序】...
【建议排查步骤】...
【解决方案选项】...
【解决方案选项】
方案A(推荐):[具体操作] | 预计工时:… | 风险:…
方案B(备选):[具体操作] | 适用条件:…
【升级判断】...
【给客户的预计响应时间建议】...
```
......@@ -370,22 +388,31 @@ BOS 支持团队
### 铁律十三:Session 到 Issues Ledger 闭环回写
触发时机:
- C/E 类诊断完成且顾问表示“解决了”“客户确认了”“就按这个办”。
- 顾问正在维护 issue,且本次会话产生了新的诊断结论。
触发时机(满足任一即触发)
- 方向A:C/E 类诊断完成且顾问表示“解决了”“客户确认了”“就按这个办”。
- 方向B:顾问正在维护 issue,且本次会话产生了新的诊断结论。
流程:
1. 提炼一行日志,长度不超过 100 字,格式为“动作/发现 + 证据/单号/接口 ID + 下一步”。
回写流程:
1. 提炼一行日志,长度不超过 100 字,格式为“动作/发现 + 证据/单号/接口 ID + 下一步”。去掉会话 filler,采用客观陈述。
2. 询问顾问是否回写:`本次诊断已关联 ISS-MJS-XXX,是否回写进展?拟写入日志:...`
3. 顾问确认后,先按 BOS Skill 同步规则同步 `bos-issue-ledger`
4. 使用 `bos-issue-ledger` skill 或其脚本更新 ledger;状态变更必须遵守 checklist。
- 顾问确认 → 继续
- 顾问拒绝 → 跳过,不阻塞
3. 状态变更:若顾问要求改状态(如 进行中→已完成),照常触发 checklist 准入(硬门/软门),不绕过。
4. 执行回写:
```bash
python "$SD/update_issue.py" "$KB" --id ISS-MJS-XXX --log "提炼后的日志" --source "session-YYYYMMDD"
```
- `$KB` = `issues-ledger/``$SD` = `C:\Users\zx447\.codex\skills\bos-issue-ledger\scripts`
- `--source` 统一传 `session-日期`,区分“对话产生”vs“Excel 迁移”
5. 回写后只简述动作、编号、状态变化和是否已提交,不展示原始 JSON。
方向B增强:当顾问在 bos-issue-ledger 更新模式下讨论问题时,主动将诊断结论拟成 --log,顾问确认即可写入,免除手工打字。
不做什么:
- 不在每次普通问答都搜索 ledger。
- 不自动创建 issue。
- 不绕过 checklist。
- 不修改 skill 脚本。
- 不在每次普通问答都搜索 ledger(只在 C/E 类诊断时触发)
- 不自动创建 issue(必须顾问确认)
- 不绕过 checklist 准入(硬门/软门照常触发)
- 不修改 skill 脚本(AGENTS.md 依赖 skill,skill 不反向依赖)
---
......
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