AGENT SKILL

specdev-g-grill-with-docs

针对已界定需求中的产品、领域、架构和验收取舍开展聚焦访谈,并记录真实决定与理由。

License 许可
MIT
所属仓库
NAMEWTA/Speculo
最近更新
2026-11-13
Stars
★ 2
Forks
0

01 前言 Front Matter

name
specdev-g-grill-with-docs
description
针对已界定需求中的产品、领域、架构和验收取舍开展聚焦访谈,并记录真实决定与理由。

03 SKILL.md 正文

需求细化与决策访谈

读取当前需求、相关设计、代码和已有决定,先列出真正会改变实现的缺口。代码、配置和资料能回答的事实先查,不把工程调查转成对用户的长问卷。

找出高价值问题

围绕核心使用场景、成功标准、范围、领域概念、异常行为、权限与数据演变,寻找互相冲突或尚未确定的决定。技术选择只在影响公共行为、成本、兼容性或重要风险时进入访谈;局部可逆实现细节由工程判断完成。

每个问题交代情境、可行选择、推荐及其代价。相关问题可以集中呈现,用户需要一步步讨论时再逐个推进;不固定轮数、题数或问完所有分类。

涉及故障与异步行为时,查清何时算成功、结果未知如何核对、哪些操作能重试、取消后哪些效果可能已发生。涉及工具与 Agent 时,区分模型判断、宿主权限、工具执行和真实系统结果。

保存共识

在现有 release 记录中写清采用的决定、原因、实际考虑过的替代、适用范围和待验证假设。保留用户回答的必要原文或来源,不将模型推荐写成用户批准。

领域术语尽量与代码和用户语言一致。同名不同义或不同名同义会影响接口和数据时,先明确概念边界;需要系统建模时阅读 研究与领域建模。

新回答改变早先决定时说明变更及受影响内容;不靠追加多个互相矛盾的“最终版”维持表面完整。重大、跨交付仍有效的决定可按持久化规则写入 ADR,其余保留在当前记录。

结束与继续

足以实施的范围已明确即可结束。无法回答的高影响问题写清它阻塞什么、如何取得证据;其他独立部分继续推进。

体验方向尚待验证时先做 原型,已讨论清楚则整理 Spec。不为共识生成设计树 JSON、固定日志表或额外交接包。

04 同仓库更多 Skills