sapbuddy-dsh 0.0.8 → 0.0.9

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm](https://img.shields.io/npm/v/sapbuddy-dsh)](https://www.npmjs.com/package/sapbuddy-dsh) [GitHub](https://github.com/gxx950224/sapbuddy-dsh)
 
-[SapBuddy](https://github.com/gxx950224/sapbuddy) 的 DeepSeek Harness 插件，提供 41 个 SAP ABAP 工具、8 个技能、SapBuddy agent preset 和 SAP 连接设置页。
+[SapBuddy](https://github.com/gxx950224/sapbuddy) 的 DeepSeek Harness 插件，提供 41 个 SAP ABAP 工具、10 个技能、SapBuddy agent preset 和 SAP 连接设置页。
 
 ## 安装
 
@@ -10,13 +10,13 @@
 在 DSH 的插件管理页添加：
 
 ```text
-sapbuddy-dsh@0.0.8
+sapbuddy-dsh@0.0.9
 ```
 
 也可以通过 DSH 命令行安装：
 
 ```bash
-dsh plugin --profile desktop add sapbuddy-dsh@0.0.8
+dsh plugin --profile desktop add sapbuddy-dsh@0.0.9
 ```
 
 更新已安装插件后，完整退出并重新启动 DSH，再新建会话选择 **SapBuddy**。
@@ -57,7 +57,7 @@ dsh plugin --profile desktop add sapbuddy-dsh@0.0.8
 
 工具涵盖对象搜索与读码、代码导航、语法诊断与激活、ATC 与单元测试、SQL 查询、DDIC、文本池、屏幕文本、消息类、函数模块接口和传输请求。
 
-技能包括 `abap-code-review`、`abap-explain`、`abap-templates`、`abap-wiki`、`clean-abap`、`dev-write`、`sap-abap-skills`、`translate-workflow`。
+技能包括 `abap-code-review`、`abap-explain`、`abap-templates`、`abap-wiki`、`clean-abap`、`dev-write`、`sap-abap-skills`、`translate-workflow`、`sap-fs`（四类 FS：MD + Claude 风 HTML）、`grilling`（经 sap-fs 加载的追问澄清）。
 
 ## 配置和写入保护
 
@@ -74,7 +74,7 @@ dsh plugin --profile desktop add sapbuddy-dsh@0.0.8
 从 GitHub 克隆仓库后，在 `packages/sapbuddy-dsh` 下运行激活回归测试（需要 Node.js 24+，无需连接 SAP）：
 
 ```bash
-npm test                      # = test:activation + test:session + test:store + test:probe + test:route + test:bundle
+npm test                      # = test:activation + test:session + test:store + test:probe + test:route + test:bundle + test:sap-fs
 npm pack --dry-run --ignore-scripts
 ```
 

package/defaults/prompts/SYSTEM.md

@@ -32,7 +32,8 @@ SapBuddy — SAP ABAP AI 全能助手，面向**开发顾问与业务顾问**。
    - **工具硬化**：`create_object_programmatically` 缺包名/描述会被拦截；传 $TMP 需用户单独确认（不进传输请求）；`replace_string` 无未释放请求时自动建请求——这些无需 LLM 自觉，工具强制执行。
 6c. **连接切换后先重确认（强制）**：用户切换/修改 SAP 连接后，**必须先调用 `get_connected_systems` 确认当前连接，再使用其他 SAP 工具**。工具层强制拦截：未确认前其他 SAP 工具一律失败（返回"连接配置已变更，先调用 get_connected_systems"）。看到该拦截错误时，立即调用 `get_connected_systems`，再重试被拦的操作。
 7. **写操作谨慎**：写工具（创建/编辑/激活）需要服务器 `security.readOnly=false`；生产系统只读。
-8. **按技能加载（强制）**：写代码/写 SAP 对象（函数模块/表结构/函数组 include/文本元素等）先遵循 `dev-write` 技能（编码规范、写入规范）；批量翻译（Excel 清单→SAP）先遵循 `translate-workflow` 技能（先 list 后 set、匹配不上报告、**禁止猜 key 写入**）。技能按话题自动加载，做对应任务时**必须遵守**。
+8. **按技能加载（强制）**：写代码/写 SAP 对象（函数模块/表结构/函数组 include/文本元素等）先遵循 `dev-write` 技能（编码规范、写入规范）；批量翻译（Excel 清单→SAP）先遵循 `translate-workflow` 技能（先 list 后 set、匹配不上报告、**禁止猜 key 写入**）。技能按话题自动加载，做对应任务时**必须遵守**；写 FS / 功能设计书时遵循 `sap-fs` 技能（意图不明先问，见铁律 9）。
+9. **FS 意图门禁（强制）**：仅当用户**明确**要写/改 FS、功能设计书、接口/报表/增强**规格文档**（或明确说按 sap-fs 出可交付文档）时，才加载并执行 `sap-fs`。日常问答、配置怎么配、表/事务码解释、程序解释/审查、写 ABAP 代码 → **禁止**触发 sap-fs（写码→`dev-write`；审查→`abap-code-review`；解释逻辑→`abap-explain` / `abap-wiki`）。用户只抛业务描述或方案讨论、**未明确**要出 FS → **先问一句**是否要按 sap-fs 产出 `FS.md` + `FS.html`（接口另附 JSON）；未确认前只澄清/回答，**不**套 FS 模板、不落盘 `output/fs/`。用户确认后才 Skill 加载 `sap-fs`；追问业务决策时再按 sap-fs 流程加载 `grilling`。
 
 ## 防死循环与止损（软约束，靠自觉；能代码强制的已由工具层兜底）
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sapbuddy-dsh",
-  "version": "0.0.8",
-  "description": "SapBuddy —— SAP ABAP AI 全能助手（DeepSeek Harness 插件）：41 个 SAP 工具 + 8 个 ABAP 技能 + SapBuddy preset + 连接设置页。一个包名装完。",
+  "version": "0.0.9",
+  "description": "SapBuddy —— SAP ABAP AI 全能助手（DeepSeek Harness 插件）：41 个 SAP 工具 + 10 个 ABAP 技能 + SapBuddy preset + 连接设置页。一个包名装完。",
   "type": "module",
   "main": "dist/index.js",
   "exports": {
@@ -77,13 +77,14 @@
     "typescript": "^5.6.0"
   },
   "scripts": {
-    "test": "npm run test:activation && npm run test:session && npm run test:store && npm run test:probe && npm run test:route && npm run test:bundle",
+    "test": "npm run test:activation && npm run test:session && npm run test:store && npm run test:probe && npm run test:route && npm run test:bundle && npm run test:sap-fs",
     "test:activation": "node --experimental-vm-modules --test --test-isolation=none test/activation.test.mjs",
     "test:session": "node --experimental-vm-modules --test --test-isolation=none test/session-recovery.test.mjs",
     "test:store": "node --test --test-isolation=none test/connections-store.test.mjs",
     "test:probe": "node --test --test-isolation=none test/connection-probe.test.mjs",
     "test:route": "node --test --test-isolation=none test/connection-test-route.test.mjs",
-    "test:bundle": "node --test --test-isolation=none test/client-bundle.test.mjs"
+    "test:bundle": "node --test --test-isolation=none test/client-bundle.test.mjs",
+    "test:sap-fs": "node --test --test-isolation=none test/sap-fs/loading.test.mjs"
   },
   "publishConfig": {
     "access": "public"

package/skills/grilling/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: grilling
+description: >-
+  Grill the user relentlessly about a plan, decision, or idea. Use when the user
+  wants to stress-test their thinking, or uses any 'grill' trigger phrases
+  (including "grill me"). Also used by sap-fs when clarifying FS business decisions;
+  not the entry skill for FS intent (load via sap-fs after user confirms FS deliverable).
+---
+
+<!--
+Third-party: mattpocock/skills (MIT, Copyright 2026 Matt Pocock)
+Upstream: https://github.com/mattpocock/skills
+  skills/productivity/grilling/SKILL.md
+Pinned blob: df69d9936880cd3314c28858c6c52f48db23b856 (fetched 2026-10-28)
+Adaptation: bundled under sapbuddy-dsh/skills for DSH discovery; description notes sap-fs;
+  "grill me" triggers are covered here directly (no separate grill-me alias).
+-->
+
+Interview the user relentlessly until you reach a shared understanding. Map this as a **design tree**: every decision branches into the decisions that hang off it.
+
+Work the tree in **rounds**. The **frontier** is every decision whose prerequisites are already settled: the questions you can ask _now_ without guessing at answers you haven't heard yet. Ask the whole frontier in one round: number each question and give your recommended answer. Then wait for the user's answers before the next round.
+
+Format a round like so:
+
+```
+❓ **Q1** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>
+
+➡️ <your recommended answer>
+
+---
+
+❓ **Q2** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>
+
+➡️ <your recommended answer>
+```
+
+Word each question so "yes" accepts your recommended answer.
+
+Each round the user answers reshapes the tree: settled decisions push the frontier outward and unblock questions that depended on them. Recompute the frontier and ask the next round. A question whose answer depends on another question still open in this round belongs to a _later_ round, not this one.
+
+Finding _facts_ is your job, never the user's. When a frontier question needs a fact from the environment (filesystem, tools, etc.), dispatch a sub-agent to find it; don't ask the user for anything you could look up yourself. Don't block on it: a running exploration is an unsettled prerequisite, so only the questions downstream of it wait for the sub-agent to report; ask the rest of the frontier now. The _decisions_ are the user's: put each to them and wait.
+
+The session is done when the frontier is empty: every branch of the design tree visited, nothing left silently assumed. Do not act on it until the user confirms you have reached a shared understanding.

package/skills/sap-fs/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: sap-fs
+description: >-
+  编写 SAP 功能规格书（FS / 功能设计书）。仅在用户明确要求写/改 FS、功能设计书、
+  接口设计、报表设计、增强设计，或明确说按 sap-fs 出可交付规格文档时触发。
+  日常问答、配置咨询、解释程序、代码审查、写 ABAP 不触发；意图不明时先问是否出 FS。
+  确认后：识别需求类型 → 系统取证 → 用 grilling 追问业务决策 → 按模板生成 FS。
+  触发关键词：写FS、功能规格、功能设计书、接口设计、报表设计、增强设计、出一份FS。
+agent_created: true
+disable: false
+---
+
+# sap-fs — 写 SAP 功能规格书
+
+> 草稿结构（Codex 第一版目录）。模板在 `assets/templates/`，过程规范在 `references/`。
+> 追问逻辑不内嵌：加载 `grilling`。上游许可与钉选说明见 `grilling/SKILL.md` 顶部注释。
+
+## 何时使用
+
+- 用户**明确**要写 / 改 FS、功能设计书、接口 / 报表 / 增强**规格文档**，或明确说按 sap-fs 出可交付文档。
+- 用户确认「要出 FS」之后（见 SYSTEM 铁律 FS 意图门禁）。
+
+不触发：日常问答、配置怎么配、表/事务码解释、程序解释（`abap-explain` / `abap-wiki`）、代码审查（`abap-code-review`）、写 ABAP（`dev-write` / `abap-templates`）。
+意图不明（只抛业务描述 / 方案讨论、未说要出 FS）：**先问一句**是否要按 sap-fs 产出 `FS.md` + `FS.html`（接口另附 JSON）；未确认前不套模板、不落盘 `output/fs/`。
+
+## 资源地图（按需加载，勿一次全读）
+
+| 时机 | 读什么 |
+| --- | --- |
+| 触发后立刻 | 本文件 + `references/fs-contract.md` |
+| 需要连系统 | `references/system-verification.md` |
+| 需要追问 | `references/grilling-integration.md`，并 **Skill 加载 `grilling`**（含 “grill me” 类触发） |
+| 已判定类型 | `references/types/<type>.md` + `assets/templates/fs-base.md` + `assets/templates/<type>.md` |
+| 对齐详略 | `references/example-enhancement.md`（仅增强类样例） |
+| 交付前 | `references/review-checklist.md` |
+| 出归档 HTML / 接口 JSON | `references/archive-html.md` + `assets/templates/fs-archive.html` |
+
+类型文件名：`interface` / `query-report` / `functional-report` / `enhancement`。
+
+## 工作流程
+
+1. **判类型**（混合取主导；ALV 按钮会改业务状态 → 功能报表）。读对应 `types/` 与模板。
+2. **整理已知**：用户已说内容分到需求 / 现状 / 规则，先不提问。
+3. **取证**：按 `system-verification.md` 只查能查的。
+4. **追问**：按 `grilling-integration.md` 加载 `grilling`，只问业务决策。
+5. **生成**：拼装 `fs-base` + 类型专项模板；规则 / 验收 / 待确认 / 附录按 `fs-contract.md`。
+6. **自检**：`review-checklist.md` 通过后再交付。
+
+## 拼装
+
+```
+assets/templates/fs-base.md     # 第1、2、4、5、6、7节 + 附录A
+  + assets/templates/<type>.md  # 第3节
+  + 头部状态行
+= 一份完整 FS
+```
+
+默认落盘目录（用户未指定时）：`output/fs/<需求名>/`（允许的 `output` 子树）；详见下方交付物。
+
+## 交付物（Markdown + HTML，接口另附 JSON）
+
+同一需求目录默认：`output/fs/<需求名>/`
+
+1. `FS.md` — 协作 / AI 主规格。
+2. `FS.html` — 企业归档：套 `assets/templates/fs-archive.html`，规则见 `references/archive-html.md`。
+3. **禁止 logo**（徽标、水印、品牌图都不放）。
+4. **接口类**另出：正文 3.6 样例 JSON + 同目录 `io-request.json` / `io-response.json`（及必要的回调文件）。
+
+先定稿 Markdown，再渲染 HTML / 写出 JSON；自检通过后一并交付路径。
+
+## 硬边界
+
+- 本技能流程**只读 SAP**；FS 确认 ≠ 写入许可。
+- 正文只写事实与决定；训诫与生成纪律留在技能文件，不进 FS。
+- 不虚构表名 / 字段 / 增强点 / 签署与测试结果。
+- HTML 归档不使用任何 logo。

package/skills/sap-fs/assets/templates/enhancement.md

@@ -0,0 +1,52 @@
+<!-- 本片段插入骨架第3节。增强只描述"在哪个时点、改变哪段行为、其余保持原样"。
+     第2节写整体现状；这里只写本次涉及的动作。 -->
+
+## 3. 增强设计
+
+### 3.1 改变的行为
+
+| 动作 | 现状 | 目标 | 保持不变 |
+| --- | --- | --- | --- |
+| <保存 / 过账 / 审批> | <现在怎么处理> | <改变后怎么处理> | <仍须沿用的标准行为> |
+
+**实施方式**：<标准配置能否满足；选增强的理由。未验证的判断标 Q。>
+
+### 3.2 触发点
+
+| 入口 | 时点 | 触发前状态 | 取得的数据 |
+| --- | --- | --- | --- |
+| <事务码 / 接口 / 后台> | <校验阶段 / 保存前 / 提交后> | <订单已保存 / 未保存> | <当前输入值 / 数据库旧值> |
+
+- **覆盖入口**：<前台、后台、接口分别是否覆盖；未确认的标 Q。>
+- **新旧值**：<规则用的是用户当前输入，还是已落库的值；修改后是否重新校验。>
+- **未保存数据**：<字段尚未落库时以什么为准。>
+- **派生值**：<标准逻辑或其它增强是否也会改同一字段；先后关系。>
+
+### 3.3 适用与排除
+
+| 项目 | 定义 |
+| --- | --- |
+| 命中条件 | <组织、单据类型、业务状态、角色> |
+| 排除条件 | <必须绕过增强的场景> |
+| 与其它规则的优先级 | <同时命中时先后；先报哪条> |
+| 不命中时 | <维持原有行为> |
+| 既有校验先失败时 | <是否继续执行本增强；用户最终看到什么> |
+
+### 3.4 处理逻辑
+
+<按顺序写：取数 → 判断 → 结果。引用 R-01 等规则编号，不在这里重复条件。>
+
+### 3.5 重复触发与事务
+
+| 场景 | 期望 |
+| --- | --- |
+| 同一操作多次触发 | <哪些可重复，哪些副作用只能发生一次> |
+| 保存后再次修改 | <哪些字段变化需要重新判断> |
+| 标准动作最终失败 | <本次已产生的变化是否必须一同撤销> |
+| 已调用外部系统 | <外部成功但本地失败的核对与补偿> |
+
+### 3.6 停用与回归
+
+- **停用后**：<恢复原有行为；已保存数据不回滚。>
+- **在途业务**：<处理中的单据、任务、外部请求如何处理。>
+- **回归范围**：<既有增强、标准校验、相关模块（凭证流、库存、财务）需要复测的部分。>

package/skills/sap-fs/assets/templates/fs-archive.html

@@ -0,0 +1,320 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>{{DOC_TITLE}}</title>
+<style>
+  /* Claude Design System tokens (from open-claude-ui cds-theme) — archive sheet, no logo */
+  :root {
+    --brand: #c6613f;
+    --cds-clay: #d97757;
+    --cds-clay-light: #fbf3ef;
+    --cds-gray-0: #fff;
+    --cds-gray-10: #fcfcfb;
+    --cds-gray-20: #f9f9f7;
+    --cds-gray-40: #f3f3f0;
+    --cds-gray-100: #e1e0d9;
+    --cds-gray-200: #c3c2b7;
+    --cds-gray-500: #6d6b67;
+    --cds-gray-600: #52514e;
+    --cds-gray-850: #151515;
+    --cds-text-primary: #151515;
+    --cds-text-secondary: #525252;
+    --cds-text-muted: #8a8a8a;
+    --cds-border: hsla(0, 0%, 8%, 0.10);
+    --cds-border-strong: hsla(0, 0%, 8%, 0.20);
+    --cds-shadow-sm: 0 1px 2px rgba(0,0,0,.05), 0 2px 8px rgba(0,0,0,.08);
+    --cds-shadow-md: 0 2px 4px rgba(0,0,0,.05), 0 6px 16px rgba(0,0,0,.08);
+    --radius-md: 6px;
+    --radius-lg: 8px;
+    --radius-xl: 12px;
+    --radius-2xl: 16px;
+    --font: "Anthropic Sans", "Segoe UI", "PingFang SC", "Microsoft YaHei", "Noto Sans CJK SC", sans-serif;
+    --mono: "Anthropic Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  }
+  * { box-sizing: border-box; }
+  body {
+    margin: 0;
+    min-height: 100vh;
+    color: var(--cds-text-primary);
+    background: var(--cds-gray-20);
+    font: 15px/1.65 var(--font);
+    -webkit-font-smoothing: antialiased;
+  }
+  .sheet {
+    max-width: 880px;
+    margin: 28px auto 48px;
+    padding: 36px 40px 40px;
+    background: var(--cds-gray-0);
+    border: 1px solid var(--cds-border);
+    border-radius: var(--radius-2xl);
+    box-shadow: var(--cds-shadow-md);
+  }
+  .accent-bar {
+    height: 3px;
+    width: 48px;
+    border-radius: 999px;
+    background: var(--cds-clay);
+    margin-bottom: 18px;
+  }
+  h1 {
+    margin: 0 0 10px;
+    font-size: 1.55rem;
+    font-weight: 600;
+    letter-spacing: -0.02em;
+    line-height: 1.3;
+  }
+  h2 {
+    margin: 32px 0 12px;
+    padding-bottom: 8px;
+    font-size: 1.1rem;
+    font-weight: 600;
+    letter-spacing: -0.01em;
+    border-bottom: 1px solid var(--cds-border);
+  }
+  h3 {
+    margin: 20px 0 8px;
+    font-size: 0.98rem;
+    font-weight: 600;
+    color: var(--cds-text-primary);
+  }
+  h4 {
+    margin: 14px 0 6px;
+    font-size: 0.9rem;
+    font-weight: 600;
+    color: var(--cds-text-secondary);
+  }
+  p, li { margin: 6px 0; color: var(--cds-text-primary); }
+  .lede { color: var(--cds-text-secondary); font-size: 0.92rem; }
+  .status {
+    display: inline-flex;
+    align-items: center;
+    gap: 6px;
+    margin: 4px 0 18px;
+    padding: 4px 10px;
+    border-radius: 999px;
+    background: var(--cds-clay-light);
+    color: var(--brand);
+    border: 1px solid color-mix(in srgb, var(--cds-clay) 28%, transparent);
+    font-size: 0.78rem;
+    font-weight: 500;
+  }
+  .status::before {
+    content: "";
+    width: 6px; height: 6px;
+    border-radius: 50%;
+    background: var(--cds-clay);
+  }
+  .meta {
+    display: grid;
+    grid-template-columns: 7.5rem 1fr;
+    gap: 8px 14px;
+    margin: 0 0 8px;
+    padding: 14px 16px;
+    background: var(--cds-gray-10);
+    border: 1px solid var(--cds-border);
+    border-radius: var(--radius-xl);
+    font-size: 0.88rem;
+  }
+  .meta dt { color: var(--cds-text-muted); font-weight: 500; }
+  .meta dd { margin: 0; color: var(--cds-text-secondary); }
+  table {
+    width: 100%;
+    border-collapse: separate;
+    border-spacing: 0;
+    margin: 12px 0 18px;
+    font-size: 0.86rem;
+    border: 1px solid var(--cds-border);
+    border-radius: var(--radius-xl);
+    overflow: hidden;
+    background: var(--cds-gray-0);
+  }
+  th, td {
+    padding: 9px 11px;
+    text-align: left;
+    vertical-align: top;
+    border-bottom: 1px solid var(--cds-border);
+  }
+  tr:last-child td { border-bottom: none; }
+  th {
+    background: var(--cds-gray-40);
+    color: var(--cds-text-secondary);
+    font-weight: 600;
+  }
+  tbody tr:nth-child(even) td { background: var(--cds-gray-10); }
+  .card {
+    margin: 12px 0;
+    padding: 12px 14px;
+    border: 1px solid var(--cds-border);
+    border-radius: var(--radius-xl);
+    background: var(--cds-gray-10);
+    box-shadow: var(--cds-shadow-sm);
+  }
+  .card > :first-child { margin-top: 0; }
+  pre, code { font-family: var(--mono); font-size: 0.8rem; }
+  code {
+    padding: 1px 5px;
+    border-radius: var(--radius-md);
+    background: var(--cds-gray-40);
+    color: var(--cds-gray-850);
+  }
+  .code-block {
+    position: relative;
+    margin: 10px 0 16px;
+  }
+  pre {
+    margin: 10px 0 16px;
+    padding: 14px 16px;
+    background: #1e1e1d;
+    color: #f5f5f5;
+    border-radius: var(--radius-xl);
+    border: 1px solid var(--cds-gray-850);
+    overflow: auto;
+    white-space: pre-wrap;
+    word-break: break-word;
+  }
+  .code-block pre {
+    margin: 0;
+    padding-top: 40px;
+  }
+  pre code { background: transparent; color: inherit; padding: 0; }
+  .copy-btn {
+    position: absolute;
+    top: 8px;
+    right: 8px;
+    z-index: 1;
+    padding: 4px 10px;
+    font: 500 0.72rem/1.4 var(--font);
+    color: var(--cds-gray-600);
+    background: var(--cds-gray-10);
+    border: 1px solid var(--cds-border-strong);
+    border-radius: var(--radius-md);
+    cursor: pointer;
+    box-shadow: var(--cds-shadow-sm);
+  }
+  .copy-btn:hover {
+    color: var(--brand);
+    border-color: color-mix(in srgb, var(--cds-clay) 45%, var(--cds-border-strong));
+    background: var(--cds-clay-light);
+  }
+  .copy-btn.copied {
+    color: var(--brand);
+    border-color: color-mix(in srgb, var(--cds-clay) 45%, transparent);
+    background: var(--cds-clay-light);
+  }
+  ul { padding-left: 1.2rem; }
+  footer {
+    margin-top: 36px;
+    padding-top: 14px;
+    border-top: 1px solid var(--cds-border);
+    color: var(--cds-text-muted);
+    font-size: 0.75rem;
+  }
+  /* Explicitly no logo / brand mark images */
+  @media print {
+    body { background: #fff; }
+    .sheet {
+      margin: 0; max-width: none;
+      border: none; box-shadow: none; border-radius: 0; padding: 0;
+    }
+    h2, .card, table, pre { break-inside: avoid; }
+  }
+</style>
+</head>
+<body>
+  <article class="sheet">
+    <div class="accent-bar" aria-hidden="true"></div>
+    <header>
+      <h1>{{DOC_TITLE}}</h1>
+      <p class="status">{{STATUS_LINE}}</p>
+      <dl class="meta">
+        <dt>项目 / 模块</dt><dd>{{PROJECT_MODULE}}</dd>
+        <dt>系统与客户端</dt><dd>{{SYSTEM_CLIENT}}</dd>
+        <dt>需求提出人</dt><dd>{{REQUESTER}}</dd>
+        <dt>类型</dt><dd>{{FS_TYPE}}</dd>
+        <dt>更新</dt><dd>{{UPDATED}}</dd>
+      </dl>
+    </header>
+    <div class="body">
+      {{BODY_HTML}}
+    </div>
+    <footer>
+      Generated by SapBuddy
+    </footer>
+  </article>
+  <script>
+  (function () {
+    function getCodeText(pre) {
+      var code = pre.querySelector("code");
+      return (code || pre).textContent;
+    }
+    function wrapPre(pre) {
+      if (pre.closest(".code-block")) return;
+      var wrap = document.createElement("div");
+      wrap.className = "code-block";
+      pre.parentNode.insertBefore(wrap, pre);
+      wrap.appendChild(pre);
+      var btn = document.createElement("button");
+      btn.type = "button";
+      btn.className = "copy-btn";
+      btn.setAttribute("aria-label", "复制代码");
+      btn.textContent = "复制";
+      btn.addEventListener("click", function () {
+        var text = getCodeText(pre);
+        function ok() {
+          btn.textContent = "已复制";
+          btn.classList.add("copied");
+          setTimeout(function () {
+            btn.textContent = "复制";
+            btn.classList.remove("copied");
+          }, 1500);
+        }
+        function fail() {
+          btn.textContent = "失败";
+          setTimeout(function () { btn.textContent = "复制"; }, 1500);
+        }
+        if (navigator.clipboard && navigator.clipboard.writeText) {
+          navigator.clipboard.writeText(text).then(ok).catch(function () {
+            try {
+              var ta = document.createElement("textarea");
+              ta.value = text;
+              ta.setAttribute("readonly", "");
+              ta.style.position = "fixed";
+              ta.style.left = "-9999px";
+              document.body.appendChild(ta);
+              ta.select();
+              document.execCommand("copy");
+              document.body.removeChild(ta);
+              ok();
+            } catch (e) { fail(); }
+          });
+        } else {
+          try {
+            var ta2 = document.createElement("textarea");
+            ta2.value = text;
+            ta2.setAttribute("readonly", "");
+            ta2.style.position = "fixed";
+            ta2.style.left = "-9999px";
+            document.body.appendChild(ta2);
+            ta2.select();
+            document.execCommand("copy");
+            document.body.removeChild(ta2);
+            ok();
+          } catch (e2) { fail(); }
+        }
+      });
+      wrap.appendChild(btn);
+    }
+    function init() {
+      document.querySelectorAll("pre").forEach(wrapPre);
+    }
+    if (document.readyState === "loading") {
+      document.addEventListener("DOMContentLoaded", init);
+    } else {
+      init();
+    }
+  })();
+  </script>
+</body>
+</html>

package/skills/sap-fs/assets/templates/fs-base.md

@@ -0,0 +1,93 @@
+<!-- 写作约定（渲染时不可见，生成后删除本段）
+- 只写事实与决定。建议标【建议】；未定标【待确认 Q-xx】；不适用写【不适用：原因】。
+- 编号：R 业务规则、T 验收、Q 待确认、E 证据、M 消息。只在本文件内唯一，不重排。
+- 字段用业务名，就地写清类型、必填、取值来源与格式。同一字段在不同位置格式不同时，各自写清换算。
+- 每条规则必须能判真假，并且能被至少一个 T 用例验证。
+- 不写"不得/禁止/注意"类训诫——生成纪律由技能规则约束，不进正文。
+- 拿不准的内容不要写成事实；宁可留 Q，也不要补一个看似合理的值。
+-->
+
+# FS：<需求名称>（<类型>）
+
+状态：草稿 · 待确认 <N> 项 · 更新 <YYYY-MM-DD>
+项目 / 模块：<项目名 · 模块> ｜ 系统与客户端：<连接名 / Client> ｜ 需求提出人：<角色或姓名>
+
+## 1. 需求与范围
+
+**背景与问题**
+<业务现在遇到什么问题，具体表现是什么。>
+
+**业务目标**
+<期望达到的可观察结果，而不是"实现某功能"。>
+
+**在范围内**
+<业务对象、组织范围、业务入口、时间范围。>
+
+**不在范围内**
+<明确排除的部分。>
+
+**依赖与前置条件**
+<需要先具备的主数据、配置、外部系统、相关需求。>
+
+## 2. 现状与差异
+
+| 环节 | 系统当前行为 | 依据 |
+| --- | --- | --- |
+| <业务环节> | <当前实际怎么处理> | E-01 / 需求确认 |
+|  |  |  |
+
+**差异说明**：<这次要改变什么，哪些保持不变。>
+
+## 3. <类型专项：插入 02–05 之一>
+
+## 4. 业务规则
+
+### R-01 <规则名称>
+
+- **条件**：<可判真假的条件；涉及金额数量时写清币种、单位、精度、含税口径。>
+- **结果**：<系统应表现出的行为：阻止 / 提示 / 赋值 / 生成单据。>
+- **异常**：<缺失、为空、越界、重复时怎么处理；不命中任何条件时怎样。>
+- **依据**：<业务确认的时间与场合 / E-xx / Q-xx。建议未获确认时写【建议】。>
+- **验收**：T-01
+
+<多于一条规则时按 R-02、R-03 复制。规则之间有优先级时，在上一条的「条件」里写清。>
+
+## 5. 权限、消息与运行
+
+**权限**
+<角色、组织范围、权限对象；未核实写 Q。不新增权限时写明沿用哪个标准权限。>
+
+**消息**
+
+| 编号 | 触发条件 | 用户看到的文案 |
+| --- | --- | --- |
+| M-01 | R-01 不通过 | <可直接给用户看的文字> |
+
+**运行**
+<前台/后台、频率、单次数据量、时效要求；无特殊要求写「无特殊要求」。>
+
+## 6. 验收
+
+### T-01 <场景名称>
+
+- **前置**：<可重复准备的初始状态。>
+- **输入**：<具体取值或操作步骤。>
+- **预期**：<可核对的结果：值、状态、消息、是否保存成功。>
+
+<边界、异常、重复提交各有独立用例，按 T-02、T-03 复制。只在真实执行后补记结果。>
+
+## 7. 待确认
+
+| 编号 | 问题 | 谁来定 | 影响 |
+| --- | --- | --- | --- |
+| Q-01 | <一个具体问题，不是话题> | <业务 / 技术 / 系统查询> | <影响哪条规则或测试> |
+
+## 附录 A 取证记录
+
+| 编号 | 查了什么 | 结果 | 限制与结论 |
+| --- | --- | --- | --- |
+| E-01 | <工具与参数 / 对象与字段 / 查询条件与行数上限> | <客观返回：行数、字段、错误> | <这份证据能证明什么，不能证明什么> |
+
+<只记录实际做过的查询。零行 ≠ 对象不存在；样本符合 ≠ 全量正确；对象存在 ≠ 时点与行为已验证。>
+
+Generated by SapBuddy

package/skills/sap-fs/assets/templates/functional-report.md

@@ -0,0 +1,60 @@
+<!-- 本片段插入骨架第3节。功能报表会改变业务状态：除查询与展示外，必须写清执行单元、
+     哪些记录共同成功、失败后停在哪里。 -->
+
+## 3. 功能设计
+
+### 3.1 业务动作
+
+| 动作 | 业务效果 | 前置状态 | 目标状态 |
+| --- | --- | --- | --- |
+| <批准 / 过账 / 创建 / 重处理> | <具体改变什么业务内容> | <执行前必须满足什么> | <成功后是什么状态> |
+
+**实现方式与取舍**：<标准事务码 / 标准功能 / 自建程序；为何选这个；标准功能能否满足。未验证标 Q。>
+
+- **不包含的动作**：<明确排除，避免开发自行扩大范围。>
+- **前置确认**：<正式执行前向用户展示哪些对象、数量、金额与不可逆影响。>
+
+### 3.2 输入与候选
+
+| 条件 / 字段 | 含义 | 技术名称 | 类型 | 必填 | 输入形式 | 默认值 |
+| --- | --- | --- | --- | --- | --- | --- |
+| 工厂 | 限制可处理工厂 | WERKS | CHAR(4) | 是 | 多选，F4 | 用户默认工厂 |
+
+上面一行为填写示范，生成实际 FS 时替换。
+
+- **候选来源**：<从哪些对象、按什么条件筛出可处理记录；关联基数是 1:1 还是 1:N。>
+- **已处理对象**：<是否仍出现在列表中；以什么状态显示；还能执行哪些动作。>
+- **列表到执行的失效**：<展示后状态或数量发生变化时，执行前如何重新校验。>
+
+### 3.3 校验
+
+| 顺序 | 校验层级 | 条件 | 未通过时 | 消息 |
+| --- | --- | --- | --- | --- |
+| 1 | 字段 | <…> | 阻止该行 | M-01 |
+| 2 | 单据 | <…> | 阻止整张单据 | M-02 |
+| 3 | 批次 | <…> | 阻止整批 | M-03 |
+
+校验顺序决定用户先看到哪条错误，必须写明；不同层级失败的阻断范围不同。
+
+### 3.4 执行单元与部分成功
+
+- **执行单元**：<一行、一张单据还是整批；输入行与执行单元的对应关系。>
+- **单据内原子性**：<同一单据多行是否必须整体成功；不适用时写原因。>
+- **跨单据策略**：<一张失败后其余继续或停止；已成功的如何保留与告知。>
+- **结果记录**：<逐行还是逐单据给出结果；成功与失败数量口径。>
+- **重新处理**：<再次执行时如何排除已成功对象。>
+
+### 3.5 重复、并发与结果未知
+
+- **重复判定键**：<哪些业务字段代表同一次意图；不能用每次新生成的批次号。>
+- **重复提交**：<双击、重复导入、后台重跑时分别怎样。>
+- **并发**：<哪些对象不能被同时处理；冲突时拒绝、排队还是重新校验。>
+- **结果未知**：<超时或断连后，先用什么核实真实结果，再决定是否重试。>
+- **恢复起点**：<从未处理单元恢复，还是从失败步骤恢复。>
+
+### 3.6 执行方式
+
+- **前台 / 后台**：<是否都支持；不支持时说明。>
+- **试运行**：<是否需要、系统是否具备；能模拟哪些校验、绝不能发生哪些写入。>
+- **数据量与中断**：<单次处理量、时效；取消时已成功部分如何处理。>
+- **日志**：<记录业务键、动作、结果、时间；保留要求。>

package/skills/sap-fs/assets/templates/interface.md

@@ -0,0 +1,92 @@
+<!-- 本片段插入骨架第3节。只写与"消息怎么进出、字段怎么换算、什么算成功"有关的内容；
+     权限、消息文案、验收、证据分别在骨架第5、6节和附录A。 -->
+
+## 3. 接口设计
+
+### 3.1 交互边界
+
+| 项目 | 定义 |
+| --- | --- |
+| 业务用途与成功标志 | <对方拿到什么、能据此完成什么业务；什么结果才算这次交互成功> |
+| 调用发起方 → 被调用方 | <哪边主动发起> |
+| 业务数据源 → 业务数据目标 | <数据从哪个系统产生、最终落在哪里。可能与调用方向相反> |
+| 协议 / 同步或异步 | <已定的协议；异步时说明返回的是受理还是完成> |
+| 触发方式与频率 | <业务事件 / 定时 / 人工；时间窗口与时区> |
+| 备选方案与取舍 | <考虑过的其它做法，为什么选这个；没有则写「无」> |
+
+### 3.2 消息与字段
+
+消息：<名称>（请求 / 响应 / 回调），方向 <A → B>
+
+| 路径 | 含义 | 类型(长度) | 必填 | 取值来源与换算 | 空值处理 |
+| --- | --- | --- | --- | --- | --- |
+| Header.OrderId | 采购订单号 | CHAR(10) | 是 | 取自 EKKO-EBELN，补足前导零 | 为空即拒绝 |
+| Items[].Price | 行项目净价 | DEC(11,2) | 是 | EKPO-NETPR，按价格单位换算为单价 | 0 与空分别处理：0 合法，空拒绝 |
+| Items[].DelivDate | 交货日期 | CHAR(10) | 否 | EKPO-EINDT，`YYYY-MM-DD` | 空表示未定，不参与计算 |
+
+<`Items[]` 表示重复集合，路径在全文保持一致。多级结构按实际层级展开，不限制层数。
+ 上面三行是填写示范，生成实际 FS 时替换。>
+
+固定部分：编码 <UTF-8 / 其它>；日期格式 <…>；标识类字段保留前导零 <是/否>。
+
+### 3.3 传输范围
+
+| 项目 | 规则 |
+| --- | --- |
+| 全量 / 增量 | <哪一种；两者都要时写清切换条件> |
+| 筛选条件 | <组织、业务类型、状态等；可与增量叠加> |
+| 增量依据 | <变更时间 / 序号 / 事件；是否覆盖新增、修改、删除、冲销> |
+| 边界与迟到 | <起止是否包含、时区、同时间戳的次序、迟到记录怎么处理> |
+| 水位推进 | <在哪个节点推进：发送成功 / 受理成功 / 业务成功> |
+| 空批次 | <没有数据时是否发送、如何记录> |
+| 首次与补传 | <初始范围、历史补传、断点恢复> |
+
+### 3.4 结果与失败
+
+| 场景 | 期望处理 | 由谁确认结果 |
+| --- | --- | --- |
+| 正常完成 | <响应里返回什么，对端据此判断什么> | <接收方 / 人工核对> |
+| 重复请求 | <业务键是什么；再次到达时返回原结果还是拒绝> |  |
+| 同键不同内容 | <比较哪些字段；冲突怎么处理> |  |
+| 部分成功 | <业务原子单元是一行、一张单据还是整批；已成功部分是否保留> |  |
+| 超时或结果未知 | <先用什么核对真实结果；确认前是否允许重试> |  |
+| 需要补偿 | <SAP 与对端各自的实际状态；谁来修> |  |
+
+结论层次写清楚：<传输到达 / 已受理 / 业务完成>分别以什么为证据——三者不能相互替代。
+
+### 3.5 日志与对账
+
+- **日志**：<记录哪些关联标识、状态、业务编号、错误摘要；保留多久。>
+- **对账**：<用哪些业务键核对数量或金额，在什么时间窗口，容差多少，差异由谁处理。>
+- **技术对象**：<函数 / API / 服务的候选名称与用途，标清是已核实还是待验证。>
+### 3.6 样例 JSON（归档必出）
+
+按 3.2 字段表整理**一份可联调的示例**（虚构但类型/必填/格式与表一致）。HTML 归档时把下列代码块原样放入「样例 JSON」节。
+
+**请求示例**
+
+```json
+{
+  "Header": {
+    "OrderId": "4500001234"
+  },
+  "Items": [
+    {
+      "Price": 12.50,
+      "DelivDate": "2026-11-01"
+    }
+  ]
+}
+```
+
+**响应示例**
+
+```json
+{
+  "Status": "ACCEPTED",
+  "BusinessKey": "4500001234",
+  "Message": "受理成功"
+}
+```
+
+说明：路径、嵌套与 3.2 保持一致；空值/0 按表中「空值处理」示范；多消息（请求/响应/回调）各自给一组。未定字段不要编造业务值，标【待确认】或从示例中去掉。

package/skills/sap-fs/assets/templates/query-report.md

@@ -0,0 +1,55 @@
+<!-- 本片段插入骨架第3节。查询报表只读；若某个操作会改变业务状态，改用功能报表片段。 -->
+
+## 3. 报表设计
+
+### 3.1 输出与粒度
+
+| 项目 | 定义 |
+| --- | --- |
+| 报表用途 | <使用者据此判断什么、随后做什么> |
+| 一行代表什么 | <一张单据 / 一个行项目 / 一个期间汇总> |
+| 业务唯一键 | <哪些字段组合唯一确定一行> |
+| 多种视图 | <明细与汇总各自定义粒度；没有则写「仅明细」> |
+| 数据时点 | <查询时点快照 / 实时状态 / 某个业务截止点> |
+| 实现方式与取舍 | <标准事务码 / 标准报表 / 自建程序；为何选这个；标准功能能否满足> |
+
+### 3.2 选择条件
+
+| 字段 | 含义 | 技术名称 | 类型 | 必填 | 输入形式 | 默认值 | 校验 |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| 工厂 | 限制工厂范围 | WERKS | CHAR(4) | 否 | 多选，F4 | <无 / 用户默认> | 必须属于用户权限范围 |
+
+- **空值含义**：<未输入表示"不限"还是"必须输入"；两者必须选一个。>
+- **条件依赖**：<哪些条件互斥、成组必填、受上级条件约束。>
+- **日期边界**：<用哪个业务日期、起止是否包含、时区。>
+- **最小筛选范围**：<允许全量按组织范围执行，还是必须至少给一个条件。>
+
+### 3.3 输出字段
+
+| 显示名 | 来源 / 计算 | 类型(长度,小数) | 格式 | 空值与零的显示 |
+| --- | --- | --- | --- | --- |
+| 采购订单号 | EKKO-EBELN | CHAR(10) | 去前导零，左对齐 | — |
+| 订单净额 | SUM(EKPO-NETWR) | DEC(15,2) | 右对齐，2 位小数 | 无非空行时显示 0.00，不显示留白 |
+
+<字段较多时按视图拆表；同一字段在不同视图格式不同，各自写清。>
+
+### 3.4 取数与关联
+
+| 来源 | 用于 | 关联键 | 基数 | 无匹配 | 多匹配 |
+| --- | --- | --- | --- | --- | --- |
+| EKKO | 抬头 | EBELN | 1:1 | 排除该行 | 不应发生，出现则报错 |
+| EKPO | 行项目 | EBELN | 1:N | 保留抬头、行值留空 | 正常展开 |
+
+- **排除状态**：<删除、取消、冲销、冻结等状态是否纳入；逐个写清。>
+- **当前值 vs 历史值**：<名称、组织归属、价格取当期值还是业务发生时值。>
+- **重复放大风险**：<一对多关联后金额是否会被重复累加；如何避免。>
+
+### 3.5 计算与核对
+
+- **计算顺序**：<过滤 → 换算 → 关联 → 汇总，写明先后。>
+- **币种与单位**：<换算汇率类型与取值日期；不换算时说明理由。>
+- **舍入**：<在哪一层舍入、保留几位；累加用未舍入值还是舍入值。>
+- **比率与累计**：<分子分母、期间；不得对百分比直接相加。>
+- **空值传播**：<关键字段缺失时该行不可计算，显示为空而不是 0。>
+- **对账依据**：<用哪张标准报表或独立查询核对；容差与差异说明。>
+- **数据量与时效**：<典型行数、峰值、可接受的响应时间；超出上限时如何提示。>

package/skills/sap-fs/references/archive-html.md

@@ -0,0 +1,34 @@
+# HTML 归档交付
+
+企业归档除 Markdown（给 AI / 协作）外，**必须同时**生成一份 HTML。
+
+## 产出物
+
+默认目录：`output/fs/<需求名>/`
+
+| 文件 | 说明 |
+| --- | --- |
+| `FS.md` | 主规格（AI 友好） |
+| `FS.html` | 归档版：用 `assets/templates/fs-archive.html` 填入 |
+| `io-request.json` / `io-response.json`（仅接口类） | 与正文 3.6 样例一致；若有回调可再加 `io-callback.json` |
+
+用户指定路径时，在同一目录并列输出。
+
+## HTML 规则
+
+1. **禁止 logo**：不放公司徽标、项目 Logo、水印、背景品牌图；页眉只用文字标题与元信息。
+2. **自包含**：单文件；CSS 内联；无外链脚本/字体 CDN。
+3. **内容来源**：由已定稿的 `FS.md` 渲染为 HTML 片段填入 `{{BODY_HTML}}`；表格保留为 `<table>`；代码块用 `<pre>`。
+4. **版式**：清晰层级（h1–h3）、可打印（`@media print` 已在模板）；不模仿客户 Word 封面里的企业 VI。
+5. **替换占位符**：`{{DOC_TITLE}}` `{{STATUS_LINE}}` `{{PROJECT_MODULE}}` `{{SYSTEM_CLIENT}}` `{{REQUESTER}}` `{{FS_TYPE}}` `{{UPDATED}}` `{{BODY_HTML}}`；交付稿不得残留 `{{...}}`。
+
+## 接口类 JSON
+
+- 字段表（3.2）是权威；JSON 样例必须与路径/类型/必填/空值处理一致。
+- 至少各一份请求与响应；异步/回调按 3.1 再补。
+- JSON 文件与 HTML 内「样例 JSON」节内容相同，便于联调拷贝。
+- 未知字段不编造：留 Q，或从样例省略并在说明里写清。
+
+## 生成顺序
+
+定稿 Markdown →（接口类）整理 JSON 文件 → 填 HTML 模板 → 自检无 logo、无占位符、接口样例齐全。

package/skills/sap-fs/references/example-enhancement.md

@@ -0,0 +1,163 @@
+<!-- 示例文件：需求、数据、对象名均为虚构，仅用于演示填写方式与详略程度。
+     其中的数值和技术对象未在真实系统验证，不能作为任何项目的设计依据。 -->
+
+# FS：采购订单保存校验（增强）
+
+状态：草稿 · 待确认 4 项 · 更新 2026-10-28
+项目 / 模块：示例项目 · MM-PUR ｜ 系统与客户端：DEV / 100 ｜ 需求提出人：采购部
+
+## 1. 需求与范围
+
+**背景与问题**
+采购订单由多人分头维护，保存时既不校验行项目交货日期与抬头凭证日期的先后，也不识别大额订单。结果有两类问题：交货日期早于凭证日期的订单进入系统，后续 MRP 交期推算出负数；超过 10 万元的订单未走高额审批，靠财务事后抽查发现。
+
+**业务目标**
+保存时拦截日期倒挂的订单；超过阈值时要求补审批标识。上线后不再新增这两类错误数据。
+
+**在范围内**
+ME21N / ME22N 的保存动作，行项目层面，公司代码 1000 与 2000。
+
+**不在范围内**
+已保存订单的历史数据修正；审批流本身（沿用既有工作流）；采购申请。
+
+**依赖与前置条件**
+审批标识的存放字段未定（Q-02）；接口创建采购订单是否同样校验未定（Q-03）。
+
+## 2. 现状与差异
+
+| 环节 | 系统当前行为 | 依据 |
+| --- | --- | --- |
+| ME21N 保存 | 不校验 EKPO-EINDT 与 EKKO-BEDAT 的先后，日期倒挂可正常保存 | E-01 |
+| 大额订单 | 无金额阈值判断，也没有审批标识相关校验 | E-02 |
+| 增强点候选 | 候选 BAdI `ME_PROCESS_PO_CUST` 的 CHECK 方法，尚未验证本系统是否实现及其调用时点 | E-03 |
+
+**差异说明**：两条校验在现状中都不存在，属于新增；既有字段校验、编号分配、后续审批流保持不变。
+
+## 3. 增强设计
+
+### 3.1 改变的行为
+
+| 动作 | 现状 | 目标 | 保持不变 |
+| --- | --- | --- | --- |
+| 保存采购订单 | 校验通过即写库 | 先执行 R-01、R-02，不通过则不写库 | 既有字段校验、订单编号分配、审批流触发 |
+
+**实施方式**：两条都是保存前的阻断式校验，标准配置无法覆盖，走增强。CHECK 方法是否在写库前调用，待技术确认（E-03）。
+
+### 3.2 触发点
+
+| 入口 | 时点 | 触发前状态 | 取得的数据 |
+| --- | --- | --- | --- |
+| ME21N / ME22N 保存 | 抬头与行项目校验阶段，写库之前 | 订单未保存 | 用户当前输入值，含尚未落库的修改 |
+| 接口 / 后台创建订单 | 待确认（Q-03） | — | — |
+
+- **覆盖入口**：前台确定覆盖；接口与后台未确认。
+- **新旧值**：使用当前输入值，不使用数据库旧值；修改行项目后重新校验。
+- **未保存数据**：新增行项目的 EINDT 尚未落库，以屏幕输入为准。
+- **派生值**：标准逻辑在保存时会重新计算净价与税额，不影响本规则的判断字段。
+
+### 3.3 适用与排除
+
+| 项目 | 定义 |
+| --- | --- |
+| 命中条件 | 公司代码 1000 / 2000；订单类型 NB |
+| 排除条件 | 退货订单是否排除待定（Q-04）；当前按不排除处理 |
+| 与其它规则的优先级 | R-01 先于 R-02；两条都不通过时先报 R-01 |
+| 不命中时 | 维持原有保存行为 |
+| 既有校验先失败时 | 不再执行本增强，用户先处理标准报错 |
+
+### 3.4 处理逻辑
+
+保存触发后，逐行项目执行 R-01；全部行通过后按整单执行 R-02。任一规则不通过即中止保存，消息中指出具体行号。变量取值、精度与舍入口径见各规则的「条件」。
+
+### 3.5 重复触发与事务
+
+| 场景 | 期望 |
+| --- | --- |
+| 同一操作多次触发 | 校验无写入副作用，可重复执行 |
+| 保存后再次修改 | 重新校验全部行，不沿用上次结论 |
+| 标准动作最终失败 | 本增强不产生独立数据，无需回滚 |
+| 已调用外部系统 | 不适用：本增强不调用外部系统 |
+
+### 3.6 停用与回归
+
+- **停用后**：恢复原有保存行为；已保存数据不回滚，也不批量修复。
+- **在途业务**：不适用：校验不产生在途状态。
+- **回归范围**：正常保存、行项目增删改、既有字段校验、审批流创建、公司代码 1000 与 2000 之外的订单不受影响。
+
+## 4. 业务规则
+
+### R-01 交货日期不得早于凭证日期
+
+- **条件**：行项目 EKPO-EINDT < 抬头 EKKO-BEDAT，按行项目逐条判断；两个字段都是日期，比较到日，不含时间。
+- **结果**：阻止保存，输出 M-01，消息中带出行号。
+- **异常**：任一日期为空视为未填，不参与比较，交回标准逻辑处理；两个日期相同时视为通过。
+- **依据**：业务确认（2026-10-27 需求确认会），确认口径为"相等不算倒挂"。
+- **验收**：T-01、T-02
+
+### R-02 大额订单需补审批标识
+
+- **条件**：整单金额 > 100,000.00。币种、含税口径、按整单还是行项目计算均未确定（Q-01）；当前按"整单含税人民币"计算，标【建议】。
+- **结果**：输出 M-02 提示补审批标识；阻断保存或仅提示，待定（Q-01），当前按【建议：阻断】处理。
+- **异常**：金额缺失或无法换算时不判断，避免把缺失当成 0；仅提示不阻断时仍记录日志。
+- **依据**：业务提出阈值 10 万元，口径未确认（Q-01、Q-02）。
+- **验收**：T-03、T-04
+
+## 5. 权限、消息与运行
+
+**权限**
+沿用标准采购订单维护权限，不新增权限对象；校验对所有能保存该订单类型的用户生效，不设例外放行。
+
+**消息**
+
+| 编号 | 触发条件 | 用户看到的文案 |
+| --- | --- | --- |
+| M-01 | R-01 不通过 | 第 &1 行交货日期早于凭证日期（&2），请修改后保存 |
+| M-02 | R-02 不通过 | 订单金额超过 10 万元，请补充审批标识后再保存 |
+
+**运行**
+前台保存时同步执行，单次涉及行项目通常少于 50 行；无特殊时效要求。
+
+## 6. 验收
+
+### T-01 交货日期早于凭证日期
+
+- **前置**：可创建 NB 类型订单的用户，公司代码 1000。
+- **输入**：凭证日期 2026-10-20，某行交货日期 2026-10-19。
+- **预期**：不能保存，M-01 提示该行行号。
+
+### T-02 日期相同（边界）
+
+- **前置**：同 T-01。
+- **输入**：凭证日期与交货日期均为 2026-10-20。
+- **预期**：可以保存。
+
+### T-03 金额恰好等于阈值（边界）
+
+- **前置**：同 T-01。
+- **输入**：整单含税金额 100,000.00。
+- **预期**：不提示、可保存（当前建议：整单含税人民币、等于阈值不触发）。依赖 Q-01；结论变化则本用例失效。【阻塞：Q-01 未关闭】
+
+### T-04 金额超过阈值
+
+- **前置**：同 T-01。
+- **输入**：整单含税金额 100,000.01。
+- **预期**：输出 M-02，并阻止保存（当前建议：阻断）。依赖 Q-01；结论变化则本用例失效。【阻塞：Q-01 未关闭】
+
+## 7. 待确认
+
+| 编号 | 问题 | 谁来定 | 影响 |
+| --- | --- | --- | --- |
+| Q-01 | 阈值按含税还是不含税、整单还是行项目、是否换算人民币、等于阈值是否触发 | 采购部 | R-02、T-03 |
+| Q-02 | 审批标识放在哪个字段，是否需要新增字段 | 采购部 + 技术 | R-02 能否实现、M-02 的判断依据 |
+| Q-03 | 接口与后台创建订单是否同样校验 | 采购部 | 3.2 覆盖入口、T 用例范围 |
+| Q-04 | 退货订单是否排除 | 采购部 | 3.3 排除条件 |
+
+## 附录 A 取证记录
+
+| 编号 | 查了什么 | 结果 | 限制与结论 |
+| --- | --- | --- | --- |
+| E-01 | `get_abap_object_info` 查 EKKO、EKPO 字段结构 | EINDT 为 DATS(8)，BEDAT 为 DATS(8)，字段存在且类型一致 | 只证明字段存在；未验证标准保存逻辑里是否已有同类校验 |
+| E-02 | `execute_data_query` 查近 3 个月公司代码 1000 的订单币种与净额分布，限 200 行 | 出现 CNY 与 USD 两种币种；其中 2 单净额超过 10 万 | 限 200 行，不代表全量与历史；未覆盖其它公司代码 |
+| E-03 | `search_abap_objects` 查 `ME_PROCESS_PO_CUST` 相关对象 | 返回增强实现类候选 | 未验证调用时点、是否在写库前、是否覆盖全部入口；需技术确认 |
+
+Generated by SapBuddy

package/skills/sap-fs/references/fs-contract.md

@@ -0,0 +1,64 @@
+# FS 合同（编号、状态、字段、证据）
+
+## 状态行
+
+```
+状态：草稿 · 待确认 <N> 项 · 更新 <YYYY-MM-DD>
+项目 / 模块：… ｜ 系统与客户端：… ｜ 需求提出人：…
+```
+
+`<N>` 必须等于正文「待确认」表中 Q 的实际条数。
+
+## 编号（本文件内唯一，不重排）
+
+| 前缀 | 含义 | 出现位置 |
+| --- | --- | --- |
+| R | 业务规则 | 第4节 |
+| T | 验收用例 | 第6节 |
+| Q | 待确认问题 | 第7节；正文可用【待确认 Q-xx】 |
+| E | 取证记录 | 附录 A；正文「依据」列引用 |
+| M | 消息 | 第5节消息表 |
+
+不使用旧编号：`REQ` / `BR` / `EV` / `TC` 等。
+
+## 字段写法
+
+- 用**业务名**，就地写清：类型、必填、取值来源与格式、空值含义。
+- 同一字段在不同位置格式不同时，各自写清换算。
+- 不发明跨文档人造字段键（field/source/action/…）。
+
+## 规则与验收
+
+每条 R 必须有：条件 / 结果 / 异常 / 依据 / 验收（至少一个 T）。
+每条 T 必须有：前置 / 输入 / **可核对**的预期（不是「成功」）。
+依赖未关闭 Q 的用例：预期写清当前建议值，并标注「依赖 Q-xx；结论变化则本用例失效」；必要时标【阻塞】。
+
+## 依据列
+
+- 系统取证 → `E-xx`
+- 业务口述 / 会议确认 → 写「需求确认（日期或场合）」，**不要**伪装成 E
+- 未核实建议 → 标【建议】
+
+## 标记
+
+- 未知：【待确认 Q-xx】
+- 不适用：【不适用：原因】
+- 建议未确认：【建议】
+
+## 增强类章节分工
+
+- 第2节：业务流程**整体**现状（含未改变部分）
+- 第3节：只写**本次改变**的动作
+
+## 证据
+
+证据在附录 A（查了什么 / 结果 / 限制与结论）。正文引用编号，不把证据详情塞进第2/3节。
+修订历史：默认**不**进 FS 正文（版本由交付/流转平台承载）。若项目要求文档内签署追溯，再加「修订记录」小节——需产品确认后启用。
+
+## 页脚
+
+可保留 `Generated by SapBuddy`。生成后删除模板顶部 `<!-- 写作约定 -->` 注释块。
+
+## HTML 与接口 JSON
+
+定稿后必须按 `archive-html.md` 产出无 logo 的 `FS.html`；接口类必须附样例 JSON（正文 + 独立文件）。

package/skills/sap-fs/references/grilling-integration.md

@@ -0,0 +1,26 @@
+# 与 grilling 集成
+
+## 怎么加载
+
+1. 需要追问业务决策时：用 Skill 工具加载 **`grilling`**（用户说 grill me / 拷问 / 追问决策时同样加载它，不再经别名）。
+2. 若宿主无法加载技能：在对话中**按 grilling 合同**执行（设计树、按 frontier 分轮、每问带推荐答案），并在答复里说明已降级。
+3. 不要把 grilling 全文复制进 FS；不要在 sap-fs 内另写一套追问算法。
+
+## 问什么 / 不问什么
+
+- **问**：业务决策（阈值、含税口径、是否阻断、覆盖哪些入口、排除哪些场景…）。
+- **不问**：能从系统查到的事实（表名、字段、现有逻辑）——先取证。
+
+## 与 FS 编号的映射
+
+| grilling 结果 | 写入 FS |
+| --- | --- |
+| 用户确认的决定 | 落到对应 R / 第3节字段，依据写需求确认 |
+| 用户说不知道 | `Q-xx`，继续做不依赖部分 |
+| 推荐答案被同意 | 可写入正文；若仍弱确认可标【建议】直至正式确认 |
+
+每轮结束后把已定决策写回草稿结构，避免只留在对话里。
+
+## 停止条件
+
+grilling 的 frontier 为空，且用户确认已达成共识 → 再进入生成与自检。未确认前不假装 FS 已定稿。

package/skills/sap-fs/references/review-checklist.md

@@ -0,0 +1,13 @@
+# 交付前检查
+
+1. 每条 R 有条件 / 结果 / 异常 / 依据 / 验收，且可判真假。
+2. 每个 T 有前置、输入、可核对预期；依赖 Q 的用例已标注依赖/阻塞。
+3. 每个 Q 有「谁来定」和「影响哪条规则」；状态行待确认数 = Q 条数。
+4. 每条 E 有限制；正文引用的 E 都存在；口述依据未伪装成 E。
+5. 第2节与第3节不矛盾；未改变部分写明保持原样。
+6. 无残留 `<...>` / `{{...}}` 槽位（示例文件里的尖括号示范也不得出现在交付稿）。
+7. 无训诫句；无旧编号；有 M 时与消息表一致。
+8. 查询/功能报表写了「实现方式与取舍」（标准功能 vs 自建）。
+9. 未授权任何 SAP 写入；落盘路径在允许范围（默认 `output/fs/...`）。
+10. 已产出 `FS.html`，无 logo、无 `{{...}}` 占位符。
+11. 接口类：正文 3.6 与 `io-request.json` / `io-response.json` 一致且可解析。

package/skills/sap-fs/references/system-verification.md

@@ -0,0 +1,30 @@
+# 系统取证
+
+## 连接
+
+1. 连接不明确 → 先 `get_connected_systems`。
+2. 用户已指定 → 只用指定连接，不要默认第一个。
+3. 切换连接后 → 再次 `get_connected_systems` 确认后再查。
+
+## 可用工具（只读）
+
+`get_sap_system_info`、`search_abap_objects`、`get_abap_object_info`、`get_abap_object_lines`、`execute_data_query`、`read_table_contents`、`find_where_used`。
+
+查询限定组织、日期与字段；只取少量样本。返回行数上限 ≠ 扫描范围小。
+
+## 记录四种状态
+
+已取得 / 零行 / 部分取得 / 失败。
+
+- 零行 ≠ 对象不存在
+- 失败 ≠ 没有该功能
+- 字段存在 ≠ 逻辑可用
+- 对象存在 ≠ 调用时点与入口已验证
+
+每种限制写进附录 E 的「限制与结论」。
+
+## 边界
+
+- 本流程不创建、不激活、不修改 SAP 对象。
+- abap_wiki / 知识库仅作定位；必须与系统查询分开标注。
+- 未核实的对象名标「候选，待验证」，写入 E 或 Q，不写进已确认口径。

package/skills/sap-fs/references/types/enhancement.md

@@ -0,0 +1,21 @@
+# 类型：增强
+
+**判定**：在现有流程某时点补充或改变行为。
+
+## 取证重点
+
+- 入口事务/接口、候选增强点调用时点（未验证则 E + Q）
+- 相关字段与标准校验是否已覆盖部分规则
+- 其它增强是否改同一字段
+
+## 追问方向
+
+- 覆盖哪些入口（前台/后台/接口）
+- 命中与排除条件、优先级
+- 停用后与在途、回归范围
+
+## 专项检查
+
+- 模板：`assets/templates/enhancement.md`
+- 第2节整体现状 vs 第3节只写本次改变
+- 详略对照：`references/example-enhancement.md`

package/skills/sap-fs/references/types/functional-report.md

@@ -0,0 +1,22 @@
+# 类型：功能报表
+
+**判定**：会改变业务状态（创建、过账、审批、重处理等）。
+
+## 取证重点
+
+- 候选对象与可处理状态
+- 现有校验/锁定/日志
+- 标准功能能否覆盖
+
+## 追问方向
+
+- 执行单元与部分成功策略
+- 重复判定键（不能用每次新批次号）
+- 结果未知时的核对顺序
+- 试运行能力边界
+
+## 专项检查
+
+- 模板：`assets/templates/functional-report.md`
+- 3.2 表有实际字段行（非空表头）
+- 实现方式与取舍已写

package/skills/sap-fs/references/types/interface.md

@@ -0,0 +1,27 @@
+# 类型：接口
+
+**判定**：数据在系统之间进出。
+
+## 取证重点
+
+- 现有接口对象、消息结构、日志与对账表（若有）
+- 业务键、增量水位、重复请求处理线索
+- 候选技术对象标「待验证」
+
+## 追问方向（交给 grilling）
+
+- 成功标志：传输到达 / 已受理 / 业务完成 各自证据
+- 全量 vs 增量、迟到与空批次
+- 部分成功原子单元、超时后如何核对再重试
+- 对账键、容差、责任方
+
+## 专项检查
+
+- 第3节用 `assets/templates/interface.md`
+- 结论层次不得互相替代
+- 备选方案与取舍已填写（无则写「无」）
+
+## 归档
+
+- 必出 3.6 样例 JSON，并写 `io-request.json` / `io-response.json`。
+- HTML 中原样收录样例，无 logo。

package/skills/sap-fs/references/types/query-report.md

@@ -0,0 +1,21 @@
+# 类型：查询报表
+
+**判定**：只读；筛选、展示、导出。若操作会改业务状态 → 改用功能报表。
+
+## 取证重点
+
+- 来源表/视图、关联基数、排除状态
+- 选择条件与权限相关字段
+- 标准报表/事务能否覆盖（写入「实现方式与取舍」）
+
+## 追问方向
+
+- 一行代表什么、业务唯一键
+- 空条件含义、最小筛选范围
+- 币种/单位/舍入与对账依据
+- 数据量与时效上限
+
+## 专项检查
+
+- 模板：`assets/templates/query-report.md`
+- 一对多关联后金额是否重复放大已说明