zero-hallucination-coder

zero-hallucination-coder skill 概览

zero-hallucination-coder skill 是一套有纪律的 Code Generation 工作流，面向需要在真实仓库中改代码、且不能臆造 API、imports、文件路径或行为的 Claude 风格编码 agent。它最适合那些希望 AI 编码搭档在编辑前先检查、实现前先规划、修改后再验证的用户，而不是从一个模糊需求直接跳到写代码。

它解决什么问题

大多数编码幻觉都发生在模型默认假设项目结构、框架约定、依赖版本或未文档化行为时。zero-hallucination-coder 通过强制执行 Discuss → Map → Decompose → Execute → Verify 循环来降低这种风险。agent 会先澄清任务，映射现有代码，将工作拆解为具体步骤，只实现有依据的变更，然后再根据仓库检查结果。

当错误成本很高时，适合使用它：认证、数据库迁移、schema 变更、API 集成、有状态流程、多文件重构、对部署敏感的代码，或任何“可能正确”还不够的需求。

最适合的用户和任务

zero-hallucination-coder skill 适合已经有现有代码库、并希望更安全地借助 AI 完成实现的团队和个人开发者。尤其是在用户能够提供仓库访问权限、失败测试、日志、stack traces、issue 描述或明确验收标准时，它会更有价值。

它不太适合琐碎修改、快速格式化、一次性脚本，或速度比验证更重要的任务。这个 skill 刻意比普通 prompt 更“重”，因此只有当变更的风险或复杂度足以抵消设置成本时，才更值得使用。

核心差异点

关键差异不是“会写代码”；普通 AI prompt 也能做到。它的价值在于拒绝基于猜测的上下文继续推进。它强调经过验证的结构、不写 placeholder code、不臆造 imports，并在实现前以 YAGNI 风格删除不必要的工作。对于安装决策，需要注意：该仓库主要通过 SKILL.md 暴露工作流；没有需要配置的配套 scripts、rules folders 或 reference files。

如何使用 zero-hallucination-coder skill

zero-hallucination-coder 安装背景

源文件位于 alirezarezvani/claude-skills 中的 engineering/zero-hallucination-coder/skills/zero-hallucination-coder。如果你的 skill runner 支持从 GitHub 安装，可以使用该目录常规的 GitHub skill 安装流程，例如：

npx skills add alirezarezvani/claude-skills --skill zero-hallucination-coder

由于上游 skill 不包含 helper scripts 或额外资源文件夹，安装后主要需要检查的文件是 SKILL.md。先阅读 frontmatter description，了解 agent 应该在什么情况下触发它；然后再浏览工作流相关章节，之后再把它用于高风险仓库编辑。

让 skill 发挥作用的输入

想获得更可靠的 zero-hallucination-coder usage，需要给 agent 足够证据，避免它靠猜。一个较弱的 prompt 是：“Add password reset.” 更强的 prompt 可以是：

• “Implement password reset for the existing Express app.”
• “Use the current mailer and user model; do not introduce a new email provider.”
• “Inspect the auth routes, database schema, and test setup before editing.”
• “Return a plan first, identify files you will touch, then implement with tests.”
• “If a needed API or table is missing, stop and ask instead of inventing it.”

这类 prompt 与该 skill 的循环相匹配：讨论需求、映射真实文件、拆解实现、执行修改，并进行验证。

面向 Code Generation 的实用工作流

开始时可以明确要求 agent 使用该 skill：“Use zero-hallucination-coder for this task.” 然后提供任务、约束和成功标准。在第一轮回复中，你应该预期看到问题澄清或代码库地图，而不是马上给出代码。这是特性，不是拖延。

一个好的工作流是：

1. 要求生成与任务相关的仓库地图。
2. 在编辑前确认计划和将要修改的文件。
3. 让 agent 分小步实现。
4. 要求提供测试、类型检查、lint 输出或手动验证说明。
5. 合并前审查 agent 列出的所有假设。

对于多文件变更，要求 agent 解释为什么要修改每个文件。这样可以让 skill 始终基于真实上下文，也会让 code review 更轻松。

zero-hallucination-coder skill 常见问题

zero-hallucination-coder 只适用于 Claude 吗？

该仓库是作为 Claude skill 编写的，但这个工作流对能够读取仓库文件并遵循流程化指令的 AI coding agents 也普遍有用。安装体验取决于你的 skill runtime。如果你的环境不支持 Claude 风格的 skills，仍然可以阅读 SKILL.md，并把这套循环改写成项目 prompt 或 agent instruction。

它和一个谨慎的编码 prompt 有什么不同？

谨慎的 prompt 只是要求模型小心。zero-hallucination-coder 编码的是一套可重复执行的操作流程：澄清、检查、拆解、实现、验证。当任务跨越不熟悉的代码时，这一点很重要，因为 agent 被要求基于已观察到的文件做决策，而不是依赖记忆或惯例。代价是额外开销；对于很小的编辑，较短的 prompt 通常更合适。

什么时候不该使用这个 skill？

不要把它用于拼写修复、简单注释、小型文档编辑、一次性脚本，或任何不涉及现有项目上下文的任务。如果你无法提供仓库访问权限或足够的源码上下文用于验证，也应避免使用。这个 skill 的价值来自对真实代码的映射和检查；没有这些，它就只是一个更长版本的通用编码 prompt。

如何改进 zero-hallucination-coder skill

给 zero-hallucination-coder 更强的约束

提升 zero-hallucination-coder 输出质量最快的方法，是用明确边界替代模糊目标。说明框架、runtime、package manager、测试命令、禁止修改的文件、兼容性要求，以及什么才算完成。例如：“Do not change the public API,” “Keep the migration backward-compatible,” 或 “Use existing repository patterns even if a newer library exists.”

约束能减少幻觉，因为 agent 可自行发明架构的空间更少。

警惕常见失败模式

即使使用这个 skill，也要审查那些不易察觉的猜测：未经验证的依赖 API、缺失的 imports、重复现有 utilities 的新 helper functions、把真实行为 mock 掉的测试，或看起来已经完成的 “TODO” code。如果 agent 说它“assumes”了某个重要内容，先暂停，要求它在仓库中找到证据，或请求进一步澄清。

一个很好的 review 问题是：“这个方案中哪些部分直接受已检查文件支持，哪些部分需要推断？”

基于第一版继续迭代

把第一版结果当作草案计划或草案实现，而不是最终答案。要求 agent 围绕已修改文件、边界情况和不必要代码再做一次验证。可用的后续追问包括：

• “Remove any code not required by the acceptance criteria.”
• “List every external API used and where it is defined.”
• “Check whether an existing utility already solves this.”
• “Add or update the smallest meaningful tests.”
• “Explain how to manually verify the change.”

这样能让 zero-hallucination-coder guide 更实用：更少臆造代码、更少跳过步骤，并让需求到可 review 实现之间的路径更清晰。