Documentation-Accurate Code Generation

📚 文档驱动的零幻觉代码生成

强制文档优先的代码生成技能,通过预加载API文档、提取真实签名、验证生成结果,彻底杜绝LLM幻觉导致的代码错误

收藏
4.7k
安装
1.3k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

doc-accurate-codegen 是一个防御性编程技能,强制要求在生成任何代码前必须先加载并解析官方文档。工作流程遵循七步闭环:识别需求→定位文档→加载解析→提取API签名→生成代码→验证匹配→记录引用来源。支持 OpenClaw 内部文档、外部工具文档、API 官方文档及代码示例库四类来源。

显著优点

1. 零幻觉承诺:通过"文档优先"原则,从机制上杜绝 LLM 编造不存在的 API 方法、参数或配置项
2. 全链路验证:生成后对方法名、参数名/类型、返回值、错误处理、配置格式进行五维校验

3. 可追溯性:强制记录文档来源、API 版本、验证时间,便于后续维护与审计

4. 多源交叉验证:支持同时比对官方文档、OpenAPI 规范、实际代码示例,自动识别冲突

5. 持续集成友好:可与 readweb_fetchexec 等工具链深度集成,自动化获取最新文档

潜在局限

  • 冷启动延迟:必须等待文档加载与解析,无法像纯内存生成那样即时响应
  • 文档依赖风险:若目标 API 文档缺失、过时或存在错误,技能会传递这些缺陷
  • 网络与权限要求:依赖 BRAVE_API_KEYcurlgit 等外部二进制,离线场景受限
  • 复杂 API 解析成本:非结构化文档(如纯 HTML)的签名提取可能不够精准

适合人群

  • 需要生产级代码质量的开发者(尤其金融、医疗等高合规场景)
  • 使用易变 API(如云服务、SaaS 平台)的工程师
  • 缺乏特定领域经验、无法凭记忆判断 API 正确性的用户
  • 团队协作中需要统一代码生成标准的场景

常规风险

  • 文档版本滞后:官方文档可能未同步最新发布,建议结合 API 变更检测功能
  • 过度约束:严格验证可能拒绝某些文档未明确但实际有效的用法
  • 环境配置泄露BRAVE_API_KEY 等敏感配置需妥善保管,避免提交至版本控制

Documentation-Accurate Code Generation 内容

手动下载zip · 4.9 kB
skill-card.mdtext/markdown
请选择文件