用途:在产品仓库中创建或更新用户故事(US),使之标准化。功能文档README.md记录用户价值、业务规则、验收标准与进度状态;实现细节(DTO、端点、schema)放入docs/product/technical-docs/或TK-XXX任务,不写入故事叙述。
主要能力:使用references/user-story-template.md作为模板;业务规则按RN-01、RN-02编号并用RFC 2119规范关键词(DEBE、NO DEBE、DEBERÍA等)大写书写;验收标准用Gherkin格式(DADO/CUANDO/ENTONCES或GIVEN/WHEN/THEN,大写);提供INVEST与Definition of Ready两类校验表;故事点为Fibonacci值1、2、3、5、8、13并附理由。
使用方式:必须在该技能规定下通过docs-specialist子代理执行,不可直接运行。文件位于docs/product/user-stories/US-XXX-[nombre-corto]/README.md,支持文件放assets/,命名用US-XXX加kebab-case短名。创建前须确认ID无重复、无范围重叠;仅有演员与业务价值即可创建为Draft,Ready需全部数据齐备。若需创建任务,必须调用/story-plan,不能直接建TK-XXX。
适用场景:产品需求梳理、用户故事文档化与更新、UI类故事需Figma等设计参考。限制:缺失信息须询问用户,不得编造业务规则;无验收标准或UI设计参考时不得标记Ready;UPDATE时若TK-XXX与US冲突以US为准。具体收费、平台与效果暂未提供。