---
name: kd-grill
description: >
  金蝶需求拷问与编码前澄清，产出结构化需求摘要、可选 CONTEXT/ADR，并联动元数据只读连库查询。
  Use when: 开发、实现或修改金蝶插件、表单、列表、操作、对接，且需求需对齐产品线与形态。
  Do not use when: 用户要求跳过澄清；事实已齐可直接进入产品 skill；非金蝶项目（用 requirement-analysis）。
---

# kd-grill — 金蝶需求拷问

编码前对齐需求与证据，降低字段与形态错误。

- 领域手册：[../_shared/kd-domain-manual.md](../_shared/kd-domain-manual.md)
- 元数据查询：[../_shared/metadata-db-query.md](../_shared/metadata-db-query.md)
- 通用契约：[../_shared/api-surface-contract.md](../_shared/api-surface-contract.md)
- 企业版形态：[../_shared/enterprise-plugin-shape.md](../_shared/enterprise-plugin-shape.md)

## When / Do not

**Use when**：新的金蝶交付或二开需求；需对齐产品线、插件类型、事件与字段。  
**Do not use when**：用户要求直接实现且跳过澄清；事实已齐；非金蝶项目。

## Input / Output

| Input | Output |
|-------|--------|
| 用户需求、项目画像 | 结构化摘要；可选 CONTEXT/ADR；字段证据或显式假设 |

## Steps

```
- [ ] 1. 读 project-context 产品画像与已有 CONTEXT/ADR
- [ ] 2. 结构化：产品线 / 生命周期位 / 插件类型 / 事件 / 目标单据
- [ ] 3. 读 api-surface-contract（访问位 + API 面）
- [ ] 4. 涉及字段时按 metadata-db-query：
        · 有连接 → 只读 SQL → LLM 解析
        · 无连接 → **向用户索取**主机/库名/只读认证（企业版与旗舰相同）
        · 用户跳过查库 → 字段标 assumption
- [ ] 5. 术语或边界不清 → kd-domain-modeling；重大决策 → ADR
- [ ] 6. 进入产品 skill 实现
```

## 与元数据查询的分工

| kd-grill | metadata-db-query |
|----------|-------------------|
| 产品线、生命周期、事件、业务单据 | 连接信息、只读 SQL、LLM 解析字段 |
| 不编造 SDK | 不替代形态选型；**非 MCP** |

流程：`grill 对齐 →（问连接）→ 连库解析 → 产品 skill 写码`。

## 失败策略

| 情况 | 动作 |
|------|------|
| 产品线不明 | 按画像假设并标注，或简短确认 |
| **无库连接信息** | **先问用户**，不假装已验证 |
| 用户跳过查库 | 记录假设后实现 |
| 库不可达 | 摘要列出待验证字段 |

## 验证

- [ ] 产品线、生命周期、事件已确认或已标注假设
- [ ] 字段：已只读连库解析，或已标 assumption，或已向用户索取连接
- [ ] 未将未证实的 SDK / 字段当作事实