cam-douglas/agent-instructions 源代码：https://github.com/cam-douglas/agent-instructions

Agent 指令

一个可移植、与 Agent 无关的控制平面，专为编码 Agent 设计。将其放入任何仓库，即可为你的 Agent 提供一致的操作规则、分阶段项目规划、记忆、技能和操作手册。

本仓库以 .cursor/ 为参考布局提供文件。在使用前将该文件夹重命名 以匹配你的 Agent。

快速开始

1. 复制到你的项目

将整个文件夹复制到你的项目仓库根目录：

text 你的项目/
.cursor/ ← 在步骤 2 中重命名
src/
package.json
...

2. 为你的 Agent 重命名

将 .cursor 重命名为你的编码 Agent 所期望的名称：

内容保持不变，仅更改目录名称。

Cursor 用户： 保持文件夹名为 .cursor。rules/*.mdc 文件会自动加载，并应用 alwaysApply: true。 其他 Agent： 将你的 Agent 指向重命名文件夹内的 AGENTS.md（系统提示、项目指令或规则文件，具体取决于你的工具支持）。rules/ 文件是简洁的强制执行片段；如果你的 Agent 能加载规则文件，则加载它们，否则仅依赖 AGENTS.md。

3. 引导工作区

从项目根目录运行：

bash .your-agent/scripts/bootstrap.sh

将 .your-agent 替换为你的实际文件夹名称。该脚本是幂等的——每次新会话运行都是安全的。它会创建 docs/ 脚手架（计划、蓝图、决策、交接），而不会覆盖现有项目文件。

4. 启动你的 Agent

在新会话的第一条消息中，告诉你的 Agent：

读取 Agent 配置文件夹中的 AGENTS.md，运行 scripts/bootstrap.sh，然后遵循每轮读取契约。

Agent 将从那里开始处理启动。

你将获得

text /
AGENTS.md            # 规范操作契约——从此处开始
BOOTSTRAP.md         # 会话启动流程
INSTRUCTIONS.md      # 路由到详细任务模式
USER.md              # 你的持久偏好（编辑此项）
STATE.md             # 当前目标、阶段、计划、阻碍项
SKILLS.md + skills/  # 可重复执行的过程（Vercel、Supabase 等）
TOOLS.md             # 功能注册表
instructions/        # 项目规划、策略、子 Agent
memory/              # 持久记忆、阻碍项、操作手册、延续日志
rules/               # 始终生效的强制执行（Cursor 原生 .mdc）
scripts/bootstrap.sh # 幂等工作区实体化
templates/           # 阶段计划和文档模板
config/settings.json # 可选的主机特定设置

引导后，你的仓库还会得到：

text
docs/
  plans/             # 顺序阶段计划 + 最终检查清单
  blueprints/        # 产品/策略输出
  decisions/         # 架构决策记录
  handover/          # 操作交接

工作原理

1. AGENTS.md 定义了优先级、自主限制、分阶段生命周期以及每轮读取契约。
2. INSTRUCTIONS.md 仅在需要时激活详细模式（项目规划、策略、子 Agent）。
3. STATE.md 跟踪正在进行的工作，以便工作能够在会话间的上下文丢失中幸存。
4. memory/ 存储阻碍项、操作手册和带日期的延续日志——不存储秘密。
5. skills/ 保存从操作手册提升的稳定、可重复的多步骤过程。

对于新项目或主要功能，Agent 首先创建 docs/plans/phase_0_foundations_plan.md，然后每次生成一个阶段计划，直到 final_implementation_checklist.md 关闭剩余仅针对人工的工作。

为你自定义

编辑以下文件以匹配你的工作流：

• USER.md —— 常规指令、平台偏好、部署默认值
• STATE.md —— 重置或恢复正在进行的工作
• memory/MEMORY.md —— 持久决策和架构说明
• config/settings.json —— 可选的编辑器/主机设置

不要在任何这些文件中存储密码、令牌或 API 密钥。

包含的技能

在 skills/<技能名>/SKILL.md 下添加你自己的技能，并在 SKILLS.md 中注册它们。

许可证

MIT —— 参见 LICENSE。