关于 grill-with-docs
通过访谈来完善计划或设计,并同步生成 ADR 和术语表条目的技能。适合希望在讨论过程中记录决策和领域术语的团队。
主要功能
- 01通过结构化访谈完善计划
- 02在讨论中创建 ADR
- 03添加术语表条目
- 04调用 grilling 和 domain-modeling 技能
适用场景
- 01在实现前澄清设计
- 02将决策记录为 ADR
- 03规划时整理领域术语
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ akillness/ jeo-skills --skill grill-with-docs安装后在 Claude Code 中输入/grill-with-docs确认已加载。
详细介绍
借助文档开展 Grill 访谈
通过持续深入的访谈来完善计划或设计,并在过程中创建文档(ADR 和术语表)。适用于 Grill 访谈还应留下 ADR 和术语表条目的场景。触发词:借助文档开展 Grill 访谈、开展 Grill 访谈并记录、对这个方案进行 Grill 访谈并编写 ADR。
此技能从 mattpocock/skills(MIT)导入,上游版本由用户调用。
何时使用此技能
- 通过持续深入的访谈来完善计划或设计,并在过程中创建文档(ADR 和术语表)。
- 适用于 Grill 访谈还应留下 ADR 和术语表条目的场景。
- 触发词:借助文档开展 Grill 访谈、开展 Grill 访谈并记录、对这个方案进行 Grill 访谈并编写 ADR。
说明
调用 Skill 工具两次,分别用于“grilling”和“domain-modeling”。
示例
- 先将此技能应用于一个范围较小的部分,确认输出符合上述形式,再扩展到整个任务。
- 如果某个步骤需要从代码库或环境中获取信息,请先查找,而不是询问用户。
最佳实践
- 保持上游流程不变;如有偏离,请明确记录,不要悄悄自行变通。
- 每当此技能标记由用户做出决策时,都应停下并将控制权交还给用户。
- 优先进行小规模、可逆的更改,并明确说明假设,不要将其隐藏起来。
参考资料
- 上游技能:
mattpocock/skillsskills/engineering/grill-with-docs/SKILL.md(提交3cca18b,MIT) - 项目规范:
.agent-skills/skill-standardization/SKILL.md - 验证脚本:
.agent-skills/skill-standardization/scripts/validate_skill.sh
评论
支持 Markdown