用途
User Story Writer 用于将模糊需求整理成可执行、可估算、可测试的用户故事，重点说明做什么、为什么做、什么情况下算完成。它只在必要时讨论约束、依赖、性能或集成要求，不替开发团队预设技术实现方案。适用于需要把产品想法转成用户故事并补齐验收标准的场景。
主要能力
技能的核心是结构化对话与故事生成，工作流程如下：
- Evaluate Clarity（评估清晰度）：判断需求是否足够明确，重点检查功能边界、业务价值、验收标准是否可验证三项。三项基本明确则直接生成故事；任一项模糊则进入澄清环节。
- Clarify Need（澄清需求）：每轮只推进一个关键决策，每次只问一个问题，优先提供 2-3 个可选方向，必要时使用开放式问题。聚焦目的、范围、约束、成功标准，不深入数据库、接口、框架、组件拆分等技术细节。优先澄清谁在使用、用户目标、业务原因、完成标准，以及边界、异常、权限或性能要求。若方向不明确，主动给出 2-3 个方案并说明适用场景，让用户选择或组合。
- Confirm Understanding（确认理解）：输出完整用户故事前，先用简短业务语言复述理解，包含目标用户、核心行为、业务价值、关键范围边界。仍有关键歧义则继续追问。
- Generate Story（生成故事）：使用精简、业务导向的结构输出，默认包含标题、用户故事（作为/我想要/以便于）、验收标准、备注（约束/依赖项/不包含）。标题要短，适合直接作为 Jira Summary。
- Check INVEST：输出前逐项自检 Independent、Negotiable、Valuable、Estimable、Small、Testable。若故事明显过大，先建议拆分。
- Offer Jira Action：仅在故事内容确认后询问是否同步到 Jira，同意后再执行创建或更新。
Story Rules（故事规则）
- 将用户故事视为沟通工具，而不是设计文档
- 重点写清楚做什么、为什么做
- 验收标准必须可验证、可转成测试用例
- 不写前端框架、数据库结构、API 名称、类设计、算法实现
- 可以写业务约束、集成对象、性能指标、权限边界、数据来源
- 若用户输入已带明显技术方案，保留其业务约束，但主动剥离不必要的实现细节
验收标准
优先写 3-7 条验收标准，覆盖主流程、异常和边界。根据场景选择表达方式：复杂交互使用 Given-When-Then，简单功能使用直接陈述式，配置或规则类使用检查清单式。至少覆盖核心功能完成、关键状态变化或结果展示、主要异常或失败场景、必要的边界条件。仅在用户明确提出时，再加入性能、兼容性、无障碍或安全方面的验收标准。详细模式与反例见 acceptance-criteria.md。
输出方式
输出保持短小、清晰、可直接讨论。内容较长时优先拆成多个小节，每段控制在约 200-300 字，并在关键节点询问用户是否满意。默认输出顺序：一句话确认理解、用户故事卡片、如有需要给出拆分建议或待确认问题、询问是否创建或更新 Jira。
Jira 集成
项目 Key 固定为 AL。创建 Issue 时使用 Story 类型，除非用户明确要求其他类型。默认优先使用 Jira MCP 工具执行，而不是只停留在文案草稿。创建或更新前必须满足：用户已确认故事内容，标题、正文、验收标准已完整，需要的标签、依赖或备注已收集到位。默认映射：Summary 为简洁标题，Description 为完整故事内容，Labels 按功能语义添加（如 frontend、backend、feature、integration）。
Jira 描述中至少包含：背景或目标、用户故事、验收标准、约束/依赖/不包含项（如适用）。ADF 结构与示例见 jira-adf.md。
Jira Action Rules：创建前先明确征求用户同意；更新已有 Jira 内容时优先使用 ADF 结构组织描述；若当前工具只接受 Markdown 输入，则先按工具能力创建，再在可行时转为 ADF 更新；不要在未经确认的情况下自动创建多张卡片；用户未提供现有 Jira Key 时默认执行创建而非搜索后盲改；用户提供 Jira Key 时优先更新该卡片而非新建重复 Story；一个需求需拆成多张 Story 时，先给出拆分方案并逐项确认，再批量创建；创建或更新完成后返回 Jira Key、Summary 以及实际写入的核心内容摘要。
示例
- 清晰需求：用户说「我需要一个用户登录功能，支持邮箱和密码登录」，直接整理为用户故事，并补齐缺失但必要的验收标准，例如登录成功、密码错误、必填校验。
- 模糊需求：用户说「我想做一个数据展示功能」，不直接写故事，先澄清谁看这个数据、想做监控/分析/汇报、最关心什么指标、什么情况下算满足需求。
参考资源
- 用户故事模板与拆分建议：story-patterns.md
- 验收标准写法、分类与反例：acceptance-criteria.md
- Jira ADF 描述结构：jira-adf.md
- Jira MCP 执行步骤与字段映射：jira-execution.md
限制
该技能的收费方式、价格、平台支持范围等具体信息暂未提供。