菜单
Crater 代码开发：在 backend/、frontend/、cli/ 下开发 Go 后端、React 前端、CLI、API、作业模板、组件、表单、hooks、i18n 与测试。用户修改 backend/、frontend/、cli/ 代码或前后端/CLI 联动时使用；调用 crater 命令则用 cli/skills/crater-cli-*；开始前须应用 crater-devel-shared。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/raids-lab/crater --skill crater-devel-code命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Use Crater CLI job commands to list, inspect, view logs, create, stop, and snapshot jobs.
Crater CLI 共享基础：安全调用 crater 命令的通用规则，包括可执行文件选择、全局选项、列表分页、--json、--no-interactive、--help、错误输出、退出码、错误场景判断、API 兼容性诊断、敏感信息处理，以及执行会修改用户环境的命令前的确认规则。处理任何 Crater CLI 操作前使用。
Crater CLI 管理员审批工单域：通过 crater admin order ... 查看、批准、拒绝、清理审批工单。仅在用户明确要求管理员审核时使用。
基于 SOC 职业分类
正在显示 SKILL.md
| name | crater-devel-code |
| version | 0.1.0 |
| description | Crater 代码开发：在 backend/、frontend/、cli/ 下开发 Go 后端、React 前端、CLI、API、作业模板、组件、表单、hooks、i18n 与测试。用户修改 backend/、frontend/、cli/ 代码或前后端/CLI 联动时使用；调用 crater 命令则用 cli/skills/crater-cli-*；开始前须应用 crater-devel-shared。 |
开始前先应用 crater-devel-shared。
完整开发规范见 backend/CONTRIBUTING.md、frontend/CONTRIBUTING.md 与 cli/CONTRIBUTING.md。本 Skill 只保留 Agent 易漏的代码开发高优先提醒；API、错误、数据库、组件、hooks、i18n、本地调试与 make target 细节均以对应 CONTRIBUTING 为准。
若任务是教用户调用 crater 命令，而不是修改 cli/ 代码，应改用 cli/skills/crater-cli-*，不要用本 Skill。
Admin 路由和 Admin* 命名；用户接口走 Protected 路由和 User* 命名。外部 API 变更要同步 swag 注释。bizerr + resputil.HandleError：HTTP 状态表达错误类别，业务码表达稳定机器原因，msg 用清晰安全的英文说明用户可理解的问题；底层 cause 用 Wrap 留给后端日志，不把内部细节暴露给客户端。backend/CONTRIBUTING.md 检查克隆作业 / 导入导出配置兼容性；需要阻断旧配置时提升对应前端 MetadataForm* version，旧配置仍需可用时补兼容与验证。internal/storage/ 严禁拼接 SQL 字符串，必须参数化查询；不得硬编码密钥、Token、密码、内网 IP。backend/CONTRIBUTING.md 和 backend/cmd/gorm-gen/README.md 走迁移与生成流程，不要只改 model 或只改业务代码。ui-custom/、components/form/、components/、hooks/）；确实不适配再新建。ui-custom/ 前，先评估引用范围与兼容性，不要为单个页面随意改公共行为；提醒开发者人工抽查代表性受影响页面。MetadataForm*、src/components/form/types.ts、作业表单默认值、clone / template source）时，必须检查是否需要提升对应模板 version，并在模板迁移注册表中提供“上一版本 -> 当前版本”的迁移函数；后续旧版本通过链式迁移逐步升级，不支持的更早版本要明确报错，不要静默当作当前结构解析。useIsAdmin()；管理员视图调管理员接口，普通用户调用户接口，前后端身份边界要一致。msg、HTTP 状态和业务码等排查事实；只有页面确实需要改变交互时才按 src/services/error_code.ts 的具体业务码特殊处理，并在消费错误后调用 markApiErrorHandled。translation.json。cli/ 采用文档驱动开发。开发入口与工作流见 cli/CONTRIBUTING.md；具体行为契约参考它索引的 cli/docs/* 文档。
| 文档 | 权威范围 | 何时读 |
|---|---|---|
cli/docs/COMMANDS.md | 指令级契约：命令、flag、位置参数、输出、错误、退出码、交互 | 新增 / 修改任何用户可见行为前先读并更新它 |
cli/docs/SPEC.md | 跨命令公共契约：--json、--no-interactive、错误信封、退出码、i18n、Tab 补全、快照测试、测试沙箱 | 改公共模块或公共行为前 |
cli/docs/ARCHITECTURE.md | 实现结构、模块边界、调用链、网络通信、补全机制 | 理解实现或调整模块边界时 |
cli/docs/REVIEW.md | 审查流程与检查重点 | 阶段收尾自检或审查时 |
COMMANDS.md；跨命令规则、参数校验、管理员命名空间、后端契约、Skills 分发和快照要求以 SPEC.md 为准；实现边界以 ARCHITECTURE.md 为准；收尾自检以 REVIEW.md 为准。--json 错误信封保留 http_status、crater_code、msg 等可序列化字段，方便用户修改命令输入，也方便管理员按业务码和后端日志排查。cli/skills/ 时，把稳定或高频报错沉淀为“错误信息 / 结构化字段 -> 对应情况 -> 用户修正动作 / 管理员排查事实”；写入前先把该理解展示给开发者检查，确认没有误解后再更新 Skill 并提升版本。cli/Makefile；运行前检查 go version。如果本地 Go 版本不匹配，提醒开发者可能通过 gvm 管理 Go 版本，并按 cli/CONTRIBUTING.md / go.mod 切换后再测试。提交前优先 make pre-commit-check（当前等价于 make test）。涉及用户可见 CLI 行为时，要求开发者手动执行关键命令并检查输入输出。构建、lint、迁移、测试走对应模块 make；涉及 Go 前先检查 go version。如果版本不符合对应 go.mod，提醒开发者可用 gvm 管理并切换 Go 版本，通常在对应 go.mod 所在目录按 CONTRIBUTING 指引执行。本地调试通常前后端一起启动，后端通过配置连接测试集群依赖；make run-storage 只在 storage-server 相关任务中按需使用。涉及 UI 变化时提醒开发者在 PR 中附截图。