SuperAPI AI 工具集

user-stories

通用与其它

查看项目

更新于 10-15 21:41

技能介绍

用途:分析代码库,将目标拆解为小型、原子化、可实施的用户故事,仅做分析与规划,不实现任何代码。适用于规划新功能、估算工作量等场景。

主要能力:用 Glob/Grep/Read 探索代码库的架构、模式、框架与相似既有功能;把目标拆解为 3–10 个原子用户故事,每个可在一个编码时段(最多 2–4 小时)完成;按技术与逻辑依赖排序;为每个故事估算复杂度(XS 小于1小时单文件、S 1–2小时、M 2–4小时、L 4–8小时、XL 需进一步拆分);生成文件名并把计划写入 .context/[slug]-plan.md,默认 JSON 格式,也可用 --format=gherkin 输出 BDD 风格。

使用方式:若 $ARGUMENTS 为空,会询问要拆解的目标,并提示可加 --format=gherkin;否则提取目标与可选格式标志(--format=json 为默认,或 --format=gherkin)。格式无效时提示使用 --format=json 或 --format=gherkin。文件名由目标生成 kebab-case slug:去掉冠词,保留 3–5 个关键词,小写、空格转连字符并追加 -plan.md,保存到 .context/ 目录(不存在则创建)。

限制与错误处理:目标过于模糊时先要求澄清范围;目标过宽(超过 10 个故事)建议拆成多个计划;未找到相关代码库模式时在 Context Summary 中说明并从头规划;故事过大(XL 及以上)先拆成子故事;少于 3 个故事时确认粒度是否足够。Gherkin 输出必须为英文,与输入语言无关。