ysir-order

star 1

帮助在用户只给出一句泛指令时识别其真实意图。通过最小化追问收敛为可继续设计、规划或实施的结构化需求结果。

shflx By shflx schedule Updated 5/9/2026

name: ysir-order description: 帮助在用户只给出一句泛指令时识别其真实意图。通过最小化追问收敛为可继续设计、规划或实施的结构化需求结果。

需求梳理

目标

理清用户的需求内容。

核心原则

  1. 通过 ysir-configure 了解当前需求澄清策略,并按该策略执行。
  2. 先分析需求,再决定是否追问;重点找出用户遗漏或未提及、但会影响最终结果的要点。
  3. 不编造需求事实;无法确认但不阻塞的内容写入未确认点。
  4. 需求澄清开启时,以最小必要追问明确用户未提到且会影响需求文档、范围、验收或最终产物质量的要点;不限于阻塞项。
  5. 需求澄清关闭时,不追问;对缺失信息按合理默认处理,并把默认假设写入需求文档。
  6. 遵守 .report/design 设计文档;如遇需求与设计冲突,向用户确认并同步更新设计文档。
  7. 此阶段仅允许编辑文档,不允许直接开始编写代码。

工作流程

开展需求梳理前,先使用技能 ysir-regulation 学习项目规范。

0. 获取协作策略

先使用 ysir-configure 了解当前是否开启需求澄清。

1. 需求分析

先分析用户输入、设计文档和项目上下文,找出用户遗漏或未提及、但会影响需求正确性、范围边界、验收标准或关键实现判断的补充澄清问题。

这些问题不是模板字段清单,而是针对本次用户需求提出的追问或默认处理项。分析结果必须写入 order.md 的“需要理清的问题”,便于后续审计需求澄清依据。

2. 澄清处理

若需求澄清开启,对会明确影响需求文档、范围边界、验收标准、实现判断或最终产物质量的缺失要点进行追问;不要只追问阻塞项。

{问题}
{n}. {选项n}

要求:

  • 遵循上述模板
  • 每次问一个问题
  • 每次提问提供默认选项和自定义选项

若需求澄清关闭,不进行多轮追问;所有缺失要点按默认处理:

  • 对不阻塞实现的缺失信息,采用最符合现有设计、项目约定和用户目标的默认值。
  • 对存在多个合理选择的缺失信息,选择影响范围最小、最容易回退的默认值。
  • 将默认处理写入 order.md 的“关键上下文”或“范围与约束”。
  • 将仍可能影响后续判断的内容写入“未确认点”。

3. 文档产出

  • 文档模板: references/order.md

  • 默认输出路径: .report/in-progress/{日期}-{需求简短描述}/order.md

Install via CLI
npx skills add https://github.com/shflx/ysir --skill ysir-order
Repository Details
star Stars 1
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator