SuperAPI AI 工具集

hns-moaiadk-patterns

编程与开发

查看项目

更新于 10-16 06:48

技能介绍

用途:为 moai-adk-go 的四个 harness 专家提供领域模式参考,覆盖架构、源码路径、构建循环与工作流约定,帮助在 MoAI-ADK 分发体系内正确扩展模板、Hook、Agent 与 SPEC。

主要能力与结构:moai-adk-go 是一个 Go 二进制(moai),含四个子系统:CLI(internal/cli/.go,cmd/moai/,Cobra 命令 init、update、hook、build、glm、cc、cg、version、doctor、spec);模板系统(internal/template/,基于 go:embed,源在 internal/template/templates/,通过 embed.go 的 //go:embed all:templates 嵌入,无生成 .go 文件,make build 重编译,TemplateContext 支持 {{.GoBinPath}} / {{.HomeDir}},在 moai init 时渲染);配置(internal/config/,defaults.go 为阈值单一来源,envkeys.go 存环境变量常量);Hook 与 CI(.claude/hooks/moai/.sh 调用 moai hook <event>,.github/workflows/ 含模板中立性守卫)。另有 SPEC 生命周期(.moai/specs/),按 plan→run→sync→Mx 治理项目开发。

使用方式:管道为 CLI/Template → quality → workflow → hook/CI,各专家委派保留的 agents(manager-develop、Explore、sync-auditor、manager-spec、manager-docs、plan-auditor、builder-harness 等),不归档、不替换它们。模板优先构建循环:先改 internal/template/templates/<path>,再 make build,然后 moai update 同步,验证本地 .claude/ 与 .moai/ 反映模板,最后运行 go test ./internal/template/...(含中立性审计)。禁止无模板源直接改 .claude/ 或 .moai/。命名空间分离:模板管理路径在 moai update 时会覆盖本地;用户自有路径(.claude/agents/harness/、harness-* skills、.moai/harness/)永不被删除或修改,更新前备份。用户自有技能前缀为 harness-,旧 my-harness- 仅在兼容弃用期保留。添加 Hook 需写 bash 脚本、在 .claude/settings.json 中以 "$CLAUDE_PROJECT_DIR/..." 引号与 timeout: 5 接线。添加 Agent 需创建 .claude/agents/harness/<role>-specialist.md 并确保配套 harness-* 技能存在。添加 SPEC 依次经过 /moai plan、audit 门、人工审批、/moai run、/moai sync、sync-auditor 四维门与三阶段收尾。

适用场景:在 moai-adk-go 项目中扩展模板、Hook、CI、专家 Agent 与 SPEC 流程。

限制:以上为仓库内部模式与约定,非用户功能说明;具体命令行为与版本差异暂未提供,需以项目实际源码与文档为准。