拓冰网站定制 
【免费下载链接】gentle-aiGentle-AI configures the AI coding agents you already use: Claude Code, Cursor, OpenCode, Codex, Pi, and more. Choose persistent memory, Organic-Driven Development, curated skills, MCP servers, personas, and optional bounded review. Open source, no agent lock-in.项目地址https://gitcode.com/gh_mirrors/ge/gentle-ai点击查看免费下载本文以 docs/trigger-rules.md 为核心骨架结合 Gentle-AI 仓库内agentguidance、capabilitymanifest、review_mode.go、review_store_reset.go等源码实现系统讲解 Gentle-AI 如何把用户只描述期望结果翻译成一条最小的实现路线直接内联 / 委派直接 / 可选 SDD如何在原生进度状态与收据驱动开发Receipt-Driven Development, RDD之间保持职责边界以及如何安全地重置长期积累的评审存储。读完本文你将掌握 Gentle-AI 的路由判定标准、评审模式开关的全部命令语义、评审存储重置的预览默认 确认执行安全模型以及这些规则在安装/同步时如何被投影进每一个受支持的 Agent。一、核心原则Ask for the outcomeGentle-AI 的触发规则围绕一条核心理念展开用户只描述期望的结果outcome其余机制由系统按规则自动选择。已经在理解范围内的工作保持内联执行只有需要新鲜上下文才能受益的动作才被委派日常开发使用 Organic Driven DevelopmentODD而 SDD分离式规划工件只有在用户明确想要其独立规划产物时才被选择它从来不是消除歧义的机制。职责边界同样清晰原生 Provider 拥有验证verification、评审机制review mechanics与生命周期权威lifecycle authority——它们由 Go 原生代码驱动不依赖 Agent 的叙述。普通仓库策略ordinary repository policy拥有交付delivery——评审通过与否都不直接 commit、push、PR、release 或 archive。这条原则从源码得到印证internal/agents/capabilitymanifest/manifest.go中CanonicalImplementationRouting()定义了唯一的路由事实投影gentle-ai.implementation-routing/v1供所有适配器共享internal/components/agentguidance/routing.go的RenderRouting将其渲染成每个 Agent 的Implementation Routing指导块注释明确写到该块只携带路由语义不发表任何运行时观察、不发布生命周期权威、不激活任何远程机制因此即使离线读取的 Agent 也能正确路由工作。Quick path三步快路径用自然语言描述期望的结果。Gentle-AI 选择最小的有用实现路线直接内联direct inline、委派直接delegated direct或显式选择的 SDD。正常交互只报告Working、Checking、Ready或Needs your decision。用户不需要选择评审内部机制、哈希、收据或生命周期转换。只有在以下情况下才必须提问——回答会改变请求范围、破坏性或不可逆影响、权限或安全暴露、验证成本或外部副作用、已接受的残余风险、或交付方式。二、实现路线Implementation Routes触发规则文档给出三路判定表这是路由决策的骨架路线何时使用会发生什么直接内联Direct inline决定或验证只需要1–3 个文件或者改动是一个机械的、已被理解的文件且无需研究、没有未解决的设计决策。把有界动作保持内联。委派直接Delegated direct理解工作需要4 个文件阅读为写入做准备需要广泛研究或写作者需要改动2 个非平凡文件。委派一次窄范围探索和/或为该动作所需的一个写作者。可选 SDD用户明确想要独立的 proposal、spec、design、tasks 与 verification 工件。仅在显式请求或已接受的提议后选择永远不仅仅因为规模、歧义或风险而选择。2.1 文件计数不是风险评分文档强调这些文件计数描述的是当前动作所需的上下文规模不是风险评分也不是 SDD 阈值。风险可以强化原生验证或评审但永远不会强制 SDD。manifest.go中的规范路由事实给出了具体数字DirectInline: MinUnderstandingFiles: 1, MaxUnderstandingFiles: 3, MaxMechanicalWriteFiles: 1, DelegatedDirect: MappingMinUnderstandingFiles: 4, WriterMinNonTrivialFiles: 2, SDD: SelectionPolicy: SDDSelectionExplicitRequestOrAcceptedProposal,也就是说1–3 个文件的理解规模走内联4 个以上文件的理解触发委派映射2 个以上非平凡写入触发委派写作者SDD 的选择策略是字面意义上的explicit_request_or_accepted_proposal显式请求或已接受的提议。2.2 逐动作委派与禁止静默 SDD 入伍委派按动作per action适用。测试、构建、安装和原生评审参与者可以随时使用新的 workerfresh workers这不会改变实现路线也不会创建一个 SDD 运行。直接与委派工作都不产生 SDD 工件、阶段尝试或合成的 SDD 生命周期。如果工作暴露出不确定性应使用可选的范围化研究optional scoped research或在 ODD 内澄清受影响的决策。不要仅仅为了消除歧义而推荐 SDD——SDD 的额外阶段和工件交接只有在用户明确想要时才有用而不是大量工作的前置条件。没有任何静默 SDD 入伍silent SDD enrollment。2.3 源码级纵深强制委派触发Mandatory Delegation Triggersinternal/components/agentguidance/routing.go在渲染块中提供了比文档表格更细的强制触发语义这些触发是强制而非建议的——一旦命中就必须停下并通过运行时的 subagent 机制委派继续内联执行命中触发的工作即使成功也被视为路由缺陷映射触发Mapping trigger理解工作需要 4 个或更多文件时先委派一个窄范围探索/映射任务。写作者触发Writer trigger实现涉及 2 个或更多非平凡文件时委派一个有界写作者机械的第二个文件编辑不会仅仅因为前面改过一个文件就触发此规则。准备触发Preparation trigger为写入做准备的阅读、广泛研究或上下文压缩与写入一起或在其之前委派而不是塞满父上下文。长会话后盾Long-session backstop约 20 次工具调用、5 次探索性读取或 2 次非机械编辑后仍未委派暂停并委派下一个有界工作单元。路线声明Route declaration对大量工作在特性文档中按任务记录所选路线内联或委派与触发证据使被跳过的委派可见而非沉默。从源码结构可以推断这些触发被渲染在最小有用拓扑的宽松框架之后目的是让触发表与尽量内联的表述竞争而不是被埋没在几页之外。三、原生进度与权威Native Progress and Authority公开状态含义Working实现仍可能改变。CheckingGentle-AI 正在执行适用的功能证明与有界评审。Ready该确切候选已具备所选交付路线所需的充分证据。Needs your decision安全的自动收敛不可能Gentle-AI 呈现原因、影响与具体选项。用户依然只需要问结果。仓库身份、路线、策略、候选、交付机制与权威引用都由所有者owner-derived决定。适配器不会选择评审镜头、重建恢复策略或从叙述中推断成功。现有的 SDD v1 运行继续走其 SDD 专属状态契约直接与委派运行既不会创建也不会消费一个 SDD 运行。文档还指出对应稳定版 v2.6.0 与未发布的main禁用状态下的 SDD 会跳过评审权威并使reviewGate在结构上缺席pre-verify 继续而不路由到评审。可见时reviewGate仅具信息性SDD 归档保留真实的任务与诊断历史而不要求验证证书交付仍由普通仓库策略负责。原生兼容性命令可能报告disabled/unmanaged评审上下文但没有任何收据状态或验证结果支配交付。四、评审模式Review Mode用户拥有的开关收据驱动开发是用户拥有、默认开启opt-out、独立于实现路线的。当没有任何来源表达意见时它处于开启状态并报告为default决定。命令效果gentle-ai review mode status --cwd repo报告全局来源、clone 本地来源、决定来源与有效模式不做任何变更。gentle-ai review mode enable --scope global --cwd repo全局显式开启未来候选的收据驱动开发。gentle-ai review mode disable --cwd repo全局禁用收据驱动开发。gentle-ai review mode disable --scope clone --cwd repo仅对本 clone 禁用其他 clone 不会继承该覆盖。gentle-ai review mode enable --scope clone --cwd repo清除本 clone 的仅关闭覆盖继承全局模式或默认开启显式全局 OFF 仍然胜出。4.1 源码级语义任意 OFF 胜出、克隆只能退出internal/cli/review_mode.go的实现揭示了这些命令背后的精确语义任意禁用来源胜出Any disabled source winsclone 可以退出opt out但不能为用户要求评审。源码注释直接写明The override is off-only, so enabling clears this clones opinion instead of asserting on: a repository may never force review on.覆盖只用于关闭enable 清空 clone 的意见而非断言开启。自动化约束自动化绝不能自动切换模式也绝不能把默认值持久化为用户偏好。源码中reviewDrivenDevelopmentDisabled与AuthorizeRDDOperation是所有评审入口的强制点一个损坏的开关记录不是禁用的开关——它以失败关闭fail closed的方式解析为启用防止被篡改的记录放松任何执行点。交互式与非交互行为交互式启动在评审工作前先询问非交互 tier-1/tier-2 启动直接进行并报告如何禁用评审模式。交互式同意每个 clone 询问一次接受会记录该选择not now只适用于该候选不改变评审模式。默认 ON 的落点无来源表达意见时status的 deciding source 为default有效模式为 on且不持久化任何用户决策。在禁用状态下工作继续走直接内联、委派直接或可选 SDD 路线绝不会代用户启动、重试或重新启用评审。评审上下文在可用时可能仍然可见但它从不授权或阻塞 commit、push、PR、release 或 archive。原生交付门在不存在确切收据时报告disabled/unmanaged绝不捏造批准。4.2 状态输出示例源码中emitReviewMode定义的文本输出形状如下receipt-driven development: on (decided by default) global: unset clone-local: unset若清除 clone 覆盖后全局仍为 OFF会附加说明若开关写入只作用于当前构建也会显式说明仅对本次 gentle-ai 生效避免向只安装了半边新版本的用户报告一个正常工作的开关。五、评审存储重置Review Store Reset评审权威会无界累积每个候选都留下一个 lineage已交付的从未被移除因此长期存活的 clone 最终会持有数百条 lineage 与数百 MB 的候选检出。review abandon拒绝终态review reclaim拒绝任何持有权威工件的条目——此前一个劣化的存储没有任何出口。命令效果gentle-ai review store-reset --cwd repo按类别报告重置会移除什么、保留什么。不删除任何东西。gentle-ai review store-reset --cwd repo --confirm移除本 clone 的评审 lineage 状态。不可逆。gentle-ai review store-reset --cwd repo --confirm --include-in-flight同时移除尚未到达终态的评审。gentle-ai review store-reset --cwd repo --confirm --include-adapter-reviews同时移除适配器写入的reviews/图存储lease 与 in-flight 拒绝不覆盖它。gentle-ai review store-reset --cwd repo --json同一份报告机器可读。5.1 安全模型预览是默认确认才动手internal/cli/review_store_reset.go中的实现把这一安全模型讲得很透仅用户发起每个子动作只由用户发起没有任何适配器或自动化能触达它因为该动词不带协商合同行no negotiated contract row。预览默认 确认必须--confirm是移除任何东西的必要条件。操作不可逆且覆盖整个 clone所以凭记忆敲出的调用必须是一次只看看的调用。文档措辞Costing the user a second invocation is a much smaller price than the first mistake。clone 范围只作用于本 clone绝不触碰全局或机器级位置。5.2 移除、保留与扣留清单移除candidate-views/以及review-transactions/下的v1、v2、quarantine、effect-markers、incidents子树。候选视图是注册的 Git worktree其管理目录也会被移除但仅当每个视图自己的gitdir文件证明它属于该确切视图时才动手——绝不修剪无关 worktree。一个为某个无法移除的类别而被移开的注册会被放回若放回也失败罕见目录被保留而非删除报告会点名它、点名它被留在哪里并撤回SKIPPED 的都没被触碰的常规声明。保留收据驱动开发 kill switch 同时存在于review-mode/位置与review-transactions/rar-authority/内的 pre-#2882 镜像中以及sdd-runtime/、defect-reports/、review-artifacts/、incidents/、REVIEW-MAINTENANCE.lock。关闭的评审保持关闭。这份清单是白名单allowlist——任何命令不认识的路径包括未来版本新增的都会被报告并原样保留绝不猜测。扣留reviews/gentle-pi 适配器写入的评审图存储默认被扣留只有给出--include-adapter-reviews才移除。两个安全机制都停在该目录边缘REVIEW-MAINTENANCE.lock不覆盖其下任何路径独占 lease 不排斥那里的写者in-flight 分类只读review-transactions/v2住在那里的评审永远不会被列为开放。因此一次默认运行无法区分死图与活评审破坏性命令不会删除它无法担保的东西。该类别仍会被计量并报告在保留清单下携带原因与覆盖它的 flag。5.3 原子性、拒绝与 TUI未到达终态approved、escalated、invalidated 之外的任何状态以及任何无法解析的记录默认被拒绝并逐名列出。重置在读取存储之前就取得与其他维护操作相同的独占维护 lease使分类与它授权的移除成为一个原子步骤等待 lease 期间启动的评审会被看到并被拒绝绝不会被一次报告没有开放评审的运行销毁。每个类别要么一次性全部移除要么完全不移除——无法移开的类别带原因被报告并保持原样worktree 注册同样如此。重置在评审模式禁用时运行把清理挂在 kill switch 上会重建它本要移除的死路。TUI在主菜单Manage backups与Managed uninstall之间暴露同样的Reset review store动作确认对话框光标起始于Cancel。TUI 没有--include-in-flight或--include-adapter-reviews等价物存在开放评审时它拒绝并打印 CLI 调用方式确保销毁 in-flight 工作永远不会是一个按键的事。六、安装与刷新Installation and Refreshgentle-ai install与gentle-ai sync将同一套规范规则投影到每个受支持的适配器独立于是否选择可选 SDD 组件标准适配器在其适配器自有系统提示文件中接收托管的agent-routing标记。OpenCode 与 Kilocode 在其适配器自有opencode.json的agent.gentle-orchestrator.prompt内接收它。Jinja 支撑的适配器接收一个agent-routing.md模块由其托管的 router 模板 include。gentle-ai install # full install gentle-ai sync # refresh managed content刷新是幂等的托管投影被替换且不产生重复。6.1 源码级纵深三种投递策略internal/components/agentguidance/inject.go的实现显示投递并非为每个适配器写一个 markdown 文件那样简单而是按适配器实际加载指导的三种作用域选择策略deliveryPromptSection默认投递——托管标记节写入适配器自有系统提示文件filemerge.InjectMarkdownSection只接管被标记的节用户写在周围的内容逐字保留第二次相同注入是 no-op。deliveryJinjaModuleJinja 适配器的系统提示文件是 router其安装器每次运行都会从内嵌资产逐字重写注入到该文件的内容会在下次 sync 被销毁。因此投递为独立 include 模块agent-routing.md先 bootstrap router 模板再校验模板确实 include 了该模块requireModuleIsIncluded否则宁可失败也不报告一次装了但 Agent 永远读不到的指导。deliveryOrchestratorPromptOpenCode 族DeliversThroughOrchestratorPrompt返回 OpenCode 与 Kilocode从 settings 文档中托管的 orchestrator agent 定义读取常驻指令投递先解析整个 JSON解析不了就失败关闭绝不用空基重建而丢弃用户全部配置再把新 prompt 合并回agent.gentle-orchestrator.prompt。RoutingSectionID agent-routing刻意独立于 SDD 节因此安装或移除可选 SDD 资产永远不会增删路由指导。Codex 还会额外收到 ODD worker 的模型/reasoning_effort分配节。6.2 RDD 运行时的差异渲染RenderRouting依据model.SupportsReceiptDrivenDevelopment(agent)区分渲染只有 Claude Code、Codex、OpenCode、Pi 四个运行时收到收据驱动开发子句原生评审、其评估、用户拥有的开关其余运行时收到同一 ODD 协议但配合普通验证verification actors 而非 review actors。kill switch 也刻进每个 RDD 运行时的路由块——一个 Agent 叫不出名字的开关对用户来说就等于不存在。七、事实来源Source of Truth渲染投影出自internal/components/agentguidance/routing.go其适配器投递由internal/components/agentguidance/inject.go负责。规范路由事实出自internal/agents/capabilitymanifest/manifest.go契约包括gentle-ai.work-routing/v1、gentle-ai.review-transport/v1与gentle-ai.immutable-review-executor/v1其中评审运输与不可变评审执行者只有 Claude Code、OpenCode、Codex、Pi 四个运行时声明为 advertised其余运行时显式 dormant 并失败关闭。评审模式实现在internal/cli/review_mode.go存储重置实现在internal/cli/review_store_reset.go。当前的权威与恢复行为详见 Organic RDD 架构文档其原子事务生命周期为selectorless STATUS - exact START - bound collection/finalize - approved burn - ordinary repository policy评审完成只是关于已完成事务的证据而不是交付权威——commit、push、PR、release 与 archive 始终由普通仓库策略及其各自的显式授权管辖。八、实践速查只想看结果描述 outcome观察 Working → Checking → Ready只有在影响范围/安全/成本/交付时才回答一个问题。小改动1–3 个文件的理解规模直接内联。大规模探索或多文件写入4 文件理解、2 非平凡写入交给委派 worker。明确想要规划工件才显式选择 SDD不确定不选 SDD在 ODD 内做范围化研究或澄清。不想被评审打扰gentle-ai review mode disable临时跳过单个候选用交互提示中的 Skip this time恢复默认用gentle-ai review mode enable --scope global。存储膨胀到数百 MB先gentle-ai review store-reset --cwd repo预览确认无误后--confirm有未终态评审时按需加--include-in-flight需要清reviews/图存储时再加--include-adapter-reviews。升级或替换二进制后gentle-ai sync刷新全部托管内容幂等、可重复。赞分享【免费下载链接】gentle-aiGentle-AI configures the AI coding agents you already use: Claude Code, Cursor, OpenCode, Codex, Pi, and more. Choose persistent memory, Organic-Driven Development, curated skills, MCP servers, personas, and optional bounded review. Open source, no agent lock-in.项目地址https://gitcode.com/gh_mirrors/ge/gentle-ai点击查看免费下载相关推荐理解usearch的数据对齐内存访问效率优化技术理解usearch的数据对齐内存访问效率优化技术 在高性能向量搜索领域内存访问效率往往是决定系统性能的关键因素。usearch作为一款快速开源的向量与字符串向量数据库搜索引擎Plate 数学公式定界符触发Math Delimiter Trigger落地指南从规格拆分、输入规则实现到路线图切片Plate 数学公式定界符触发Math Delimiter Trigger落地指南从规格拆分、输入规则实现到路线图切片 本文围绕 Plate 项目中数学公前端富文本UI组件Harbor 复制规则即时触发Immediate Trigger机制与端到端验证指南Harbor 复制规则即时触发Immediate Trigger机制与端到端验证指南 导读 本文围绕 Harbor 复制Replication功能中 即后端云原生镜像仓库上一篇windows-rs实战教程用Rust开发高性能文件管理器下一篇self-hosted-ai-starter-kit常见问题解答新手入门避坑指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Gentle-AI 实施触发规则（Trigger Rules）与有机实现路由：从 Outcome 到交付的完整指南
【免费下载链接】gentle-aiGentle-AI configures the AI coding agents you already use: Claude Code, Cursor, OpenCode, Codex, Pi, and more. Choose persistent memory, Organic-Driven Development, curated skills, MCP servers, personas, and optional bounded review. Open source, no agent lock-in.项目地址https://gitcode.com/gh_mirrors/ge/gentle-ai点击查看免费下载本文以 docs/trigger-rules.md 为核心骨架结合 Gentle-AI 仓库内agentguidance、capabilitymanifest、review_mode.go、review_store_reset.go等源码实现系统讲解 Gentle-AI 如何把用户只描述期望结果翻译成一条最小的实现路线直接内联 / 委派直接 / 可选 SDD如何在原生进度状态与收据驱动开发Receipt-Driven Development, RDD之间保持职责边界以及如何安全地重置长期积累的评审存储。读完本文你将掌握 Gentle-AI 的路由判定标准、评审模式开关的全部命令语义、评审存储重置的预览默认 确认执行安全模型以及这些规则在安装/同步时如何被投影进每一个受支持的 Agent。一、核心原则Ask for the outcomeGentle-AI 的触发规则围绕一条核心理念展开用户只描述期望的结果outcome其余机制由系统按规则自动选择。已经在理解范围内的工作保持内联执行只有需要新鲜上下文才能受益的动作才被委派日常开发使用 Organic Driven DevelopmentODD而 SDD分离式规划工件只有在用户明确想要其独立规划产物时才被选择它从来不是消除歧义的机制。职责边界同样清晰原生 Provider 拥有验证verification、评审机制review mechanics与生命周期权威lifecycle authority——它们由 Go 原生代码驱动不依赖 Agent 的叙述。普通仓库策略ordinary repository policy拥有交付delivery——评审通过与否都不直接 commit、push、PR、release 或 archive。这条原则从源码得到印证internal/agents/capabilitymanifest/manifest.go中CanonicalImplementationRouting()定义了唯一的路由事实投影gentle-ai.implementation-routing/v1供所有适配器共享internal/components/agentguidance/routing.go的RenderRouting将其渲染成每个 Agent 的Implementation Routing指导块注释明确写到该块只携带路由语义不发表任何运行时观察、不发布生命周期权威、不激活任何远程机制因此即使离线读取的 Agent 也能正确路由工作。Quick path三步快路径用自然语言描述期望的结果。Gentle-AI 选择最小的有用实现路线直接内联direct inline、委派直接delegated direct或显式选择的 SDD。正常交互只报告Working、Checking、Ready或Needs your decision。用户不需要选择评审内部机制、哈希、收据或生命周期转换。只有在以下情况下才必须提问——回答会改变请求范围、破坏性或不可逆影响、权限或安全暴露、验证成本或外部副作用、已接受的残余风险、或交付方式。二、实现路线Implementation Routes触发规则文档给出三路判定表这是路由决策的骨架路线何时使用会发生什么直接内联Direct inline决定或验证只需要1–3 个文件或者改动是一个机械的、已被理解的文件且无需研究、没有未解决的设计决策。把有界动作保持内联。委派直接Delegated direct理解工作需要4 个文件阅读为写入做准备需要广泛研究或写作者需要改动2 个非平凡文件。委派一次窄范围探索和/或为该动作所需的一个写作者。可选 SDD用户明确想要独立的 proposal、spec、design、tasks 与 verification 工件。仅在显式请求或已接受的提议后选择永远不仅仅因为规模、歧义或风险而选择。2.1 文件计数不是风险评分文档强调这些文件计数描述的是当前动作所需的上下文规模不是风险评分也不是 SDD 阈值。风险可以强化原生验证或评审但永远不会强制 SDD。manifest.go中的规范路由事实给出了具体数字DirectInline: MinUnderstandingFiles: 1, MaxUnderstandingFiles: 3, MaxMechanicalWriteFiles: 1, DelegatedDirect: MappingMinUnderstandingFiles: 4, WriterMinNonTrivialFiles: 2, SDD: SelectionPolicy: SDDSelectionExplicitRequestOrAcceptedProposal,也就是说1–3 个文件的理解规模走内联4 个以上文件的理解触发委派映射2 个以上非平凡写入触发委派写作者SDD 的选择策略是字面意义上的explicit_request_or_accepted_proposal显式请求或已接受的提议。2.2 逐动作委派与禁止静默 SDD 入伍委派按动作per action适用。测试、构建、安装和原生评审参与者可以随时使用新的 workerfresh workers这不会改变实现路线也不会创建一个 SDD 运行。直接与委派工作都不产生 SDD 工件、阶段尝试或合成的 SDD 生命周期。如果工作暴露出不确定性应使用可选的范围化研究optional scoped research或在 ODD 内澄清受影响的决策。不要仅仅为了消除歧义而推荐 SDD——SDD 的额外阶段和工件交接只有在用户明确想要时才有用而不是大量工作的前置条件。没有任何静默 SDD 入伍silent SDD enrollment。2.3 源码级纵深强制委派触发Mandatory Delegation Triggersinternal/components/agentguidance/routing.go在渲染块中提供了比文档表格更细的强制触发语义这些触发是强制而非建议的——一旦命中就必须停下并通过运行时的 subagent 机制委派继续内联执行命中触发的工作即使成功也被视为路由缺陷映射触发Mapping trigger理解工作需要 4 个或更多文件时先委派一个窄范围探索/映射任务。写作者触发Writer trigger实现涉及 2 个或更多非平凡文件时委派一个有界写作者机械的第二个文件编辑不会仅仅因为前面改过一个文件就触发此规则。准备触发Preparation trigger为写入做准备的阅读、广泛研究或上下文压缩与写入一起或在其之前委派而不是塞满父上下文。长会话后盾Long-session backstop约 20 次工具调用、5 次探索性读取或 2 次非机械编辑后仍未委派暂停并委派下一个有界工作单元。路线声明Route declaration对大量工作在特性文档中按任务记录所选路线内联或委派与触发证据使被跳过的委派可见而非沉默。从源码结构可以推断这些触发被渲染在最小有用拓扑的宽松框架之后目的是让触发表与尽量内联的表述竞争而不是被埋没在几页之外。三、原生进度与权威Native Progress and Authority公开状态含义Working实现仍可能改变。CheckingGentle-AI 正在执行适用的功能证明与有界评审。Ready该确切候选已具备所选交付路线所需的充分证据。Needs your decision安全的自动收敛不可能Gentle-AI 呈现原因、影响与具体选项。用户依然只需要问结果。仓库身份、路线、策略、候选、交付机制与权威引用都由所有者owner-derived决定。适配器不会选择评审镜头、重建恢复策略或从叙述中推断成功。现有的 SDD v1 运行继续走其 SDD 专属状态契约直接与委派运行既不会创建也不会消费一个 SDD 运行。文档还指出对应稳定版 v2.6.0 与未发布的main禁用状态下的 SDD 会跳过评审权威并使reviewGate在结构上缺席pre-verify 继续而不路由到评审。可见时reviewGate仅具信息性SDD 归档保留真实的任务与诊断历史而不要求验证证书交付仍由普通仓库策略负责。原生兼容性命令可能报告disabled/unmanaged评审上下文但没有任何收据状态或验证结果支配交付。四、评审模式Review Mode用户拥有的开关收据驱动开发是用户拥有、默认开启opt-out、独立于实现路线的。当没有任何来源表达意见时它处于开启状态并报告为default决定。命令效果gentle-ai review mode status --cwd repo报告全局来源、clone 本地来源、决定来源与有效模式不做任何变更。gentle-ai review mode enable --scope global --cwd repo全局显式开启未来候选的收据驱动开发。gentle-ai review mode disable --cwd repo全局禁用收据驱动开发。gentle-ai review mode disable --scope clone --cwd repo仅对本 clone 禁用其他 clone 不会继承该覆盖。gentle-ai review mode enable --scope clone --cwd repo清除本 clone 的仅关闭覆盖继承全局模式或默认开启显式全局 OFF 仍然胜出。4.1 源码级语义任意 OFF 胜出、克隆只能退出internal/cli/review_mode.go的实现揭示了这些命令背后的精确语义任意禁用来源胜出Any disabled source winsclone 可以退出opt out但不能为用户要求评审。源码注释直接写明The override is off-only, so enabling clears this clones opinion instead of asserting on: a repository may never force review on.覆盖只用于关闭enable 清空 clone 的意见而非断言开启。自动化约束自动化绝不能自动切换模式也绝不能把默认值持久化为用户偏好。源码中reviewDrivenDevelopmentDisabled与AuthorizeRDDOperation是所有评审入口的强制点一个损坏的开关记录不是禁用的开关——它以失败关闭fail closed的方式解析为启用防止被篡改的记录放松任何执行点。交互式与非交互行为交互式启动在评审工作前先询问非交互 tier-1/tier-2 启动直接进行并报告如何禁用评审模式。交互式同意每个 clone 询问一次接受会记录该选择not now只适用于该候选不改变评审模式。默认 ON 的落点无来源表达意见时status的 deciding source 为default有效模式为 on且不持久化任何用户决策。在禁用状态下工作继续走直接内联、委派直接或可选 SDD 路线绝不会代用户启动、重试或重新启用评审。评审上下文在可用时可能仍然可见但它从不授权或阻塞 commit、push、PR、release 或 archive。原生交付门在不存在确切收据时报告disabled/unmanaged绝不捏造批准。4.2 状态输出示例源码中emitReviewMode定义的文本输出形状如下receipt-driven development: on (decided by default) global: unset clone-local: unset若清除 clone 覆盖后全局仍为 OFF会附加说明若开关写入只作用于当前构建也会显式说明仅对本次 gentle-ai 生效避免向只安装了半边新版本的用户报告一个正常工作的开关。五、评审存储重置Review Store Reset评审权威会无界累积每个候选都留下一个 lineage已交付的从未被移除因此长期存活的 clone 最终会持有数百条 lineage 与数百 MB 的候选检出。review abandon拒绝终态review reclaim拒绝任何持有权威工件的条目——此前一个劣化的存储没有任何出口。命令效果gentle-ai review store-reset --cwd repo按类别报告重置会移除什么、保留什么。不删除任何东西。gentle-ai review store-reset --cwd repo --confirm移除本 clone 的评审 lineage 状态。不可逆。gentle-ai review store-reset --cwd repo --confirm --include-in-flight同时移除尚未到达终态的评审。gentle-ai review store-reset --cwd repo --confirm --include-adapter-reviews同时移除适配器写入的reviews/图存储lease 与 in-flight 拒绝不覆盖它。gentle-ai review store-reset --cwd repo --json同一份报告机器可读。5.1 安全模型预览是默认确认才动手internal/cli/review_store_reset.go中的实现把这一安全模型讲得很透仅用户发起每个子动作只由用户发起没有任何适配器或自动化能触达它因为该动词不带协商合同行no negotiated contract row。预览默认 确认必须--confirm是移除任何东西的必要条件。操作不可逆且覆盖整个 clone所以凭记忆敲出的调用必须是一次只看看的调用。文档措辞Costing the user a second invocation is a much smaller price than the first mistake。clone 范围只作用于本 clone绝不触碰全局或机器级位置。5.2 移除、保留与扣留清单移除candidate-views/以及review-transactions/下的v1、v2、quarantine、effect-markers、incidents子树。候选视图是注册的 Git worktree其管理目录也会被移除但仅当每个视图自己的gitdir文件证明它属于该确切视图时才动手——绝不修剪无关 worktree。一个为某个无法移除的类别而被移开的注册会被放回若放回也失败罕见目录被保留而非删除报告会点名它、点名它被留在哪里并撤回SKIPPED 的都没被触碰的常规声明。保留收据驱动开发 kill switch 同时存在于review-mode/位置与review-transactions/rar-authority/内的 pre-#2882 镜像中以及sdd-runtime/、defect-reports/、review-artifacts/、incidents/、REVIEW-MAINTENANCE.lock。关闭的评审保持关闭。这份清单是白名单allowlist——任何命令不认识的路径包括未来版本新增的都会被报告并原样保留绝不猜测。扣留reviews/gentle-pi 适配器写入的评审图存储默认被扣留只有给出--include-adapter-reviews才移除。两个安全机制都停在该目录边缘REVIEW-MAINTENANCE.lock不覆盖其下任何路径独占 lease 不排斥那里的写者in-flight 分类只读review-transactions/v2住在那里的评审永远不会被列为开放。因此一次默认运行无法区分死图与活评审破坏性命令不会删除它无法担保的东西。该类别仍会被计量并报告在保留清单下携带原因与覆盖它的 flag。5.3 原子性、拒绝与 TUI未到达终态approved、escalated、invalidated 之外的任何状态以及任何无法解析的记录默认被拒绝并逐名列出。重置在读取存储之前就取得与其他维护操作相同的独占维护 lease使分类与它授权的移除成为一个原子步骤等待 lease 期间启动的评审会被看到并被拒绝绝不会被一次报告没有开放评审的运行销毁。每个类别要么一次性全部移除要么完全不移除——无法移开的类别带原因被报告并保持原样worktree 注册同样如此。重置在评审模式禁用时运行把清理挂在 kill switch 上会重建它本要移除的死路。TUI在主菜单Manage backups与Managed uninstall之间暴露同样的Reset review store动作确认对话框光标起始于Cancel。TUI 没有--include-in-flight或--include-adapter-reviews等价物存在开放评审时它拒绝并打印 CLI 调用方式确保销毁 in-flight 工作永远不会是一个按键的事。六、安装与刷新Installation and Refreshgentle-ai install与gentle-ai sync将同一套规范规则投影到每个受支持的适配器独立于是否选择可选 SDD 组件标准适配器在其适配器自有系统提示文件中接收托管的agent-routing标记。OpenCode 与 Kilocode 在其适配器自有opencode.json的agent.gentle-orchestrator.prompt内接收它。Jinja 支撑的适配器接收一个agent-routing.md模块由其托管的 router 模板 include。gentle-ai install # full install gentle-ai sync # refresh managed content刷新是幂等的托管投影被替换且不产生重复。6.1 源码级纵深三种投递策略internal/components/agentguidance/inject.go的实现显示投递并非为每个适配器写一个 markdown 文件那样简单而是按适配器实际加载指导的三种作用域选择策略deliveryPromptSection默认投递——托管标记节写入适配器自有系统提示文件filemerge.InjectMarkdownSection只接管被标记的节用户写在周围的内容逐字保留第二次相同注入是 no-op。deliveryJinjaModuleJinja 适配器的系统提示文件是 router其安装器每次运行都会从内嵌资产逐字重写注入到该文件的内容会在下次 sync 被销毁。因此投递为独立 include 模块agent-routing.md先 bootstrap router 模板再校验模板确实 include 了该模块requireModuleIsIncluded否则宁可失败也不报告一次装了但 Agent 永远读不到的指导。deliveryOrchestratorPromptOpenCode 族DeliversThroughOrchestratorPrompt返回 OpenCode 与 Kilocode从 settings 文档中托管的 orchestrator agent 定义读取常驻指令投递先解析整个 JSON解析不了就失败关闭绝不用空基重建而丢弃用户全部配置再把新 prompt 合并回agent.gentle-orchestrator.prompt。RoutingSectionID agent-routing刻意独立于 SDD 节因此安装或移除可选 SDD 资产永远不会增删路由指导。Codex 还会额外收到 ODD worker 的模型/reasoning_effort分配节。6.2 RDD 运行时的差异渲染RenderRouting依据model.SupportsReceiptDrivenDevelopment(agent)区分渲染只有 Claude Code、Codex、OpenCode、Pi 四个运行时收到收据驱动开发子句原生评审、其评估、用户拥有的开关其余运行时收到同一 ODD 协议但配合普通验证verification actors 而非 review actors。kill switch 也刻进每个 RDD 运行时的路由块——一个 Agent 叫不出名字的开关对用户来说就等于不存在。七、事实来源Source of Truth渲染投影出自internal/components/agentguidance/routing.go其适配器投递由internal/components/agentguidance/inject.go负责。规范路由事实出自internal/agents/capabilitymanifest/manifest.go契约包括gentle-ai.work-routing/v1、gentle-ai.review-transport/v1与gentle-ai.immutable-review-executor/v1其中评审运输与不可变评审执行者只有 Claude Code、OpenCode、Codex、Pi 四个运行时声明为 advertised其余运行时显式 dormant 并失败关闭。评审模式实现在internal/cli/review_mode.go存储重置实现在internal/cli/review_store_reset.go。当前的权威与恢复行为详见 Organic RDD 架构文档其原子事务生命周期为selectorless STATUS - exact START - bound collection/finalize - approved burn - ordinary repository policy评审完成只是关于已完成事务的证据而不是交付权威——commit、push、PR、release 与 archive 始终由普通仓库策略及其各自的显式授权管辖。八、实践速查只想看结果描述 outcome观察 Working → Checking → Ready只有在影响范围/安全/成本/交付时才回答一个问题。小改动1–3 个文件的理解规模直接内联。大规模探索或多文件写入4 文件理解、2 非平凡写入交给委派 worker。明确想要规划工件才显式选择 SDD不确定不选 SDD在 ODD 内做范围化研究或澄清。不想被评审打扰gentle-ai review mode disable临时跳过单个候选用交互提示中的 Skip this time恢复默认用gentle-ai review mode enable --scope global。存储膨胀到数百 MB先gentle-ai review store-reset --cwd repo预览确认无误后--confirm有未终态评审时按需加--include-in-flight需要清reviews/图存储时再加--include-adapter-reviews。升级或替换二进制后gentle-ai sync刷新全部托管内容幂等、可重复。赞分享【免费下载链接】gentle-aiGentle-AI configures the AI coding agents you already use: Claude Code, Cursor, OpenCode, Codex, Pi, and more. Choose persistent memory, Organic-Driven Development, curated skills, MCP servers, personas, and optional bounded review. Open source, no agent lock-in.项目地址https://gitcode.com/gh_mirrors/ge/gentle-ai点击查看免费下载相关推荐理解usearch的数据对齐内存访问效率优化技术理解usearch的数据对齐内存访问效率优化技术 在高性能向量搜索领域内存访问效率往往是决定系统性能的关键因素。usearch作为一款快速开源的向量与字符串向量数据库搜索引擎Plate 数学公式定界符触发Math Delimiter Trigger落地指南从规格拆分、输入规则实现到路线图切片Plate 数学公式定界符触发Math Delimiter Trigger落地指南从规格拆分、输入规则实现到路线图切片 本文围绕 Plate 项目中数学公前端富文本UI组件Harbor 复制规则即时触发Immediate Trigger机制与端到端验证指南Harbor 复制规则即时触发Immediate Trigger机制与端到端验证指南 导读 本文围绕 Harbor 复制Replication功能中 即后端云原生镜像仓库上一篇windows-rs实战教程用Rust开发高性能文件管理器下一篇self-hosted-ai-starter-kit常见问题解答新手入门避坑指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考