镜像自 HugoXK/LaunchPad@5cfa983 · upstream · 在 GitHub 上编辑 docs/prompts/README.md ↗

内置场景规则

本目录的 Markdown 是 Bot 的内置规则层,manager-dispatch.md 是完整的 Manager 分派默认提示词,其他文件用于各任务的内置规则。控制面启动时由 src/rules/service.ts 按文件读入 defaults(onboarding.md 除外:它由 src/management/onboarding.ts 读入,作为仓库接入向导的系统提示词,不是规则层,也不能覆盖),规则接口、Manager 页的「内置文本」和模型系统提示用的都是这里的原文;运行镜像把本目录复制到 /app/docs/prompts。修改这些文件就是修改所有没有写对应章节的项目的默认行为。项目可以把 定时检查章节的建议文本 自行写入 Manager「定时检查」章节;那份文本必须留在 docs/ 下作为模板,不得加入本目录或登记为内置提示词(该章节默认保持为空,以免撑破管理助手单次工具结果的 256 KiB 上限)。

文件对应

文件 Manager 章节 作用
labels.md labels 检视标签的用法;从仓库已有标签里为 Issue 和 PR 选择 type、source、priority、area、size 等分类标签,由控制面校验后添加;分类不等于授权
issue-review.md review.issue 新 Issue 的意图、缺失信息、代码证据与授权判断,以及哪些检视结果会启动开发
pr-review.md review.pr PR 检视:一轮报全、严重度与处置、复审收敛、相关性判断、COMMENT 输出
issue-development.md development 开发任务的资格、范围、停止条件、测试与 PR 说明
release-observe.md CI 观察章节 CI 观察的提示词:读取运行、分析日志与代码、给出结论
manager-dispatch.md dispatch 每个事件新建、续接还是不处理的默认流程
onboarding.md 无,不可覆盖 仓库接入向导:管理助手只读分析一个仓库,给出仓库画像、带推荐答案的问题和接入方案草稿,见管理助手

三份检视和开发规则、CI 观察提示词以及接入向导提示词各带一张 ```mermaid 流程图(检视:检视 → 回复;开发:Issue 分析 → 开发 → 检视 → 测试,检视或测试发现问题时回到开发;接入:读仓库 → 画像 → 提问 → 方案),给 agent 说明步骤顺序,见项目 Manager 与工作类型。

行为指南(guide 章节)的内置内容在 src/rules/service.ts 中;代码里这几条规则仍以它们替代的 .bot/ 文件路径为键,但仓库里的 .bot/ 文件已不再读取(#935)。

覆盖方式

在项目「角色 → Manager」的 Manager 提示词里写对应章节,整份替换内置文本,不限大小;只影响之后新建的任务。检视标签和开发标签的名字是项目设置(「项目设置 → 基本 → 标签」,默认 bot-reviewed/bot-develop),不写在这些文本里;模型在 labels 和 development 章节开头读到它们。完整说明见在角色配置里调整行为。开发标签是开发的依据之一(另有维护者在评论里的要求和 Manager 提示词里的规则,#815);不想自动开发就把项目能力上限设在「可开发并开 PR」以下。

适配边界

文本最初整理自一个仓库已在运行的检视与认领规则,作为内置默认时做了这些调整: