写作与公文
用 Antithesis 文档回答产品/工作流/集成问题时…
当需要回答关于 Antithesis 平台的产品、工作流或集成问题时,通过 snouty docs 或直接抓取 markdown 文档来获取权威信息并给出有出处的答案。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
用 Antithesis 文档回答产品/特定
解决思路
- 优先使用 Antithesis CLI(名为 snouty)在命令行访问文档,先运行 `snouty docs --help` 了解用法。
- 如果缺少 snouty:1) 告知用户 snouty 是 Antithesis CLI;2) 给出安装来源 `https://github.com/antithesishq/snouty`;3) 询问用户是否希望代为安装,若同意则按 `https://raw.githubusercontent.com/antithesishq/snouty/refs/heads/main/README.md` 中的说明操作;4) 安装完成后重新运行 `snouty --help`。
- 在给出详细指导前,先用 `snouty docs` 发现权威的 Antithesis 文档,并查看 `snouty docs --help` 了解子命令和用法示例。
- 推荐检索流程:1) 先用 `snouty docs tree --depth 2` 快速浏览文档结构;2) 知道大致领域但不确定具体页面名时用 `snouty docs tree <filter>` 探索该部分;3) 用 `snouty docs search <terms>` 查找特定主题的可能页面;4) 只想看页面路径时用 `snouty docs search -l <terms>`;5) 知道路径后用 `snouty docs show <path>` 阅读完整 markdown 页面;6) 在回答中引用相关文档页面。
- 注意细节:`snouty docs show` 接受如 `using_antithesis/sdk/go` 的页面路径;也接受 `/docs/.../` 风格路径并会尝试规范化;关于更新文档失败并回退到缓存文档的警告通常无害,尤其在无网络沙箱中,只要仍返回所需内容就视为非致命;`snouty docs sqlite` 会打印包含全部 Antithesis 文档的本地 SQLite 数据库路径,可用于直接查询文档。
- 如果 snouty 不可用,可直接从 `https://antithesis.com/docs/` 抓取 markdown 页面:先加载 `https://antithesis.com/docs/llms.txt` 获取所有 markdown 页面的纯文本索引。
- 请求 `https://antithesis.com/docs/` 下的文件时始终加上 `.md` 扩展名,例如 `https://antithesis.com/docs/reference/sdk/go/` 变为 `https://antithesis.com/docs/reference/sdk/go.md`,`/reference/sdk/go/` 变为 `https://antithesis.com/docs/reference/sdk/go.md`。
- 例外情况:带明确文件扩展名(如 `.txt`、`.js`、`.so`)的 URL 保持原样;`docs/generated/...` 路径按原样请求。
- 向用户展示链接时优先使用普通 HTML 页面 URL 而非 `.md` URL;如需直接链接到某小节,尽量使用 slug 化标题的 fragment,若不确定 slug 则链接整页并明确说明小节名称。
- 输出要求:给出关于 Antithesis 行为、SDK、设置和最佳实践的清晰且有依据的回答,附上所用文档页面的相关链接;若缺少 snouty 命令,询问用户是否要安装,并说明它是用于操作 Antithesis API 和文档的 CLI。
- 完成前自审:重新阅读本指南并逐项检查——回答中每个事实性论断都基于通过 `snouty docs` 或直接 markdown 抓取获得的特定文档页面;包含文档页面链接以便用户核实来源;未混淆不同页面的概念或添加源材料中不存在的内容;若文档含糊或未涉及某点,应如实说明而非用假设填补。
- 避免在回答中混用不同页面的概念或添加源材料中不存在的内容。
- 若文档含糊或未涉及某点,应如实说明而非用假设填补。
适用边界 · 注意事项
- 需要先安装 snouty(Antithesis CLI)才能使用其文档检索功能;若无法安装则只能走直接 markdown 抓取回退方案。
- 直接 markdown 回退依赖 `https://antithesis.com/docs/` 的可访问性,无网络环境下不可用。