SuperAPI AI 工具集

product-vision-steering

办公与效率

查看项目

更新于 10-16 02:39

技能介绍

用途:产出并维护三份长期指导文档,作为项目的“宪法”,供下游规格、待办事项与实现引用;由 ol-sdd-workflow 编排器在 Phase 0 调用,或由用户直接调用进行初始化或刷新。

主要能力:生成 documentation/steering/product.md(产品愿景:目的、用户、关键功能、目标、指标、原则、约束、范围)、tech.md(技术栈:语言、框架、库、工具、部署、允许清单、SDD 工作流后端即 tracker 与 docs)、structure.md(项目结构:目录布局、命名约定、测试位置、技能路由)。文档会通过 docs 适配器发布到 Confluence、Notion、ADO Wiki 或本地文件。

使用方式:Step 1 检测现有状态(是否已有 steering 目录与文件、识别清单文件如 package.json、pyproject.toml 等);Step 2 分析项目(语言版本、框架依赖、目录结构、命名风格、测试框架、CI/CD,无法核实的细节需标记未知);Step 3 收集产品上下文(问题、用户、核心功能、目标、6 个月成功指标、原则约束);Step 4 填充三份模板,tech.md 需记录 tracker(jira|linear|ado|local)与 docs(confluence|notion|ado-wiki|local),优先级为编排器传入模式、workflow-config.md、否则询问用户并持久化;Step 5 逐份呈交用户审批;Step 6 获批后写入并发布,远程后端需提供 space key/父页面 id 等配置。

适用场景:新项目初始化指导文档、产品转向、技术栈重大变更、项目结构重组,或新成员加入时发现既有指导文档有误导。

限制:不设计功能(属 feature-spec-author)、不做功能级架构决策(属 software-architect)、不产出本体模型、不定阶段路线图。次要漂移(新增库、重构)不应触发刷新。已提供模板位于 references/templates/,镜像副本位于 prompts/coding/templates/ 需保持同步。具体安装命令、价格与平台支持暂未提供。