Agent skill · wuchubuzai2018
haizei-ears-requirements
需求描述 EARS 改写与审查技能。Use when: EARS 需求改写、EARS requirement rewrite、EARS spec rewrite、EARS 规格改写、用 EARS 改写需求、把需求转成 EARS 规格、review EARS requirements、EARS 模式选择、需求规格消歧、验收标准改写、USDM SPEC 规格统一。解决的问题：把模糊需求改成可测试规格，补齐触发条件、状态条件、异常处理和功能开关，拆分一条需求中的多个动作，识别 should/can/supports/appropriately 等模糊表达，并输出模式判断、改写前后对照、拆分建议和待确认问题。
What it needs
About 2k tokens when loaded.
What this skill does
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 需要参考具体改写案例时 改写前 / 改写后示例 生产输出默认约定 对外输出需求规格时，默认使用中文句式，不输出 WHEN、WHILE、IF、THEN、WHERE、shall 等英文关键词。 英文 EARS 关键字仅用于模式讲解、分类说明、内部讨论或用户明确要求保留英文模板的场景。 改写结果默认使用“当…时”“在…时”“如果…，则…”“应”等中文表达。 如果需要同时给出模式解释和最终规格，先说明模式名称，再输出中文规格正文。 改写流程 快速改写流程 1. 识别原始语义：找出系统名称、动作对象、触发事件、状态条件、异常条件和约束信息。 2. 标记问题点：圈出模糊词、多动作混写、未量化约束、缺失主语和语义漂移风险。 3. 判断是否拆分：如果一句话里包含多个动作、多个异常场景或多个时序阶段，先拆成多条需求。 4. 进入模式路由：根据是否有事件、状态、功能开关或异常场景，选择对应 EARS 模式。 5. 执行改写：按模板输出规格，优先保留原始业务意图，不擅自补充业务规则。 6. 补足可测试性：尽量补出时间限制、次数限制、范围限制、失败处理和提示内容；缺失时列出待确认问题。 7. 按固定结构输出：给出模式判断、改写前后对照、拆分说明和审查意见。 判断与分支 如果原句同时表达“状态变化前”和“状态变化后”两个行为，应优先拆成两条，而不是直接保留复杂模式。 如果一句话里既有正常流程又有异常流程，应分别改写，不要写成一条混合需求。 如果无法明确“谁来做什么”，先补主语，再改写。 如果无法明确触发条件或响应动作，应停止硬改，转为输出待确认问题。 单独使用时 1. 接收 用户提供的模糊规格或需求。 2. 分类 使用模式选择指南，对每条陈述进行分类。 3. 重写 使用合适的 EARS 模板重写规格。 4. 校验 重写后的规格是否满足以下要求： 每条陈述恰好只包含一个 shall。 使用可衡量、可验证的语言。 不包含歧义黑名单词汇（参见 USDM 编写指南）。 EARS 关键字（WHEN、WHILE、IF、THEN、WHERE）必须全部大写。 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills wuchubuzai2018/haizei-ears-requirements