SuperAPI AI 工具集

wtf.steer-vision

写作与研究

查看项目

更新于 10-16 02:05

技能介绍

用途

wtf.steer-vision 用于生成或完善 docs/steering/VISION.md,即“产品宪法”。该文档是最高层级的指导性产物,记录产品为何存在、服务哪些用户,以及指导每一项决策的原则。

主要能力

该技能遵循共享的 steering-doc 流程:存在性检查 → 研究 → 访谈 → 起草 → 评审 → 写入 → wiki 同步 → 继续。技能专属输入如下:

  • 文档路径:docs/steering/VISION.md
  • 模板:references/vision-template.md
  • 显示名称 / wiki 页面:WTF-Vision.md
  • 提交信息:docs: add project vision steering document

使用方式

第 2 步 — 研究清单

使用 Agent 工具并行运行:

代码库信号:

  • README 中的产品描述和既定目标
  • 任何现有的 docs/ 文件、ADR 或架构说明
  • 文件名、模块名和类型定义中的领域语言
  • 现有的 wiki 页面或术语表文件

GitHub 信号(可选 — 不可用时跳过):

  • 开放和已关闭的 Epic 以了解战略意图 — 按 ../references/issue-classification.md 中的 List issues of a kind 查询(kind Epic)列出
  • 任何引用产品目标或原则的 issue 或 discussion

在内部综合。不要向用户倾倒原始研究内容。

第 3 步 — 缺口主题列表

仅询问研究无法确定的事项,按优先级顺序。对于每个未回答的事项,调用 AskUserQuestion(依据 ../references/questioning-style.md):

  • 产品目的 — 问题:“这个产品解决什么问题,为谁解决?” / 标题:“Product purpose” / 选项:用从 README 或代码库推断的目的陈述预填。
  • 目标用户 — 问题:“主要用户是谁?使用他们的领域角色名称。” / 标题:“Target users” / 选项:用从代码库推断的具名角色预填。
  • 核心原则 — 问题:“指导每一项产品决策的 3–5 条原则是什么?” / 标题:“Core principles” / 选项:用从 CLAUDE.md 或 README 推断的原则预填。
  • 战略目标 — 问题:“12–18 个月后成功是什么样子?” / 标题:“Strategic goals” / 选项:用从开放 Epic 或 README 推断的目标预填。
  • 限界上下文 — 问题:“这个产品跨越哪些领域上下文?” / 标题:“Bounded contexts” / 选项:用从模块结构或 Epic 词汇推断的上下文预填。
  • 范围之外 — 问题:“明确不在范围内的是什么?” / 标题:“Out of scope” / 选项:用现有文档或 issue 讨论中发现的排除项预填。

第 4 步 — 写作规则

在编写任何持久正文之前,依据 ../references/ste-writing.md 应用严格的 STE(共享流程第 4 步也要求这样做)。

  • 每个句子都使用领域语言 — 领域专家和利益相关者使用的词语。
  • 目标用户是具名的领域参与者。绝不写“users”或“admins”。
  • 战略目标是业务成果。它们不是功能或技术工作项。
  • 限界上下文名称与代码库中发现的词汇保持一致。

第 8 步 — 继续选项

  • {label: "Create TECH.md", description: "Run wtf.steer-tech to document the technical guidelines"}
  • {label: "Create DESIGN.md", description: "Run wtf.steer-design to document the design guidelines"}
  • {label: "Create QA.md", description: "Run wtf.steer-qa to document the QA standards"}
  • {label: "Stop here", description: "Exit — no further action"}

适用场景

当团队需要创建或完善项目愿景文档时使用,例如“创建愿景文档”“撰写我们的产品愿景”等。

限制

关于收费、价格、平台支持等具体信息,资料中暂未提供。