AGENTS.mdA

AGENTS.md from heihuzi-labs/captain-agents is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add heihuzi-labs/captain-agents/AGENTS.md@git:20261028.10819b7

Pins git:20261028.10819b7 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
heihuzi-labs/captain-agents
Path
AGENTS.md
Versions recorded
6
Latest version
git:20261028.10819b7, committed Oct 28, 2026
First version recorded
Sep 30, 2026
Size
6,781 bytes
Repository stars
23
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

# 派活工作台(xagents)项目规则

给在这个仓库里干活的人和助手看。总体设计见 [docs/design.md](docs/design.md),桌面应用见 [docs/design-desktop.md](docs/design-desktop.md),界面规范见 [docs/ui-spec.md](docs/ui-spec.md)。

## 说话

- 对主人的一切回复用中文大白话:先说做了什么、怎么验证的、有没有坑,少用术语。代码、命令、提交说明可以用英文。
- 界面上的字全部中文、给人看:只写人需要知道的,不写会引起误会的猜测(比如“可能卡住”),状态用颜色表达。

## 技术约定

- 现在是“命令行 + 桌面应用”,两边共用 `src/core/` 一份核心;命令行在 `src/cli/`,桌面应用在 `app/`(`main` 后台、`preload` 桥、`renderer` 界面、`shared` 共用类型)。规则只写在核心里,两个外壳不重复写。
- Node 24 + TypeScript,只用可擦除的写法(不用 `enum`、`namespace`、参数属性)。
- 命令行入口是 `bin/xagents`(`package.json` 的 `bin`),由 Node 直接运行 `src/cli/cli.ts`,不编译。桌面应用用 electron-vite:`npm run dev` 开发,`npm run build` 构建,应用入口 `out/main/index.js`。
- 运行时依赖(`package.json` 的 `dependencies`):`@anthropic-ai/sandbox-runtime`(选手隔离)、`koffi`(只在 Windows 上用:直接调系统接口来防休眠、读进程列表、送进回收站,不在后台启动 PowerShell,见 [docs/design-windows.md](docs/design-windows.md) 第 13 节)和桌面界面用的 `react`、`react-dom`、`react-markdown`。开发依赖是构建、打包、类型检查、测试、截图这几类工具(Electron、electron-vite、Vitest、Playwright 等)。加任何依赖先说明理由。
- 写登记文件一律先写临时文件再改名;改任务记录一律在锁里“读 → 改 → 写”。

## 测试与验收

- 三层测试,都不联网,不碰真实的 `~/.xagents`(用临时 `XAGENTS_HOME`),真实选手一律用替身:
  - 核心测试:`npm test`,`node:test` 跑 `test/*.test.ts`。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add heihuzi-labs/captain-agents/AGENTS.md@sha256:36f9f4e479f52544

The line at the top of this page pins the label git:20261028.10819b7, 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_tmnliheknnfdb3av.svg)](https://markdownregistry.com/a/art_tmnliheknnfdb3av)

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

Versions

The registry has recorded 6 versions of this file, between Sep 30, 2026 and Oct 28, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261028.10819b7 latest2026-10-28 10819b7 6,781 BA view · diff
git:20261017.b838bc92026-10-17 b838bc9 6,696 BA view · diff
git:20261014.f9badd42026-10-14 f9badd4 7,013 BA view · diff
git:20261011.506d0742026-10-11 506d074 5,005 BA view · diff
git:20261010.91c028a2026-10-10 91c028a 4,996 BA view · diff
git:20260930.465b0c52026-09-30 465b0c5 4,457 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 (6781 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

heihuzi-labs/captain-agents · 23 stars · license MIT · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tmnliheknnfdb3av
GET https://markdownregistry.com/api/v1/resolve?ref=heihuzi-labs/captain-agents/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/36f9f4e479f5254425d06c2371f75673d30d0f5e442a90585893cfe3a214ccbf

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 heihuzi-labs/captain-agents

xagents SKILL.md skill
heihuzi-labs/captain-agents · skill/SKILL.md · 用派活工作台(xagents)把目标清楚的实现、修复、审查初筛或代码调研派给本机 Codex、Grok、Cursor 命令行(以及借 Codex 跑的…
git:20261017.b838bc9 · audit A · 23 stars

Every file in heihuzi-labs/captain-agents

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.