用途:这是创建指南三阶段中的第二阶段(为某用例撰写指南),用于在编写或审查 guide.md 时提供最佳实践。
主要能力与工作流:真实编码智能体只会看到 guide.md(经 RAG 检索),因此它必须完全自包含,不能依赖 expectations.md、补丁或外部链接。作者与主题专家只负责撰写 guide.md 与 expectations.md,不手工编写 solution.patch、zero-passrate.patch、grader.ts 或 task.md;运行 gd dev <guide> 会在 /tmp 沙箱内围绕受支持基础应用自动生成并校准评估胶囊、跑评估并产出报告;运行 gd pr <guide> 会自动提交、推送、识别 PR 标签并创建 Pull Request。
必要用法:guide.md 开头须含 YAML 前置元数据,字段包括 name、description、web-feature-ids(须为 webstatus.dev 上的准确 ID,覆盖正文引用的全部特性;缺失时告知用户);待定特性用 tmp- 前缀并登记在 lib/pending-web-features.json;可用 draft 隐藏分发。正文用命令式语气、聚焦、简短,仅在关键约束处用 MANDATORY/DO/DO NOT;不写外部链接;代码片段要短且注释充分,注释须解释取值原因并标出仅为示例的占位值,JavaScript 只用 ES modules。实现步骤应优选最适合的特性,不为“新”而用新特性,不写跨浏览器回退(回退单独成节),只有真正必需才标 MANDATORY。回退节须针对非广泛可用特性给出推荐、说明回退体验,特性检测应限定在接口而非实例;回退优先级为自定义代码、polyfill、抽象库、优雅降级、渐进增强;polyfill 须按需条件加载,禁止 polyfill.io。构建期宏包括 BASELINE_STATUS、INCLUDE、FEATURE、FEATURE_FALLBACKS、FEATURE_ISSUES,回退节须为每个非广泛可用特性加入相应宏;重复的特性级内容可抽取到 features/<feature-id>.md。
限制:不得引用 demo.html 等文件;不输出 HTML;资料未提供具体平台、收费或价格信息。