sapbuddy-dsh 0.0.7 → 0.0.9

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、无占位符、接口样例齐全。