SuperAPI AI 工具集

darkmatter-repo-setup

通用与其它

查看项目

更新于 10-15 20:32

技能介绍

用途:这是一个仓库 setup 智能体技能,用于新建仓库、把现有仓库接入 Darkmatter 标准、执行合规检查,或在用户说“set up this repo”时触发。目标是把当前仓库提升到 Darkmatter 生产就绪模板标准:审计现状、补齐缺失、更新过时内容并验证结果。

主要能力:按所有权和角色组织代码,保留配置的行数上限,只在强制拆分会导致职责分散时做有记录的定向放宽;不为每个 helper 建文件、服务或测试,通过公共接口验证行为,包括完成、失败与清理。以规范模板为准,克隆后读取而非盲目复制项目名、包名或应用逻辑。模板根 package.json 的 catalog 是首选依赖库来源;新应用数据默认用 Postgres,除非仓库记录了明确的边缘本地或演示理由。

使用方式:先克隆模板并检查仓库状态。

git clone --depth 1 git@github.com:darkmatter/template.git /tmp/darkmatter-template

用 git rev-parse --show-toplevel 定位仓库根,列出顶层内容,读取 package.json、AGENTS.md、flake.nix,检查 .zed/、ops/、.github/、docs/、justfile,并将仓库分类为新仓库或现有仓库。审计阶段对照 references/checklist.md,把每项记为合规、部分/过时或缺失,先向用户展示汇总表。修复阶段按顺序处理:package.json、packages/tooling、TypeScript 配置、lint 与格式化、测试、Zed 配置、Nix flake、justfile、ops/、CI、.gitignore、文档、Effect 源码,最后是 AGENTS.md。Effect 相关设置必须遵循 Effect Solutions 快速入门,可安装 CLI:

bun add -g effect-solutions@latest

effect-solutions list

effect-solutions show project-setup

AGENTS.md 通过 flake 输入 darkmatter-skills 拼接生成,仓库自身说明放 docs/AGENTS.repo.md,并用以下命令刷新与校验:

cp "$(nix build --no-link --print-out-paths .#agents-md)" AGENTS.md

diff -u AGENTS.md "$(nix build --no-link --print-out-paths .#agents-md)"

验证阶段运行:bun install、bun run prepare、bun run check、bun run test、bun run lint、bun run fmt:check、nix flake check、docker compose -f ops/compose/local.yaml config;失败则尝试修复,不适用则说明并跳过。最后清理模板并汇报已合规、已更新、已新建、各步验证结果与需人工处理事项。

限制:除非用户明确要求,否则不要提交;保留现有应用逻辑与无关工作区改动;不得写入解密后的 SOPS 值或明文凭据;不要添加模板标准之外的依赖;已存在且合规的文件不重写;使用其他等价有效方式(如不同但等价的 Nix 结构)时只记录,除非用户要求否则不强制重写。具体仓库名称、命令适用范围与操作系统的额外要求暂未提供。