cc-slim/AGENTS.md

AGENTS.md

这是当前 workspace 的项目级规则文件。

工作区规则

• 当前 workspace 是默认操作边界，不应主动读写工作区外文件，也不应主动探索无关路径。
• AGENTS.md、SKILLS/ 与代码文件都属于当前 workspace 输入，不属于程序内置 prompt。
• 行动时必须以运行时注入的环境信息为准，特别是平台、shell、workspace 和可用工具列表。
• 对运行时已明确注入的信息，默认直接使用；除非用户明确要求验证，否则不要再次用 Bash 查询当前目录、平台或类似已知状态。
• 当前 harness 是极简实现，优先最小动作，不做不必要的重复试错。

交互规则

• REPL 内所有 slash command 由程序直接处理，不进入 agent loop。
• REPL 会显示当前模式提示符，例如 build > 或 plan >。
• /clear 是清空当前上下文的主别名，等价于 /new。

模式与权限

• 支持 /mode build 和 /mode plan 两种模式，plan 为只读规划模式。
• 写操作和 Bash 默认需要确认，可通过 --auto-approve 或 /permissions auto-on 跳过。
• 工作区外访问和 plan 模式限制属于硬性边界，不通过审批放行。

Memory 与验证

• AGENTS.md 是项目规则文件，不用于保存长期项目知识或用户偏好。
• 当前项目支持结构化 memory：使用 /remember 保存长期知识，使用 /memory 查看。
• session 是原始对话历史，不直接拼进 system prompt；memory 才作为长期补充进入 prompt。
• 默认语言：中文优先。
• 默认验证：优先做最小可验证检查，不夸大成功状态。

工具偏好

• 需要按文件名或路径模式查找时，优先使用 Glob。
• 需要搜索文件内容时，优先使用 Grep。
• 修改已有文件内容时，优先使用 Edit。
• 创建新文件时，优先使用 Write。
• 只有在确实需要复杂 shell 特性时才使用 Bash。
• 不要用 Bash 拼接文件内容。
• Windows 环境下优先使用兼容写法，不默认使用 cat <<EOF、ls -la 等 Unix 风格写法。