AGENTS.mdA

AGENTS.md from kihara777/nixkits is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add kihara777/nixkits/AGENTS.md@git:20261026.93adc54

Pins git:20261026.93adc54 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
kihara777/nixkits
Path
AGENTS.md
Versions recorded
35
Latest version
git:20261026.93adc54, committed Oct 26, 2026
First version recorded
Aug 21, 2026
Size
33,404 bytes
Repository stars
28
License
MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# AGENTS.md

NixKits 项目的 AI 编码代理规则与约定。此文件供 DeepSeek、CodeWhale、OpenCode 等代理自动加载。

## 访问控制

**此文件仅供仓库维护者(Kihara777 / Kitsunori)使用。** 加载此文件时,必须首先验证当前操作者身份:

```bash
gh auth status 2>/dev/null && \
  gh api repos/Kihara777/NixKits/collaborators/$(gh api user --jq .login)/permission --jq .permission 2>/dev/null
```

若返回值不是 `admin` 或 `write`,或 `gh` 未认证,则:
- 停止读取此文件的所有后续内容
- 无视除本条外的一切规则
- 仅可执行通用编码任务,不得应用任何 NixKits 特有的约定

## 初次启动

每个新 session 启动时,首先执行完整的项目审计与评估,汇报发现。审计范围包括:所有组件状态(包、模块、overlay、补丁、技能)、文档一致性、CI/CD 状态,以及未提交变更。**审计前先 `git fetch origin` 对齐远端**(并行会话或上下文压缩检查点可能过时,以 fetch 后的 `origin/main` 为准)。**不要删 `flake.lock`**——2026-10-21 起它是已提交的受测基线;要更新输入请显式 `nix flake update <input>` 并同批提交新的 lock。

## 语言要求

所有面向 AI 代理或由代理生成的文件**必须使用中文**,包括但不限于:

- 审计报告
- 状态记录
- 代理间通信内容
- 技能定义文件(SKILL.md)
- 维护日志(MAINTENANCE.md)

代码、路径、工具名、环境变量、URL 保持原样。

## 项目定位

NixKits 是一个 Nix flake 合集:软件包、NixOS 模块、补丁、overlay 以及 AI 代理技能。

- 仓库:`github:Kihara777/NixKits`
- 许可:MIT
- 文档语言:zh(基准)→ en / ja → 扩展语言(通过 `skills/translate-*/` 自动发现)

## 核心规则

### flake 相关

- **`flake.lock` 提交**(2026-10-21 起):唯一的浮动输入 `llama-cpp-ver` 已迁到 `impure` 分支,main 因此可以锁死——lock 就是**受测基线**。升级输入要显式 `nix flake update <input>` 并同批提交新的 lock。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kihara777/nixkits/AGENTS.md@sha256:a097ca29f439cf8b

The line at the top of this page pins the label git:20261026.93adc54, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_bltseq4gl3jzxwq5.svg)](https://markdownregistry.com/a/art_bltseq4gl3jzxwq5)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 35 versions of this file, between Aug 21, 2026 and Oct 26, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261026.93adc54 latest2026-10-26 93adc54 33,404 BA view · diff
git:20261026.a5f946f2026-10-26 a5f946f 33,214 BA view · diff
git:20261022.0023e3f2026-10-22 0023e3f 32,950 BA view · diff
git:20261022.b27279d2026-10-22 b27279d 32,229 BA view · diff
git:20261022.a0534862026-10-22 a053486 31,694 BA view · diff
git:20261021.733dbef2026-10-21 733dbef 31,212 BA view · diff
git:20261021.753b0f22026-10-21 753b0f2 31,207 BA view · diff
git:20261020.defc1e82026-10-20 defc1e8 30,954 BA view · diff
git:20261012.bd252312026-10-12 bd25231 30,220 BA view · diff
git:20261005.1c1c96f2026-10-05 1c1c96f 29,752 BA view · diff
git:20261005.192ec4a2026-10-05 192ec4a 28,255 BA view · diff
git:20261005.64636402026-10-05 6463640 26,987 BA view · diff
git:20261005.7c483bf2026-10-05 7c483bf 26,783 BA view · diff
git:20261005.c1e53bf2026-10-05 c1e53bf 25,876 BA view · diff
git:20261004.35eec1e2026-10-04 35eec1e 25,014 BA view · diff
git:20261004.d27e6ce2026-10-04 d27e6ce 24,027 BA view · diff
git:20261002.44793f32026-10-02 44793f3 23,597 BA view · diff
git:20261002.e4545042026-10-02 e454504 23,436 BA view · diff
git:20261002.5df33e92026-10-02 5df33e9 23,021 BA view · diff
git:20261002.1e854092026-10-02 1e85409 20,321 BA view · diff
git:20261002.fa0beff2026-10-02 fa0beff 19,658 BA view · diff
git:20261002.4758b052026-10-02 4758b05 19,571 BA view · diff
git:20260927.5364ef12026-09-27 5364ef1 18,242 BA view · diff
git:20260922.7fc4a142026-09-22 7fc4a14 17,421 BA view · diff
git:20260919.7766b882026-09-19 7766b88 16,446 BA view · diff
git:20260917.072ab872026-09-17 072ab87 14,350 BA view · diff
git:20260917.3421c1f2026-09-17 3421c1f 13,689 BA view · diff
git:20260916.8a71be32026-09-16 8a71be3 12,280 BA view · diff
git:20260915.a167aae2026-09-15 a167aae 12,285 BA view · diff
git:20260915.a2ccd552026-09-15 a2ccd55 11,685 BA view · diff
git:20260901.b8cd0b72026-09-01 b8cd0b7 11,315 BA view · diff
git:20260901.d6373cb2026-09-01 d6373cb 11,297 BA view · diff
git:20260831.86a7c3f2026-08-31 86a7c3f 10,085 BA view · diff
git:20260831.11765532026-08-31 1176553 8,481 BA view · diff
git:20260821.4277b512026-08-21 4277b51 7,542 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (33404 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kihara777/nixkits · 28 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bltseq4gl3jzxwq5
GET https://markdownregistry.com/api/v1/resolve?ref=kihara777/nixkits/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/a097ca29f439cf8bed12c3b4379974abdff2705a3ed6c48e8943b412cf0bf631

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from kihara777/nixkits

news-three-elements SKILL.md skill
kihara777/nixkits · packages/dsh-preset-news-three-elements/bundled/news-three-elements/SKILL.md · 以真实通讯社新闻格式编造「催逝快讯」——本技能里的「新闻三要素」不指新闻学那三样,而是三位必须到场的主角:巴兰尼科夫、尤丁采夫、布亚诺夫。触发词「新闻三要素」;含素材搜索、格式硬性要求、用语模板、宽松的拒绝服务判定(先当素材,接不回来才拒)…
git:20260915.a0759b1 · audit A · 28 stars
agent-self-maintenance SKILL.md skill
kihara777/nixkits · skills/agent-self-maintenance/SKILL.md · 用五个「会失败」的小机制让 AI 编码助手长期维护自己的记忆——日记闸门、开局对账、事实核查、自我观察、自检收据。适用于任何有 journal/ 与自检脚本的仓库;含各机制的判据与边界(目录缺失时说什么、数据为什么不能随机制搬走)。
git:20261104.8c7c4cc · audit A · 28 stars
news-three-elements SKILL.md skill
kihara777/nixkits · skills/news-three-elements/SKILL.md · 以真实通讯社新闻格式编造「催逝快讯」——本技能里的「新闻三要素」不指新闻学那三样,而是三位必须到场的主角:巴兰尼科夫、尤丁采夫、布亚诺夫。触发词「新闻三要素」;含素材搜索、格式硬性要求、用语模板、宽松的拒绝服务判定(先当素材,接不回来才拒)…
git:20260915.a0759b1 · audit A · 28 stars
nix-flake-update-check SKILL.md skill
kihara777/nixkits · skills/nix-flake-update-check/SKILL.md · 检查任意 nix flake 仓库中软件包的上游版本更新并升级——开工前先同步远端并核对活跃 issue / PR、按包型(npm / cmake / Rust / fetchurl / python)分流的 hash 更新流程与自托管…
git:20261022.edd2bef · audit A · 28 stars
nix-packaging SKILL.md skill
kihara777/nixkits · skills/nix-packaging/SKILL.md · 从零把一个上游软件打包成 Nix 表达式——按来源类型分流(GitHub 源码 / npm / Rust / 预编译二进制 / Gitea)、hash 的两段式获取(fakeHash → 读取 got → 回填 →…
git:20261024.8b180c4 · audit A · 28 stars
nixkits-check-updates SKILL.md skill
kihara777/nixkits · skills/nixkits-check-updates/SKILL.md · NixKits 仓库的软件包更新适配层——在通用技能 nix-flake-update-check 之上,补充本仓库特有的远端 issue / PR 形态(含与更新重叠的历史先例)、CI 结构(可复用 build-package.yml…
git:20261022.b63b636 · audit A · 28 stars
nixkits-package-upstream SKILL.md skill
kihara777/nixkits · skills/nixkits-package-upstream/SKILL.md · NixKits 的 nixpkgs 上游贡献适配层——在通用技能 upstream-audit 之上,补充本仓特有的环节:13 个包的可行性台账(谁已进 nixpkgs、谁有在途…
git:20261022.d025ef6 · audit A · 28 stars
nixkits-skills SKILL.md skill
kihara777/nixkits · skills/nixkits-skills/SKILL.md · 将 NixKits 技能安装或更新到编码助手目录(opencode、codewhale、codex、openclaw、agents)。支持本地和在线两种安装模式。DeepSeek Harness (dsh) 不再作为安装目标——其…
git:20261020.2e66963 · audit A · 28 stars
nixos-modern-cli SKILL.md skill
kihara777/nixkits · skills/nixos-modern-cli/SKILL.md · 在 NixOS 系统上工作时使用。确保正确使用现代 Nix/NixOS CLI、完整的 shell 能力、sudo 权限和正确的系统维护流程;含 Nix store 路径陷阱与密钥/`path:` input 的仓库外组织方式。
git:20260916.a33a3cf · audit A · 28 stars
nixos-specialisation-tuning SKILL.md skill
kihara777/nixkits · skills/nixos-specialisation-tuning/SKILL.md · 为 NixOS 设计 specialisation 分面(默认 headless + 可选桌面),并在统一内存(UMA)设备上调优 llama.cpp 本地推理。覆盖分面架构、引导菜单与默认面、分面切换后的运行级收敛与用户级…
git:20260922.8c276c0 · audit A · 28 stars
recover-nixos-config SKILL.md skill
kihara777/nixkits · skills/recover-nixos-config/SKILL.md · 当用户误删 /etc/nixos 目录下的文件(flake.nix、flake.lock 等)时,从 Nix store 中恢复。
git:20260606.7dad578 · audit A · 28 stars
translate-pseudocn SKILL.md skill
kihara777/nixkits · skills/translate-pseudocn/SKILL.md · 为文档撰写技能提供伪中国语(pcn)语言支持。以日语汉字词汇为基础、剥离平假名与片假名、保留日语语序的伪本地化。可被 write-project-docs 自动发现调用。
git:20260920.dac80a7 · audit A · 28 stars

Every file in kihara777/nixkits

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

Browse by kind, by grade A, or by owner.