standards

标准 — 聚焦工程指导

根据调用方提供的文件、语言和风险，只加载有充分依据的最小标准集。不要预先加载整个参考语料库。

提示词

Check standards for the changed files in fleet-router PR #214: cli/internal/auth/token.go and cli/internal/auth/token_test.go, Go, a security-sensitive change. Load only the matching references and report cited findings with path and line plus checked and not-checked scope.

达标条件

• 报告加载 common-standards.md，以及仅与之匹配的 Go 参考资料，绝不加载整个参考语料库。
• 每条发现都引用路径和行号，例如 cli/internal/auth/token.go:18。
• 响应明确说明 checked 和 not_checked 范围，即使 not_checked 为空也要说明。
• git diff --stat 显示没有测试、门禁或夹具文件发生变化；标准报告只列出发现。

流程

1. 记录提供的路径、语言、变更类型和风险线索。
2. 加载 common-standards.md，以及仅与之匹配的语言或清单参考资料。
3. 将提供的产物与这些资料进行对比。
4. 返回带引用的发现（尽可能提供路径和行号），以及已检查和未检查的范围。
5. 停止。

此技能提供上下文和发现。它不会编辑、验证、重试、批准、提交、发布、交付，也不会决定是否继续。

生成代码的关键约定（实测）

当调用方即将编写代码时（而不仅仅是审查代码），应在工作上下文中直接呈现匹配的语言规则——放在链接背后的参考资料不会改变行为；直接写明的指令则会。Go 核心规则：

• 为每个向上传递的错误添加上下文：fmt.Errorf("doing X: %w", err) — 绝不直接返回内部错误。
• 有多个分支情况的函数应编写表驱动测试（[]struct 用例 + 每个用例一个 t.Run），并断言精确的预期值，包括错误用例。

对于其他语言，加载下方匹配的参考资料，并以相同方式在上下文中直接呈现其顶层规则。

实测于 2026-08-04，探针 standards-go-conventions（gpt-5.6-luna，N=2， 方向性）：对照组在 1/2 次运行中生成了带 %w 包装的错误和表驱动测试结构；将这些规则直接写入上下文后，结果为 2/2。直接指令优于参考链接——graphify 探针测得，链接文档中的指令在 0/2 次运行中得到遵循。记录： evals/skill-probes/LEDGER.md。

变更安全标准

当提供的变更会批量重写现有文件（格式化工具、codemod、迁移脚本、针对手写源文件运行的生成器）时，应依据以下三项标准进行检查；如有缺失，应分别列为发现：

• 单一、经过审计的变更入口。 所有重写都通过一个具名命令或脚本执行，其输入、输出和试运行模式均可检查。分散在临时单行命令和手动微调中的编辑属于分散变更失败模式：没有单一入口可供审计、重跑或追责。发现项：指出变更入口之外的每条变更路径。
• 重写前创建带哈希见证的备份。 运行变更入口前，先保存原始内容并记录内容哈希（已提交的基线也可），以便逐字节核验“重写只改了声称要改的内容”，而不是仅凭声明。发现项：批量重写没有可验证的变更前状态。
• 自行实施范围门禁。 变更应明确说明刻意不触及哪些内容，且差异必须符合该范围。格式化工具运行时还进行了重命名，codemod 还进行了重构，都属于范围蔓延式重写失败模式。发现项：差异中超出变更自身声明范围的任何文件类别。

此项检查的停止条件：三项标准都必须明确判定为通过或列出发现；批量重写审查如果只报告风格问题，却跳过这些标准，则是不完整的。

References

• Common standards
• Go
• Python
• Rust
• TypeScript
• JavaScript
• Shell
• JSON
• YAML
• Markdown
• SQL safety
• Race conditions
• LLM trust boundaries
• Skill structure
• Test strategy