AGENTS.md、Skills 与自定义命令

AGENTS.md

AGENTS.md 给 Droid 每次会话都带着的项目简报：如何安装、运行、测试、编辑、验证，以及留在仓库边界之内。内容应简短、具体、易验证。做法：在仓库根目录放一个 AGENTS.md，需要时再在某个包/应用/服务里放嵌套的文件；列出确切的安装、开发、测试、类型检查、lint、构建命令（宽泛命令太贵时加标志或包过滤）；写明仓库布局、生成文件规则、安全边界、所有权边界，以及 Droid 宣布完成前必须有的证明；把它提交进 git，让每个队友和自动化会话获得同样的操作上下文。典型结构：Commands、Project layout、Coding conventions、Verification（完成前运行哪些命令）。

Skills

技能封装 Droid 的可复用流程：一个包含 SKILL.md 入口的目录，加可选支持文件，以及告诉 Droid 何时适用的 frontmatter。适合比常驻的 AGENTS.md 更具体、比一次性提示更结构化、又值得复用的内容。团队共享技能放仓库的 .factory/skills/：

name: summarize-diff
description: Summarize the staged git diff in 3-5 bullets. Use when the user asks for a summary of pending changes.

# Summarize Diff
1. Run `git diff --staged`.
2. Summarize the changes in 3-5 bullets.

name 和 description 是必填 frontmatter；入口必须叫 SKILL.md。技能可由用户调用时用 /summarize-diff，也可由模型按描述自动调用；没出现时新开一个会话。disabledSkills 设置可禁用技能。官方建议：对新的可复用流程优先用 Skills。

自定义斜杠命令

Droid 扫描 .factory/commands 文件夹，把每个注册的文件变成命令：工作区 <repo>/.factory/commands（与队友共享，同名时覆盖个人命令）和个人 ~/.factory/commands。以 .md 结尾，或首行是 #! shebang 的文件才会被注册；文件名被「slug 化」（Code Review.md 变成 /code-review），可嵌套在子目录里（递归发现）。/commands 打开管理器。Markdown 命令渲染成系统通知作为 Droid 下一轮的种子，可选 frontmatter：description、argument-hint；$ARGUMENTS 展开为命令名之后输入的全部内容（不支持 $1、$2 位置占位符）；不支持工具范围限定，要限定工具用 Skills 或自定义 Droid。可执行命令必须以合法 shebang 开头，CLI 才能调用解释器。