SuperAPI AI 工具集

hns-moaiadk-best-practices

编程与开发

查看项目

更新于 10-16 06:48

技能介绍

用途:为 moai-adk-go 项目的四个 harness 专家提供统一的最佳实践参考,确保生成与修改的代码、测试和 harness 文件符合项目质量与协作规范。

主要能力与规则:

  1. TRUST 5 质量门:每次变更须通过 Tested(go test ./... 含覆盖率)、Readable(golangci-lint run)、Unified(go fmt + goimports)、Secured(OWASP 对齐审查)、Trackable(Conventional Commits 正则)五个维度。覆盖率目标:包最低 85%,关键包(internal/cli、internal/template、internal/hook)90%+。
  2. 测试隔离:临时目录一律用 t.TempDir();注意 macOS 下 filepath.Join 不剥离绝对路径前导斜杠,解析用户路径时用 filepath.Abs()。并行测试中禁止设置 OTEL_EXPORTER_* 环境变量,GLM 集成测试中禁止 t.Setenv("HOME", tmpDir)。修复测试后运行完整套件,调试时用 -count=1,并发检查用 -race。
  3. 防硬编码:URL、模型名、组织名、API 头提取为常量;环境变量名定义在 internal/config/envkeys.go;阈值集中在 internal/config/defaults.go;跨平台路径优先 $HOME、HOMEBREW_PREFIX。仅允许在 CLAUDE.local.md、settings.local.json 和 t.TempDir() 内的 _test.go 中硬编码。
  4. AskUserQuestion 边界:仅 MoAI 编排器(主会话)可调用,子智能体不得调用,需用户输入时返回结构化阻塞报告。该工具为延迟加载工具,首次使用前须 ToolSearch 预载。
  5. 归档智能体拒绝契约:12 个智能体已归档,不得在任何生成文件中引用;仅 8 个保留智能体可作为委派目标:manager-spec、manager-develop、manager-docs、manager-git、plan-auditor、sync-auditor、builder-harness、Explore。领域专家改用 per-spawn 模式。
  6. 验证声明完整性:不得作未观察的声明,缺陷推断须有专用工具验证,声明须附命令与逐字输出,采用 Claim/Evidence/Baseline-attribution/Gaps/Residual-risk 五段报告格式。

限制:具体归档智能体名单见 .claude/rules/moai/workflow/archived-agent-rejection.md §B,本技能不重复列出。