SuperAPI AI 工具集

living-docs-navigator

写作与研究

查看项目

更新于 10-15 19:56

技能介绍

用途:在实现功能或做设计决策前,从 .specweave/docs/internal/ 读取相关活文档作为上下文,避免与既有决策或规范冲突。技能本身遵循渐进式披露:初始只加载元数据(约200 tokens),再按需搜索和读取具体文件,无需 RAG,直接使用 Claude 原生文件读取。

主要目录:specs/ 存放功能规格与用户故事、验收标准、实现历史;architecture/adr/ 存放架构决策记录(含决策原因与权衡);architecture/ 存放高层设计、系统图与组件架构;operations/ 存放运行手册、SLO、事故流程;strategy/ 存放业务需求、产品愿景与 PRD;governance/ 存放安全策略、编码标准与合规文档。

使用方式:用 ls 列出目录,例如 ls .specweave/docs/internal/specs/;用 grep 按关键词查找,例如 grep -ril "keyword" .specweave/docs/internal/specs/、grep -l "topic" .specweave/docs/internal/architecture/adr/*.md;再读取找到的文件。执行 /sw:do 时,可从 spec.md 提取主题关键词、搜索活文档、读取相关 ADR 与架构文档并在实现中应用。按角色导航:业务相关方可看 strategy/ 下的 executive-summary.md、feature-dashboard.md、roadmap.md 等;技术负责人可查 ADR 与架构文档;产品经理可看 specs/ 与 increments 元数据。也可用 stakeholder-docs 技能生成高管摘要等。图表可在 Markdown 中使用 Mermaid,插图可用 /sw:image-generation(品牌色 Purple #7c3aed、Light purple #a78bfa)。

限制:资料未提供收费、平台支持、安装步骤及具体效果信息;该技能依赖项目已存在相应文档目录结构。