用途
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"}
适用场景
当团队需要创建或完善项目愿景文档时使用,例如“创建愿景文档”“撰写我们的产品愿景”等。
限制
关于收费、价格、平台支持等具体信息,资料中暂未提供。