---
name: kd-grill
description: 金蝶需求拷问 + ADR；与元数据只读连库查询联动。编码前攻破模糊点，字段以连库解析为准。
---

# kd-grill — 金蝶需求拷问（细则）

编码前澄清。领域手册：`../_shared/kd-domain-manual.md`。  
**元数据**：用 **只读 SQL 直连业务库**，步骤见 **`../_shared/metadata-db-query.md`**（LLM 解析三列）。


## 触发

用户说「开发/实现/改/加……」且含金蝶插件、表单、操作、报表等时，优先本技能。  
「简单加字段/修明确 bug」且事实已齐可跳过。用户说「直接写/别问」可跳过往返，但字段仍尽量查库或标假设。

## 工作流程

### 1. 读金蝶上下文

- `.trellis/spec/shared/project-context.md` → 产品画像  
- 已有 CONTEXT.md / docs/adr  
- 同目录同类插件风格  

### 2. 需求结构化（问用户）

```
产品线 / 插件类型与基类 / 目标事件 / 业务单据名称
约束：见 kd-domain-manual
```

示例追问：「审核时」是操作插件事务前还是表单 BeforeDoOperation？有没有界面？

### 3. 领域追问表

| 维度 | 示例 | 查什么 |
|------|------|--------|
| 插件类型 | 表单还是操作？有 UI 吗？ | domain-manual §2 |
| 生命周期 | 绑定前/后？事务内/外？ | domain-manual §3 + 产品 skill assets |
| **字段/FormId** | key 真假？三列？枚举？ | **`metadata-db-query.md` 只读 SQL + 解析** |
| 边界 | 批量？空数据？回滚？ | kd-delivery-rules |
| 异常 | 提示用户还是抛业务异常？ | 产品 skill |
| 规范 | 循环查库？吞异常？ | kd-coding-standards |

### 4. 元数据联动（在「单据可指向」之后立刻做）

1. 打开 `metadata-db-query.md`  
2. 按产品线选库（PG 业务库 / SQL Server 账套库）  
3. 按名称或 ID 查询 → 取 **FKERNELXML** 或 **fdata**  
4. **LLM 按手册规则解析**为 key / propertyName / fieldName（三标识）  
5. 写入 grill 摘要的「已验证字段表」；失败则「待验证/假设」  

**禁止**：跳过查库却在摘要写「字段已确认」。

### 5. 文档落地

读 `kd-domain-modeling.md`：术语 → CONTEXT；重大决策 → ADR。

### 6. 进入实现

摘要清晰后读 `ok-cosmic` / `kd-enterprise-csharp` / openapi 等。  
跳过往返确认时：在注释中标注假设后实现；可连库则补验证。


## 验证

- [ ] 产品线、插件类型、事件已确认或显式假设  
- [ ] FormId/实体：用户给定或库查  
- [ ] 字段：连库解析或显式假设（非口头中文名）  
- [ ] 未编造 SDK API