用途:该技能用于为某个网页平台功能识别并定义用例(use cases),是创建新指南三阶段中的第一阶段(第一阶段识别用例,第二阶段撰写指南,第三阶段评估指南)。用例描述的不是功能本身,而是用户想实现的任务或要解决的问题,功能只是推荐解决方案的一部分。
主要能力与要求:以动词开头的单句描述任务,聚焦 WHAT 而非 HOW,不在描述中提及 API 方法、属性或功能名。每个功能建议 2-5 个不同用例,剔除小众用例,能合并的合并,复杂功能应拆分。需避免与同一领域已有指南重叠,按 web-feature-id 检索现有指南与 PR。分类按用例目标而非实现技术划分,指南放在 guides/ 目录下。
使用方式:第一步写动作导向描述(最长 1024 字符、单句、动词开头);第二步选择高层分类目录;第三步在 guides/<category>/ 下创建短 slug 子目录(slug 不加 create-、build-、add- 等动词前缀);第四步创建含 YAML frontmatter(name、description、web-feature-ids)的 guide.md 占位文件;第五步创建 expectations.md 占位文件;第六步运行 gd dev guides/<category>/<guide> 生成评估 capsules;第七步运行 pnpm --filter guides test 校验结构;第八步提交含 guide.md、expectations.md 与 targets/ 的 PR 接受评审。领域级指南应拆成细粒度子技能,主指南作为概念枢纽,用 {{ GUIDE_REF("guide-slug") }} 宏链接。
适用场景与限制:适用于按 RAG 检索系统提供指导的 Web 平台功能指南编写与评审工作流。其具体安装方式、收费与价格等信息暂未提供。