AGENTS.md agentsA

AGENTS.md is agent-read markdown (agents) from modoojunko/awesome-novel-agent.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Repository Guidelines

## 工作原则

减少常见 LLM 编码错误的行为准则。权衡:这些准则倾向于谨慎而非速度。对于简单任务,请自行判断。

### 1. 编码前先思考
不要假设。不要隐藏困惑。显化权衡。

在实现之前:
- 明确陈述你的假设。如果不确定,请提问。
- 如果存在多种解读,请全部呈现——不要默默选择。
- 如果存在更简单的方案,请说出来。必要时坚持己见。
- 如果有不清楚的地方,停下来。指出哪里令人困惑。提问。

### 2. 简洁优先
用最少的代码解决问题。不做任何推测性的设计。

- 不添加超出需求的功能。
- 不为只用一次的代码做抽象。
- 不引入未被要求的"灵活性"或"可配置性"。
- 不处理不可能发生的场景的错误。
- 如果你写了 200 行但 50 行就能搞定,重写它。
- 问自己:"资深工程师会说这过度设计了吗?"如果答案是肯定的,简化它。

### 3. 精准修改
只碰你必须碰的。只清理你自己留下的混乱。

编辑现有代码时:
- 不要"改进"相邻的代码、注释或格式。
- 不要重构没坏的东西。
- 匹配现有风格,即使你自己不会那样写。
- 如果你注意到无关的废弃代码,提出来——不要删除它。

当你的变更产生孤儿代码时:
- 删除你的变更导致不再使用的 import/变量/函数。
- 不要删除既有的废弃代码,除非被要求。
- 检验标准:每一行变更都应能直接追溯到用户的请求。

### 4. 目标驱动执行
定义成功标准。循环验证直到通过。

将任务转化为可验证的目标:
- "添加校验" → "为无效输入编写测试,然后让它们通过"
- "修复 Bug" → "编写一个能复现它的测试,然后让它通过"
- "重构 X" → "确保重构前后测试都通过"

对于多步骤任务,简要列出计划:
1. [步骤] → 验证:[检查点]
2. [步骤] → 验证:[检查点]
3. [步骤] → 验证:[检查点]

强有力的成功标准让你能独立循环。弱标准("让它跑起来")需要不断澄清。

## 面向作者沟通

agent 与作家对话、提问、展示、确认一律用日常大白话。铁律与"内部名词 → 作者用语"对照表见 `knowledge/format-specs/author-communication.md`(部署后为 `.claude/knowledge/author-communication.md`,与作者对话的 agent 均已挂引用):内部字段名、自创术语、流程词不得出现在作者可见文本;给作者看结构用摘要模板,不展示原文结构;网文通用词(爽点/打脸/钩子/金手指/卷纲/章纲等)保留不翻译。修改 agent 话术时先查对照表;新增内部名词同步补表。

## 项目结构与模块组织
…

Read the whole file at its exact version.

How to install

Latest version
mdr add modoojunko/awesome-novel-agent/AGENTS.md@git:20260925.ac8802c
Exact content
mdr add modoojunko/awesome-novel-agent/AGENTS.md@sha256:692d1c272c671c24

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

0 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260925.ac8802c latest2026-09-25 ac8802c 7,694 BA view · diff
git:20260831.455c8bd2026-08-31 455c8bd 7,691 BA view · diff
git:20260825.57cf03e2026-08-25 57cf03e 7,482 BA view · diff
git:20260823.3bdca9f2026-08-23 3bdca9f 7,202 BA view · diff
git:20260818.9fb1d132026-08-18 9fb1d13 7,182 BA view

Audit of the latest version

A  14 of 14 checks passed. Deterministic, no model, same answer every run.
  • pass: Size between 200 bytes and 200 KB (7694 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

modoojunko/awesome-novel-agent · 760 stars · license AGPL-3.0 · pushed 2026-09-25 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_y3hyibwpjsw4wjew
GET https://markdownregistry.com/api/v1/resolve?ref=modoojunko/awesome-novel-agent/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/692d1c272c671c2462067fd9c2c0043494d80534b8ee48a8dd2eeb69d0031b8e

Your agent 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.

More from modoojunko/awesome-novel-agent

awesome-novel skill
modoojunko/awesome-novel-agent · SKILL.md · 和 AI 协作写小说的工作流系统。9 个 agent 协作完成从设定到归档的完整写作流程。入口检测 → 初始化/迁移 → 交 novel-agent 调度。适用场景:从零写新小说、导入已有小说。
git:20260910.38399bc · audit A · 760 stars
AGENTS.md@templates agents
modoojunko/awesome-novel-agent · templates/AGENTS.md
git:20260828.0827fb7 · audit A · 760 stars
CLAUDE.md@templates claude
modoojunko/awesome-novel-agent · templates/CLAUDE.md
git:20260828.0827fb7 · audit A · 760 stars
AGENTS.md@templates/short agents
modoojunko/awesome-novel-agent · templates/short/AGENTS.md
git:20260910.ba4b02b · audit A · 760 stars
CLAUDE.md@templates/short claude
modoojunko/awesome-novel-agent · templates/short/CLAUDE.md
git:20260910.ba4b02b · audit A · 760 stars

Every file in modoojunko/awesome-novel-agent

Other files named AGENTS.md

AGENTS.md agents
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 291,204 stars
AGENTS.md agents
affaan-m/ecc · AGENTS.md
git:20260919.91ba9b4 · audit A · 266,832 stars
AGENTS.md agents
firecrawl/firecrawl · AGENTS.md
git:20260613.d9a35c0 · audit A · 184,144 stars
AGENTS.md agents
dietrichgebert/ponytail · AGENTS.md
git:20260710.b6c0448 · audit A · 144,862 stars
AGENTS.md agents
garrytan/gstack · AGENTS.md
git:20260914.4a3c6a8 · audit A · 134,082 stars
AGENTS.md agents
graphify-labs/graphify · AGENTS.md
git:20260414.7ec92ec · audit A · 121,202 stars
AGENTS.md agents
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 107,708 stars
AGENTS.md agents
addyosmani/agent-skills · AGENTS.md
git:20260709.b665c5c · audit A · 98,554 stars

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