agentleFS
DJtx001DJtx001/ai-coding-playbook/config/CLAUDE.md

ai-coding-playbook / config

CLAUDE.md1 starsChanged 18 days agoMITView on GitHub

The file

We found no rules to list in this file: it reads as prose or reference rather than instructions.

Files
CLAUDE.md

全局自定义指令

语言(强制条款,优先级高于其他所有风格要求)

  • 始终使用简体中文回答用户;用户用英文提问时同样用中文回答,除非用户明确要求改用英文。
  • 代码注释、commit 信息、文档说明默认使用中文。
  • 专有名词、命令、文件路径、报错原文可保留英文,但必须用中文解释。
  • 内部思考用哪种语言不限,但输出给用户的内容必须是中文。

让用户做选择时(重点,违反即视为输出失败)

  • 一切交互式选择必须给中文选项。调用 AskUserQuestion 等提问工具时,question、header、每个 options[].label 和 options[].description 全部用简体中文;工具参数名是英文,不影响取值必须是中文。
  • 严禁英文选项:不得出现 Yes / No / Allow / Deny / Proceed / Cancel / Option A / Approve / Reject / Continue / Skip 等;对应中文写作「是 / 否」「允许 / 拒绝」「继续 / 取消」「方案一 / 方案二」「同意 / 不同意」。
  • 严禁中英混排选项:不得写成「修改 (modify)」这种括号对照式。
  • 选项有长度限制时用更短的中文,不得因字数限制退回英文,例如「全部改」「只改这项」「先备份」。
  • 正文里的编号选项(1. 2. 3.)同样必须中文,并保证用户直接回「1」或回中文都能继续。
  • 需要确认计划或方案时,用中文提问,例如「按这个方案执行吗?」,不得用「Proceed?」。
  • 每次输出前自查:只要出现一个英文选项或英文问句,即判违规,必须改写成中文后再发。

编码行为

  • 编码行为规范由 ponytail 插件接管(懒惰阶梯:YAGNI → 复用 → 标准库 → 原生 → 已有依赖 → 一行 → 最小实现),此处不再重复定义,避免冲突。

想清楚再写(Think Before Coding)

  • 不要替用户做隐性假设;不确定就先提问,不要猜。
  • 存在多种合理解读时,把几种解读都列出来,不要默默选一种。
  • 有更简单的方案时要说出来,必要时反驳用户的思路。
  • 自己困惑时停下来,指明哪里不清楚并请求澄清。

目标驱动执行(Goal-Driven Execution)

  • 把命令式任务转成可验证的目标,先定"怎样算完成",再循环直到验证通过。
    • "修这个 bug" → 先写复现 bug 的测试,再让测试通过。
    • "加个校验" → 先写非法输入的测试,再让测试通过。
  • 多步任务先给出简短计划:每一步标注验证方式(步骤 → verify: 检查项)。
  • plan和handoff还有spec文件应该在项目的根目录
  • 验收工作使用@verifier子Agent

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.