haizei-ears-requirements
Installation
SKILL.md
EARS 需求规格改写与审查
本技能用于基于 EARS(Easy Approach to Requirements Syntax,需求语法简易方法)将模糊、口语化或有歧义的需求改写为清晰、无歧义、可测试、可评审的规格陈述,并在需要时给出句式选择、拆分建议和校验意见。
以下模板中的关键字和 shall 保留原始英文写法,以确保 EARS 语法表达准确。
文件路由表
先判断当前任务属于哪一类,再按下表加载对应文件;不要默认把所有参考文档一次性读完。
| 文件 | 什么时候优先查看 | 主要内容 |
|---|---|---|
SKILL.md |
每次进入技能时都先看 | 触发词、主流程、模式路由入口、文件分工 |
references/ears-usage-guide.md |
需要判断是否适合使用 EARS,或了解使用场景、常见触发方式时 | 使用说明、适用场景、不适用场景、快速上手 |
references/ears-chinese-output.md |
需要对外输出中文需求,不希望出现 WHEN、WHILE、IF、THEN、WHERE、shall 等英文关键词时 | 中文输出约定、关键词替换、中文模板 |
references/ears-patterns.md |
不确定该选哪种 EARS 模式,或需要查看各模式细节和常见错误时 | 六种模式详解、示例、常见错误 |
references/ears-output-template.md |
需要统一输出结构、改写前后对照格式、待确认问题模板时 | 单条改写、多条拆分、审查模板、输出要求 |
references/ears-writing-rules.md |
需要检查写法质量、模糊词、可测试性和完成标准时 | 编写规则、处理策略、完成标准 |
examples/ears-examples.md |
需要参考具体改写案例时 | 改写前 / 改写后示例 |