AGENTS.mdA

AGENTS.md from huiliyi37/tianshu-harness is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add huiliyi37/tianshu-harness/AGENTS.md@git:20261005.b60fe86

Pins git:20261005.b60fe86 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
huiliyi37/tianshu-harness
Path
AGENTS.md
Versions recorded
7
Latest version
git:20261005.b60fe86, committed Oct 5, 2026
First version recorded
Jul 7, 2026
Size
2,140 bytes
Repository stars
1,254
License
Apache-2.0

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

# 天枢 (Tiānshū) — AGENTS.md

> 本仓是开发主仓的同步投影(外部 PR 处置与双仓模型见 [EXTERNAL-PRS.md](EXTERNAL-PRS.md))。
> 本文件是给在本仓工作的 agent / 贡献者的最小上手说明。

## 项目

全功能终端编程智能体运行时(CLI 命令 `rivet`,别名 `tianshu`):Node.js 24(engines 钉 24.18.0)+ TypeScript strict + 纯 ANSI 终端 UI(`src/tui/engine/`,零 React/Ink)。桌面端与 VS Code 插件均经 `src/server/` sidecar 驱动同一内核。

## 构建与测试

```bash
npm install && npm run build
npm test            # node:test + node:assert/strict(runner: scripts/run-node-tests.ts)
npm run typecheck   # tsc --noEmit
node dist/cli/entry.js  # 启动
```

## 目录速览

| 路径 | 职责 |
|------|------|
| `src/` | 内核:agent 循环(`src/agent/`)、工具(`src/tools/`)、API 客户端(`src/api/`)、提示词与缓存(`src/prompt/`、`src/cache/`) |
| `vscode-extension/` | VS Code / Cursor 插件(开源,sidecar 客户端) |
| `docs/` | 用户手册(`user-guide.md`)、架构、changelog、发布记录(`releases/`) |
| `scripts/` | 构建、测试 runner、门禁、公开仓同步 |
| `plugins/` | 示例插件(office 系列等) |

桌面端(`desktop/`)与部分高级实现不在本仓(闭源边界见 [EXTERNAL-PRS.md](EXTERNAL-PRS.md))。

## 贡献

- PR 不会被直接 merge——内容经评审后移植进开发主仓、验证、再同步回本仓(关闭 ≠ 拒绝):[EXTERNAL-PRS.md](EXTERNAL-PRS.md)
- 贡献者指南:[CONTRIBUTING.md](CONTRIBUTING.md);安全披露:[SECURITY.md](SECURITY.md)
- 贡献者名单:[CONTRIBUTORS.md](CONTRIBUTORS.md)(全体 PR 作者,与 merge 状态无关)

## 给 agent 的纪律
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add huiliyi37/tianshu-harness/AGENTS.md@sha256:aa797e4fab11ffb3

The line at the top of this page pins the label git:20261005.b60fe86, 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_thtlgvh5fmltkfdz.svg)](https://markdownregistry.com/a/art_thtlgvh5fmltkfdz)

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

Versions

The registry has recorded 7 versions of this file, between Jul 7, 2026 and Oct 5, 2026, about one every 15 days. Its first recorded version is graded B and its latest A.

versioncommittedcommitsizeaudit
git:20261005.b60fe86 latest2026-10-05 b60fe86 2,140 BA view · diff
git:20261001.8b9d7d32026-10-01 8b9d7d3 14,884 BB view · diff
git:20260719.4caac932026-07-19 4caac93 14,896 BB view · diff
git:20260718.5bea1b92026-07-18 5bea1b9 14,814 BB view · diff
git:20260716.02c7bb32026-07-16 02c7bb3 14,626 BB view · diff
git:20260711.b56f6732026-07-11 b56f673 9,684 BB view · diff
git:20260707.4b1820d2026-07-07 4b1820d 9,551 BB 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 (2140 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

huiliyi37/tianshu-harness · 1,254 stars · license Apache-2.0 · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_thtlgvh5fmltkfdz
GET https://markdownregistry.com/api/v1/resolve?ref=huiliyi37/tianshu-harness/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/aa797e4fab11ffb3abecb6f89611a0cef61bd3ccb1cfc82ea24db1ee079ff4f4

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 huiliyi37/tianshu-harness

CLAUDE.md CLAUDE.md file
huiliyi37/tianshu-harness · CLAUDE.md
git:20261026.f670653 · audit A · 1,254 stars
agent-harness-testing SKILL.md skill
huiliyi37/tianshu-harness · docs/skills/optional/agent-harness-testing/SKILL.md · 在任意项目中执行开发任务时的测试方法论——包括测试能力探测、RED→GREEN 纪律、探针管理、环境模拟、测试策略选择。当面对 bugfix、功能开发、重构等需要验证的代码改动时使用。
git:20260917.bf456db · audit A · 1,254 stars
design-prototype SKILL.md skill
huiliyi37/tianshu-harness · plugins/design/skills/design-prototype/SKILL.md · Frontend UI prototype workflow — clarify intent, explore directions, preview across viewports, diff against references…
git:20260720.5237f6c · audit A · 1,254 stars
office-docx SKILL.md skill
huiliyi37/tianshu-harness · plugins/office-docx/skills/SKILL.md · 生成与读取 Word 文档(.docx)——报告、合同、交付文档、投标书;原生 docx 渲染,支持 heading/paragraph/table/code/list 内容块与居中标题
git:20260815.236a44b · audit A · 1,254 stars
office-excel SKILL.md skill
huiliyi37/tianshu-harness · plugins/office-excel/skills/SKILL.md · Excel 电子表格读写与编辑最佳实践 — 用 xlsx_read/xlsx_write/xlsx_edit 处理 .xlsx 时遵守的公式、数字格式与可维护性纪律
git:20260720.5237f6c · audit A · 1,254 stars
office-pdf SKILL.md skill
huiliyi37/tianshu-harness · plugins/office-pdf/skills/SKILL.md · 生成与读取 PDF 文档(报告、合同、交付文档)——原生 pdfkit 渲染,自动解析系统 CJK 字体支持中文,支持 heading/paragraph/table/code/list 内容块与页码页脚
git:20260720.5237f6c · audit A · 1,254 stars
office-ppt SKILL.md skill
huiliyi37/tianshu-harness · plugins/office-ppt/skills/SKILL.md · PowerPoint 演示文稿生成纪律 — 用 pptx_create/pptx_read 产出有设计感、零 AI 味的 .pptx(PPT、幻灯片、deck、演讲稿、汇报)
git:20260720.5237f6c · audit A · 1,254 stars
brainstorming SKILL.md skill
huiliyi37/tianshu-harness · runtime-assets/bundled-skills/brainstorming/SKILL.md · You MUST use this before any creative work - creating features, building components, adding functionality, or modifying…
git:20260909.60a2332 · audit A · 1,254 stars
visual-acceptance SKILL.md skill
huiliyi37/tianshu-harness · runtime-assets/bundled-skills/visual-acceptance/SKILL.md · UI/视觉改动交付前的终验方法论——多主题截图矩阵复现、像素真值判据链、CSS 层叠陷阱、布局漂移审查、before/after 存证。当视觉改动需要验收(而非实现)时使用:交付前最后一环,回答「看得见的部分真的对吗」。
git:20260803.76ef549 · audit A · 1,254 stars
DESIGN.md@website DESIGN.md file
huiliyi37/tianshu-harness · website/DESIGN.md
git:20260731.0dde176 · audit A · 1,254 stars

Every file in huiliyi37/tianshu-harness

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261101.d684125 · audit A · 417,919 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 309,852 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 293,827 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 198,353 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 182,080 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 139,879 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261027.a50cf58 · audit A · 138,879 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 116,476 stars

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