Ccdawn Brt

BRT

目标

BRT 是每句用户输入的默认适配层：理解真实意图、选择最具体 owner、控制流程重量，并把请求推进到可验证结果。用户不需要主动输入 /brt 或说“需求对齐”。

BRT 不是万能执行器。简单任务内部判断后直接完成；只有误解会改变行为、范围、风险或验收时，才把对齐过程展示给用户。

核心规则

• 先把用户原话翻译成可观察结果，不等待用户写完整规格。
• 用户提到项目、代码、配置、日志、测试、历史输出或运行状态时，先读会改变判断的证据，再问本地可查的问题。
• “修复 / 添加 / 优化 / 删除 / 调整”是执行许可；低风险且目标、范围、写入面和验收清楚时直接推进。
• HIGH/MEDIUM 默认直接推进；LOW 且错判会返工时集中追问并给推荐；BLOCKED 只问一个必要问题。
• 对外默认中文；代码、命令、路径、错误原文、API/协议、skill 名和枚举保留英文。
• 不为证明使用了 BRT 输出固定模板、完整账本、全量 skill 列表或流程旁白。
• 约束用于防错，不用于替代模型推理。能以同等或更强证据满足意图、安全和验证时，允许合并或跳过过程步骤。

决策管线

用户输入 -> 意图与证据 -> 置信度 -> [意图组合] -> Owner 仲裁 -> 最小充分方案 -> 流程重量 -> 执行 / 路由 / 追问

输出深度：

• SILENT：简单问答、只读查证、明确机械小改；内部判断后直接回答或执行。
• MICRO：一句话说明理解和动作，然后继续。
• ALIGN：存在高影响假设或真实行为分叉；输出一次对齐握手。
• FULL：高风险、跨阶段、迁移/权限/数据/发布或长任务；维护必要契约和状态。

意图置信度：

• HIGH：目标、对象、允许动作和成功证据清楚；SILENT/FAST_PATH 直接行动。
• MEDIUM：目标清楚但有低风险缺口；声明 1-2 个假设后继续，验证时检查假设。
• LOW：多个合理结果会导致返工；先查证或只读 probe，再讨论收敛，未稳定前不写入。
• BLOCKED：缺少必须输入、权限、对象或破坏性确认；停止并问 1 个阻塞问题。

对齐契约

开发、规划或高影响审查前，内部形成意图锁定：用户可观察结果、拥有面、非目标、关键约束、验收证据。精确形态见 references/output-forms.md。

需要用户看见时使用一次对齐握手（内部字段 One-Turn Alignment）：

我理解你要什么；我准备做什么；我不会做什么；如何证明完成；最需要纠偏的点。

• agent 先给观点、依据和推荐，再请用户校准；不空问“你怎么看”。
• 当前消息已有执行许可且无自然闸门时，握手后继续，不等待确认。
• 用户说“继续 / 确认 / 按推荐来”时，承接上一轮推荐；目标未变就不重开对齐。
• 自然闸门：意图变化、范围扩大、不可安全恢复的失败验证、破坏性/发布/迁移/权限动作、冲突或必须由用户取舍。

讨论式意图收敛

当对象指代不明、期望结果可有多种解释、审查与修改权限混在一起、约束互相冲突，或 agent 无法具体说出结果/非目标/验收时，判为 LOW。低置信度不得带着未确认的高影响假设写入或只做 owner 路由。

• 先说“我目前怎样理解、依据是什么、哪里可能理解错”，再提出推荐；不要让用户从空白重新写需求。
• 一次集中提出 2-4 个彼此相关的高影响问题，优先确认结果、范围、非目标和验收；技术细节能由代码决定就不问。
• 每个问题给出推荐答案、推荐理由、其他选择的具体行为差异和错判影响；禁止“简单版/完整版/更灵活”这类空泛选项。
• 以共同解决问题的语气讨论：允许指出矛盾、挑战低价值要求并给更好的解释，但最终行为边界由用户校准。
• 明确告诉用户可回复“按推荐”，或只纠正不对的项；已回答部分立即锁定，不逐题重复确认。
• 一轮后信息足以安全行动就结束追问；只有新答案暴露新的高影响分叉时才继续讨论。

组合与队列

只有一句话包含多个独立交付物、owner、风险边界或验证契约时才建立 Intent Bundle：

• Primary：当前推进的用户价值或阻塞项。
• Secondary：同主题、低风险、可在当前契约内顺带完成。
• Deferred：依赖 Primary、风险不同或会明显增加噪声。

“实现并验证 / 安装并检查 / 修复并汇报”默认是一个任务，不拆 Bundle。写入同一文件或模块必须顺序执行；只读且独立的信息收集才考虑并行。

审查产生多个动作时建立行动队列，再按依赖和误改风险形成修复队列：

• SAFE_DIRECT：直接修复、验证并继续下一项。
• PLAN_THEN_EXECUTE：携带证据和边界进入 ccdawn-planning。
• DEFERRED：只记录触发条件。
• BLOCKED：只问一个阻塞问题。

默认选择第一个非 DEFERRED/BLOCKED 项作为当前推进项；用户说“继续”后连续推进，直到自然闸门。

Owner 仲裁

按用户信号和证据扫描最多 3 个候选，选择能直接产出下一 artifact 和成功证据的最具体 owner。planning 和 development 是下游阶段，不能吞掉专项 owner。

常见 owner：

• bug/失败测试：ccdawn-bug-review；只有错误来源藏在深层链路时才加 root-cause-tracing。
• PR/diff：ccdawn-pr-review；项目/架构/技术债：ccdawn-project-review。
• 当前 diff 的过度设计/删减空间：ccdawn-simplification-review；整仓或子系统的冗余复杂度：ccdawn-simplification-audit。
• UI/UX/响应式/视觉验证：ccdawn-ui-design。
• 同项目会话状态、冲突、讨论/合并：ccdawn-thread-coordination。
• 开发残留、已合并本地分支、废弃 worktree/claim：ccdawn-development-cleanup。
• AI/ML 研究工程、论文 baseline 复现、多轮消融和研究方向收敛：ccdawn-ai-research-loop；已定义好的单条 score/benchmark lane：ccdawn-score-loop；重要 baseline/claim 晋升：ccdawn-research-rigor-review。复杂功能外部复用：ccdawn-feature-reuse-research。
• 方案：ccdawn-planning；无专项 owner 的评价：ccdawn-evaluation。
• FASTPATH 和有界 COMPACTFLOW 由当前 owner 验证收口；FULL_FLOW、恢复、跨阶段汇总或正式交接才使用 ccdawn-completion-summary。

完整场景仅在路由犹豫时读取 references/routing-practice.md。外部 skill 只有本轮已安装或用户要求安装/使用时才能成为 owner；否则使用本地 fallback。候选资料按需读取 references/github-skill-candidates.md。

路由契约（内部字段 Route Contract）只保留：Owner / Mode / Next Output / Allowed Action / Success Evidence / Stop Condition。下一产出或成功证据说不清时，先 probe 或问一个关键问题。

组合 owner 必须有主次：正确性、需求覆盖、合并准备由 review owner 主责；只有目标明确指向删减或过度设计时，精简 owner 才主责。不要为每次开发追加精简报告。

最小充分方案

Owner 仲裁后按顺序停在第一个足以满足意图锁定的层级：

1. NO_BUILD：现有行为已经满足，直接验证或解释。
2. PROJECT_REUSE：复用项目已有 helper、组件、模式或测试工具。
3. STANDARD_NATIVE：使用标准库、浏览器、数据库或平台原生能力。
4. INSTALLED_DEPENDENCY：已安装依赖更适合且总体成本更低。
5. MINIMAL_BUILD：只写完成可观察结果需要的最少逻辑和文件。

按简化后的剩余工作判断复杂度；文件数和 skill 数不代表复杂。跨文件机械替换仍可算一个单元，复杂 bug 优先修共享根因。

只有外部候选会实质改变方案时才做 QUICK_RESEARCH/FULL_REUSE_RESEARCH；高风险或“功能常见”本身不触发联网研究。用户明确从零实现、功能高度私有或复用成本更高时 SKIP_WITH_REASON。

最小不能删除：用户明确要求、信任边界校验、防止数据丢失的错误处理、安全、无障碍、兼容/迁移约束和真实硬件校准。本闸门借鉴 DietrichGebert/ponytail（MIT），不引入其插件或 hooks。

自动精简强度

默认 AUTO，由 agent 按当前实现单元自动选择，不要求用户切换模式，也不跨会话持久化：

• LITE：简单问答、机械小改、明确 bug 修复；只应用最小充分方案，不增加专项审查。
• FULL：非平凡功能、重构或方案；检查复用、依赖、抽象和文件数是否必要，但不单独输出流程旁白。
• ULTRA：用户目标就是强力精简、删除冗余、治理依赖或审计过度设计；使用对应精简 owner，并要求行为保持证据。
• OFF：只有用户明确要求保留既定架构/扩展层，或兼容迁移契约禁止收缩时使用；仍保留 Wrong-Edit Guard 和安全验证。

按子任务重新评估强度，同一请求可以 LITE 修小项、FULL 做核心实现、ULTRA 审计特定模块。强度只调节简化力度，不得覆盖意图锁定、用户约束或安全边界。

流程重量

• FAST_PATH：剩余一个低风险、可逆、可本地验证的实现单元；轻量实现和必要验证，不 planning、不拆分、不 BDD/TDD。
• COMPACT_FLOW：剩余多个相关单元但仍适合一个推理上下文；连续推进，只在拆分会改变依赖、owner、风险或验证时进入 ccdawn-task-splitting。
• FULL_FLOW：仍有真实设计分叉、跨边界状态/契约、安全/数据/迁移/权限/发布风险；只产生解决这些风险所需的 artifact，不等于执行所有阶段。

FULL_FLOW: 意图锁定 -> Owner -> 最小充分方案
-> [必要时 research / planning / splitting / compact TDD]
-> 实施 -> 风险相称的验证 -> 静默清理检查 -> [必要时 cleanup / review / handoff]

• BDD/TDD 只分配给预期行为确定、易发生软件回归、跨工程契约或用户明确要求严格流程的子任务，不给整个请求贴标签；metric 结果未知的实验不适用。
• planning 只在内部选择 1-3 个与当前风险直接相关的视角；有真实缺口才修正或展示，不输出空矩阵。
• 新 worktree 只用于并行、冲突隔离、高风险隔离或用户明确要求。
• 多会话路由 ccdawn-thread-coordination；先读 registry。pause 产生恢复债务；owner 仅在 resolve 且 resumePendingAgentIds 清零后结束，失活先接管。
• 代码写入型开发通过验证后必须做静默清理检查；没有候选记为 NOOP，有临时残留、已吸收 branch、废弃 worktree 或 claim 时路由 ccdawn-development-cleanup。合并前允许 DEFERRED_INTEGRATION，合并后再收尾。
• 长任务、恢复、阻塞、跨阶段交接和完整状态规则读取 references/runtime.md。

能力感知与阶段折叠

默认按高推理能力模型运行，不绑定具体型号名称：模型可以在内部完成意图推断、局部规划、依赖排序和自审。skill 提供领域知识与防错边界，不要求模型把内部推理展开成用户可见流程。

• 结果约束优先：Intent、owned surface、非目标、安全边界、成功证据是硬约束；模板、阶段、文档、角色数量和固定顺序只有能防止具体失败时才保留。
• 阶段折叠：同一 owner、同一上下文、无自然闸门时，可在一个回合内完成对齐、内部规划、实施和验证。planning、task splitting、summary 不因“流程完整”而单独调用。
• Skill Budget：默认一个 primary owner。support skill 只有提供 primary 不具备的知识、工具或独立证据时才加载；功能重叠的 skill 不并用。
• Artifact Budget：只在审阅、交接、长任务恢复或高风险决策需留痕时生成方案、Task Graph、ledger 或矩阵。
• Process Cost Gate：调用下游步骤前，先问“它防止什么具体错误、产物会被谁使用、成本是否低于返工风险”；答不出来就跳过。
• 内部自审：模型先自行检查需求覆盖、误改范围和验证证据；没有 finding 或真实取舍时，不输出角色扮演式多视角审查。

Superpowers 默认不参与自动路由；安装器只关闭其发现入口并保留原文件。用户显式恢复或点名某个方法时，它仍只能作为当前 owner 的可选方法，any/every/always/1% chance 不能升级 BRT 模式或授权完整下游链：

• FAST_PATH 直接执行并最小验证；不进入 brainstorming、planning、新 worktree、严格 TDD、子代理审查或分支菜单。
• COMPACT_FLOW 只选能改变正确性或误改风险的方法；FULL_FLOW 也允许折叠已有 artifact 和重复确认。
• 复杂工程子任务只用 ccdawn-bdd-tdd-development 紧凑 TDD，不重复加载 Superpowers TDD；实验候选保持 BASELINE/CANDIDATE/DELTA/GATE，只有确定性工具 bug 临时嵌套 TDD。
• 子代理默认 0 个；独立 lane 才派一个紧凑实现 agent。主 agent 验证 diff 和证据，仅高风险最终边界增加一个 reviewer，禁止子代理再派发。
• 完成声明由当前 owner 提供风险相称的新鲜证据；只有真实分支集成、发布或回滚决策才展示对应选项。

用户明确要求严格流程，或项目规则、安全/数据/权限/迁移/发布风险要求特定步骤时，保留相应防线；不要用“模型很聪明”跳过真实风险。

执行与防误改

写入前内部建立紧凑执行契约：Target / Desired Outcome / Allowed Actions / Out of Scope / Success Evidence / Recovery Signal。

Wrong-Edit Guard：

• 定位 owning surface、预计文件、相关测试和已有用户/agent 改动。
• 明确保护边界；只改完成契约需要的最小集合，不顺带格式化、换依赖、改配置或修相邻问题。
• 归属不清先读证据；仍不清才 probe 或询问。
• 验证失败先分为 implementation / test intent / environment / requirement mismatch；契约内可安全修复就修并重验，不为过测试削弱行为。

评审只在会改变结论时内部选择 1-3 个相关视角；没有 finding 不输出矩阵。NEEDS_CHANGE 能在契约内修正就修正并重验；只有 NEEDS_CLARIFICATION、越界修正或 blocker 才暂停。细则见 references/review-test.md。

FASTPATH 和有界 COMPACTFLOW 用当前 owner 的新鲜证据完成；FULL_FLOW、恢复、阻塞、跨 agent/stage 或有 Deferred 项时才维护 ledger/summary。不要因为回复数或文件数创建账本。

输出与收口

• SILENT/MICRO 不展示模板；ALIGN/FULL 也默认短格式。
• 外部 skill 的安全语义、步骤顺序和选项数量保持不变，但用户可见标题、解释、菜单和下一步建议翻译成中文。
• 精确对齐、问题、Intent Lock、队列、planning handoff、外部菜单和收口形态统一读取 references/output-forms.md。
• 每个阶段完成只给短 checkpoint；目标未变不反复请求“是否继续”。
• COMPLETED 需要当前路线的新鲜成功证据，且清理检查为 CLEAN / NOOP，或尚未集成时明确为 DEFERRED_INTEGRATION；MERGE_READY 需要 ccdawn-pr-review 的 diff/PR 证据。
• 正文最后一行（Next Action）：下一步建议: 。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: CCDawn
• Source: CCDawn/codex-skills
• License: MIT
• Homepage: https://skills.sh/CCDawn/codex-skills

Install and usage instructions live in the source repository linked above.