paseo-req-kit 1.14.0 → 1.15.0-beta.3

package/site-dist/assets/{reference_adr_0005-no-default-branch-local-commits-only.md.CkImA4s6.js → reference_adr_0005-no-default-branch-local-commits-only.md.DeXnMAyg.js}

@@ -1 +1 @@
-import{_ as e,o as t,c as o,a3 as r}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0005 不在默认分支上运行，只做本地提交","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0005-no-default-branch-local-commits-only.md","filePath":"reference/adr/0005-no-default-branch-local-commits-only.md","lastUpdated":null}'),l={name:"reference/adr/0005-no-default-branch-local-commits-only.md"};function n(i,a,c,d,s,h){return t(),o("div",null,[...a[0]||(a[0]=[r('<div><h1 id="_0005-不在默认分支上运行-只做本地提交" tabindex="-1">0005 不在默认分支上运行，只做本地提交 <a class="header-anchor" href="#_0005-不在默认分支上运行-只做本地提交" aria-label="Permalink to &quot;0005 不在默认分支上运行，只做本地提交&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>流水线无人值守地修改和提交代码，合并上线必须由人决定。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>拒绝在默认分支（main、master、origin/HEAD 指向的分支）和 detached HEAD 上启动；续跑时分支必须与上次一致；步骤只做本地提交，不 push、不合并。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>推荐每个需求一个 worktree 工作区。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0005-no-default-branch-local-commits-only.md">docs/adr/0005-no-default-branch-local-commits-only.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0005-no-default-branch-local-commits-only.md">在 GitHub 上编辑</a></p>',2)])])}const f=e(l,[["render",n]]);export{u as __pageData,f as default};
+import{_ as e,o as t,c as o,a2 as r}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0005 不在默认分支上运行，只做本地提交","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0005-no-default-branch-local-commits-only.md","filePath":"reference/adr/0005-no-default-branch-local-commits-only.md","lastUpdated":null}'),l={name:"reference/adr/0005-no-default-branch-local-commits-only.md"};function n(i,a,c,d,s,h){return t(),o("div",null,[...a[0]||(a[0]=[r('<div><h1 id="_0005-不在默认分支上运行-只做本地提交" tabindex="-1">0005 不在默认分支上运行，只做本地提交 <a class="header-anchor" href="#_0005-不在默认分支上运行-只做本地提交" aria-label="Permalink to &quot;0005 不在默认分支上运行，只做本地提交&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>流水线无人值守地修改和提交代码，合并上线必须由人决定。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>拒绝在默认分支（main、master、origin/HEAD 指向的分支）和 detached HEAD 上启动；续跑时分支必须与上次一致；步骤只做本地提交，不 push、不合并。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>推荐每个需求一个 worktree 工作区。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0005-no-default-branch-local-commits-only.md">docs/adr/0005-no-default-branch-local-commits-only.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0005-no-default-branch-local-commits-only.md">在 GitHub 上编辑</a></p>',2)])])}const f=e(l,[["render",n]]);export{u as __pageData,f as default};

package/site-dist/assets/{reference_adr_0005-no-default-branch-local-commits-only.md.CkImA4s6.lean.js → reference_adr_0005-no-default-branch-local-commits-only.md.DeXnMAyg.lean.js}

@@ -1 +1 @@
-import{_ as e,o as t,c as o,a3 as r}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0005 不在默认分支上运行，只做本地提交","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0005-no-default-branch-local-commits-only.md","filePath":"reference/adr/0005-no-default-branch-local-commits-only.md","lastUpdated":null}'),l={name:"reference/adr/0005-no-default-branch-local-commits-only.md"};function n(i,a,c,d,s,h){return t(),o("div",null,[...a[0]||(a[0]=[r("",2)])])}const f=e(l,[["render",n]]);export{u as __pageData,f as default};
+import{_ as e,o as t,c as o,a2 as r}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0005 不在默认分支上运行，只做本地提交","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0005-no-default-branch-local-commits-only.md","filePath":"reference/adr/0005-no-default-branch-local-commits-only.md","lastUpdated":null}'),l={name:"reference/adr/0005-no-default-branch-local-commits-only.md"};function n(i,a,c,d,s,h){return t(),o("div",null,[...a[0]||(a[0]=[r("",2)])])}const f=e(l,[["render",n]]);export{u as __pageData,f as default};

package/site-dist/assets/{reference_adr_0006-skill-install-targets.md.CwY8YepV.js → reference_adr_0006-skill-install-targets.md.CwqvB8NW.js}

@@ -1 +1 @@
-import{_ as e,o as l,c as s,a3 as t}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0006 只安装到 ~/.agents/skills 和 ~/.claude/skills","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0006-skill-install-targets.md","filePath":"reference/adr/0006-skill-install-targets.md","lastUpdated":null}'),i={name:"reference/adr/0006-skill-install-targets.md"};function r(d,a,n,o,c,k){return l(),s("div",null,[...a[0]||(a[0]=[t('<div><h1 id="_0006-只安装到-agents-skills-和-claude-skills" tabindex="-1">0006 只安装到 ~/.agents/skills 和 ~/.claude/skills <a class="header-anchor" href="#_0006-只安装到-agents-skills-和-claude-skills" aria-label="Permalink to &quot;0006 只安装到 ~/.agents/skills 和 ~/.claude/skills&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>Paseo 运行各 agent 自己的命令行工具。~/.agents/skills 被 Codex、Pi、OpenCode 读取；Claude Code 读 ~/.claude/skills。同时装到更多目录会让同一个 skill 出现多份。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>默认安装到 ~/.agents/skills，以及存在时的 ~/.claude/skills；其他目录用 --target 追加并被记住。暂不安装到 ~/.codex/skills。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>覆盖四种 agent。Codex 的触发方式需要在真实环境中确认。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0006-skill-install-targets.md">docs/adr/0006-skill-install-targets.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0006-skill-install-targets.md">在 GitHub 上编辑</a></p>',2)])])}const p=e(i,[["render",r]]);export{u as __pageData,p as default};
+import{_ as e,o as l,c as s,a2 as t}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0006 只安装到 ~/.agents/skills 和 ~/.claude/skills","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0006-skill-install-targets.md","filePath":"reference/adr/0006-skill-install-targets.md","lastUpdated":null}'),i={name:"reference/adr/0006-skill-install-targets.md"};function r(d,a,n,o,c,k){return l(),s("div",null,[...a[0]||(a[0]=[t('<div><h1 id="_0006-只安装到-agents-skills-和-claude-skills" tabindex="-1">0006 只安装到 ~/.agents/skills 和 ~/.claude/skills <a class="header-anchor" href="#_0006-只安装到-agents-skills-和-claude-skills" aria-label="Permalink to &quot;0006 只安装到 ~/.agents/skills 和 ~/.claude/skills&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>Paseo 运行各 agent 自己的命令行工具。~/.agents/skills 被 Codex、Pi、OpenCode 读取；Claude Code 读 ~/.claude/skills。同时装到更多目录会让同一个 skill 出现多份。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>默认安装到 ~/.agents/skills，以及存在时的 ~/.claude/skills；其他目录用 --target 追加并被记住。暂不安装到 ~/.codex/skills。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>覆盖四种 agent。Codex 的触发方式需要在真实环境中确认。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0006-skill-install-targets.md">docs/adr/0006-skill-install-targets.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0006-skill-install-targets.md">在 GitHub 上编辑</a></p>',2)])])}const p=e(i,[["render",r]]);export{u as __pageData,p as default};

package/site-dist/assets/{reference_adr_0006-skill-install-targets.md.CwY8YepV.lean.js → reference_adr_0006-skill-install-targets.md.CwqvB8NW.lean.js}

@@ -1 +1 @@
-import{_ as e,o as l,c as s,a3 as t}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0006 只安装到 ~/.agents/skills 和 ~/.claude/skills","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0006-skill-install-targets.md","filePath":"reference/adr/0006-skill-install-targets.md","lastUpdated":null}'),i={name:"reference/adr/0006-skill-install-targets.md"};function r(d,a,n,o,c,k){return l(),s("div",null,[...a[0]||(a[0]=[t("",2)])])}const p=e(i,[["render",r]]);export{u as __pageData,p as default};
+import{_ as e,o as l,c as s,a2 as t}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0006 只安装到 ~/.agents/skills 和 ~/.claude/skills","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0006-skill-install-targets.md","filePath":"reference/adr/0006-skill-install-targets.md","lastUpdated":null}'),i={name:"reference/adr/0006-skill-install-targets.md"};function r(d,a,n,o,c,k){return l(),s("div",null,[...a[0]||(a[0]=[t("",2)])])}const p=e(i,[["render",r]]);export{u as __pageData,p as default};

package/site-dist/assets/{reference_adr_0007-own-interview-skill.md.CryhxRyG.js → reference_adr_0007-own-interview-skill.md.HlLp78db.js}

@@ -1 +1 @@
-import{_ as i,o as a,c as l,a3 as t}from"./chunks/framework.B9qR_F1m.js";const m=JSON.parse('{"title":"0007 自带需求访谈 skill，不依赖外部 skill 包","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0007-own-interview-skill.md","filePath":"reference/adr/0007-own-interview-skill.md","lastUpdated":null}'),r={name:"reference/adr/0007-own-interview-skill.md"};function n(s,e,o,d,c,k){return a(),l("div",null,[...e[0]||(e[0]=[t('<div><h1 id="_0007-自带需求访谈-skill-不依赖外部-skill-包" tabindex="-1">0007 自带需求访谈 skill，不依赖外部 skill 包 <a class="header-anchor" href="#_0007-自带需求访谈-skill-不依赖外部-skill-包" aria-label="Permalink to &quot;0007 自带需求访谈 skill，不依赖外部 skill 包&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>脚本版依赖 Matt Pocock 的 grilling 和 domain-modeling。后者已把术语文件从 CONTEXT.md 改为 GLOSSARY.md，说明外部依赖的文件约定会漂移。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>req-kit 自带 requirement-interview，术语写入 GLOSSARY.md，读取时兼容 CONTEXT.md。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>安装少一步，行为由 req-kit 自己掌控和评估。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0007-own-interview-skill.md">docs/adr/0007-own-interview-skill.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0007-own-interview-skill.md">在 GitHub 上编辑</a></p>',2)])])}const p=i(r,[["render",n]]);export{m as __pageData,p as default};
+import{_ as i,o as a,c as l,a2 as t}from"./chunks/framework.BetZR81g.js";const m=JSON.parse('{"title":"0007 自带需求访谈 skill，不依赖外部 skill 包","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0007-own-interview-skill.md","filePath":"reference/adr/0007-own-interview-skill.md","lastUpdated":null}'),r={name:"reference/adr/0007-own-interview-skill.md"};function n(s,e,o,d,c,k){return a(),l("div",null,[...e[0]||(e[0]=[t('<div><h1 id="_0007-自带需求访谈-skill-不依赖外部-skill-包" tabindex="-1">0007 自带需求访谈 skill，不依赖外部 skill 包 <a class="header-anchor" href="#_0007-自带需求访谈-skill-不依赖外部-skill-包" aria-label="Permalink to &quot;0007 自带需求访谈 skill，不依赖外部 skill 包&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>脚本版依赖 Matt Pocock 的 grilling 和 domain-modeling。后者已把术语文件从 CONTEXT.md 改为 GLOSSARY.md，说明外部依赖的文件约定会漂移。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>req-kit 自带 requirement-interview，术语写入 GLOSSARY.md，读取时兼容 CONTEXT.md。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>安装少一步，行为由 req-kit 自己掌控和评估。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0007-own-interview-skill.md">docs/adr/0007-own-interview-skill.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0007-own-interview-skill.md">在 GitHub 上编辑</a></p>',2)])])}const p=i(r,[["render",n]]);export{m as __pageData,p as default};

package/site-dist/assets/{reference_adr_0007-own-interview-skill.md.CryhxRyG.lean.js → reference_adr_0007-own-interview-skill.md.HlLp78db.lean.js}

@@ -1 +1 @@
-import{_ as i,o as a,c as l,a3 as t}from"./chunks/framework.B9qR_F1m.js";const m=JSON.parse('{"title":"0007 自带需求访谈 skill，不依赖外部 skill 包","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0007-own-interview-skill.md","filePath":"reference/adr/0007-own-interview-skill.md","lastUpdated":null}'),r={name:"reference/adr/0007-own-interview-skill.md"};function n(s,e,o,d,c,k){return a(),l("div",null,[...e[0]||(e[0]=[t("",2)])])}const p=i(r,[["render",n]]);export{m as __pageData,p as default};
+import{_ as i,o as a,c as l,a2 as t}from"./chunks/framework.BetZR81g.js";const m=JSON.parse('{"title":"0007 自带需求访谈 skill，不依赖外部 skill 包","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0007-own-interview-skill.md","filePath":"reference/adr/0007-own-interview-skill.md","lastUpdated":null}'),r={name:"reference/adr/0007-own-interview-skill.md"};function n(s,e,o,d,c,k){return a(),l("div",null,[...e[0]||(e[0]=[t("",2)])])}const p=i(r,[["render",n]]);export{m as __pageData,p as default};

package/site-dist/assets/{reference_adr_0008-entries-do-not-call-entries.md.DsRWAgeA.js → reference_adr_0008-entries-do-not-call-entries.md.D2VH2uQV.js}

@@ -1 +1 @@
-import{_ as a,o as t,c as r,a3 as i}from"./chunks/framework.B9qR_F1m.js";const _=JSON.parse('{"title":"0008 入口 skill 之间不互相调用","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0008-entries-do-not-call-entries.md","filePath":"reference/adr/0008-entries-do-not-call-entries.md","lastUpdated":null}'),l={name:"reference/adr/0008-entries-do-not-call-entries.md"};function o(s,e,n,d,c,h){return t(),r("div",null,[...e[0]||(e[0]=[i('<div><h1 id="_0008-入口-skill-之间不互相调用" tabindex="-1">0008 入口 skill 之间不互相调用 <a class="header-anchor" href="#_0008-入口-skill-之间不互相调用" aria-label="Permalink to &quot;0008 入口 skill 之间不互相调用&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>入口（/req、/req-doctor 等）由用户触发。一个入口调用另一个入口，会让行为难以预期，也难以单独评估。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>入口可以调用方法 skill、引用原则、执行引擎命令；需要另一个入口时，告诉用户去运行它。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>每个入口的行为可以独立预期和测试。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0008-entries-do-not-call-entries.md">docs/adr/0008-entries-do-not-call-entries.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0008-entries-do-not-call-entries.md">在 GitHub 上编辑</a></p>',2)])])}const f=a(l,[["render",o]]);export{_ as __pageData,f as default};
+import{_ as a,o as t,c as r,a2 as i}from"./chunks/framework.BetZR81g.js";const _=JSON.parse('{"title":"0008 入口 skill 之间不互相调用","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0008-entries-do-not-call-entries.md","filePath":"reference/adr/0008-entries-do-not-call-entries.md","lastUpdated":null}'),l={name:"reference/adr/0008-entries-do-not-call-entries.md"};function o(s,e,n,d,c,h){return t(),r("div",null,[...e[0]||(e[0]=[i('<div><h1 id="_0008-入口-skill-之间不互相调用" tabindex="-1">0008 入口 skill 之间不互相调用 <a class="header-anchor" href="#_0008-入口-skill-之间不互相调用" aria-label="Permalink to &quot;0008 入口 skill 之间不互相调用&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>入口（/req、/req-doctor 等）由用户触发。一个入口调用另一个入口，会让行为难以预期，也难以单独评估。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>入口可以调用方法 skill、引用原则、执行引擎命令；需要另一个入口时，告诉用户去运行它。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>每个入口的行为可以独立预期和测试。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0008-entries-do-not-call-entries.md">docs/adr/0008-entries-do-not-call-entries.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0008-entries-do-not-call-entries.md">在 GitHub 上编辑</a></p>',2)])])}const f=a(l,[["render",o]]);export{_ as __pageData,f as default};

package/site-dist/assets/{reference_adr_0008-entries-do-not-call-entries.md.DsRWAgeA.lean.js → reference_adr_0008-entries-do-not-call-entries.md.D2VH2uQV.lean.js}

@@ -1 +1 @@
-import{_ as a,o as t,c as r,a3 as i}from"./chunks/framework.B9qR_F1m.js";const _=JSON.parse('{"title":"0008 入口 skill 之间不互相调用","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0008-entries-do-not-call-entries.md","filePath":"reference/adr/0008-entries-do-not-call-entries.md","lastUpdated":null}'),l={name:"reference/adr/0008-entries-do-not-call-entries.md"};function o(s,e,n,d,c,h){return t(),r("div",null,[...e[0]||(e[0]=[i("",2)])])}const f=a(l,[["render",o]]);export{_ as __pageData,f as default};
+import{_ as a,o as t,c as r,a2 as i}from"./chunks/framework.BetZR81g.js";const _=JSON.parse('{"title":"0008 入口 skill 之间不互相调用","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0008-entries-do-not-call-entries.md","filePath":"reference/adr/0008-entries-do-not-call-entries.md","lastUpdated":null}'),l={name:"reference/adr/0008-entries-do-not-call-entries.md"};function o(s,e,n,d,c,h){return t(),r("div",null,[...e[0]||(e[0]=[i("",2)])])}const f=a(l,[["render",o]]);export{_ as __pageData,f as default};

package/site-dist/assets/{reference_adr_0009-versioned-install-layout.md.CSg1VqlW.js → reference_adr_0009-versioned-install-layout.md.D9g3dWr-.js}

@@ -1 +1 @@
-import{_ as e,o as t,c as r,a3 as i}from"./chunks/framework.B9qR_F1m.js";const p=JSON.parse('{"title":"0009 程序与本机配置分开存放，按版本目录并存","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0009-versioned-install-layout.md","filePath":"reference/adr/0009-versioned-install-layout.md","lastUpdated":null}'),l={name:"reference/adr/0009-versioned-install-layout.md"};function o(s,a,n,d,c,h){return t(),r("div",null,[...a[0]||(a[0]=[i('<div><h1 id="_0009-程序与本机配置分开存放-按版本目录并存" tabindex="-1">0009 程序与本机配置分开存放，按版本目录并存 <a class="header-anchor" href="#_0009-程序与本机配置分开存放-按版本目录并存" aria-label="Permalink to &quot;0009 程序与本机配置分开存放，按版本目录并存&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>脚本版的配置放在程序目录里，升级要手工保留配置；运行中的流水线依赖程序文件，直接覆盖有风险；也无法快速回滚。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>程序放在 ~/tools/req-kit/versions/&lt;版本&gt;/，本机配置放在 ~/.req-kit/。在哪个版本目录运行 install.mjs，就启用哪个版本。状态文件带格式版本，可迁移。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>升级不动配置；运行中的流水线按旧版本跑完；回滚是一条命令。旧版本目录需要定期清理（install.mjs --prune 会列出）。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0009-versioned-install-layout.md">docs/adr/0009-versioned-install-layout.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0009-versioned-install-layout.md">在 GitHub 上编辑</a></p>',2)])])}const _=e(l,[["render",o]]);export{p as __pageData,_ as default};
+import{_ as e,o as t,c as r,a2 as i}from"./chunks/framework.BetZR81g.js";const p=JSON.parse('{"title":"0009 程序与本机配置分开存放，按版本目录并存","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0009-versioned-install-layout.md","filePath":"reference/adr/0009-versioned-install-layout.md","lastUpdated":null}'),l={name:"reference/adr/0009-versioned-install-layout.md"};function o(s,a,n,d,c,h){return t(),r("div",null,[...a[0]||(a[0]=[i('<div><h1 id="_0009-程序与本机配置分开存放-按版本目录并存" tabindex="-1">0009 程序与本机配置分开存放，按版本目录并存 <a class="header-anchor" href="#_0009-程序与本机配置分开存放-按版本目录并存" aria-label="Permalink to &quot;0009 程序与本机配置分开存放，按版本目录并存&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>脚本版的配置放在程序目录里，升级要手工保留配置；运行中的流水线依赖程序文件，直接覆盖有风险；也无法快速回滚。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>程序放在 ~/tools/req-kit/versions/&lt;版本&gt;/，本机配置放在 ~/.req-kit/。在哪个版本目录运行 install.mjs，就启用哪个版本。状态文件带格式版本，可迁移。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>升级不动配置；运行中的流水线按旧版本跑完；回滚是一条命令。旧版本目录需要定期清理（install.mjs --prune 会列出）。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0009-versioned-install-layout.md">docs/adr/0009-versioned-install-layout.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0009-versioned-install-layout.md">在 GitHub 上编辑</a></p>',2)])])}const _=e(l,[["render",o]]);export{p as __pageData,_ as default};

package/site-dist/assets/{reference_adr_0009-versioned-install-layout.md.CSg1VqlW.lean.js → reference_adr_0009-versioned-install-layout.md.D9g3dWr-.lean.js}

@@ -1 +1 @@
-import{_ as e,o as t,c as r,a3 as i}from"./chunks/framework.B9qR_F1m.js";const p=JSON.parse('{"title":"0009 程序与本机配置分开存放，按版本目录并存","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0009-versioned-install-layout.md","filePath":"reference/adr/0009-versioned-install-layout.md","lastUpdated":null}'),l={name:"reference/adr/0009-versioned-install-layout.md"};function o(s,a,n,d,c,h){return t(),r("div",null,[...a[0]||(a[0]=[i("",2)])])}const _=e(l,[["render",o]]);export{p as __pageData,_ as default};
+import{_ as e,o as t,c as r,a2 as i}from"./chunks/framework.BetZR81g.js";const p=JSON.parse('{"title":"0009 程序与本机配置分开存放，按版本目录并存","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0009-versioned-install-layout.md","filePath":"reference/adr/0009-versioned-install-layout.md","lastUpdated":null}'),l={name:"reference/adr/0009-versioned-install-layout.md"};function o(s,a,n,d,c,h){return t(),r("div",null,[...a[0]||(a[0]=[i("",2)])])}const _=e(l,[["render",o]]);export{p as __pageData,_ as default};

package/site-dist/assets/{reference_adr_0010-generated-feature-overview.md.D8F3MK-h.js → reference_adr_0010-generated-feature-overview.md.CHOwcV4c.js}

@@ -1 +1 @@
-import{_ as a,o as r,c as t,a3 as d}from"./chunks/framework.B9qR_F1m.js";const h=JSON.parse('{"title":"0010 需求总览现场生成，不维护 INDEX.md","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0010-generated-feature-overview.md","filePath":"reference/adr/0010-generated-feature-overview.md","lastUpdated":null}'),o={name:"reference/adr/0010-generated-feature-overview.md"};function i(n,e,s,c,l,u){return r(),t("div",null,[...e[0]||(e[0]=[d('<div><h1 id="_0010-需求总览现场生成-不维护-index-md" tabindex="-1">0010 需求总览现场生成，不维护 INDEX.md <a class="header-anchor" href="#_0010-需求总览现场生成-不维护-index-md" aria-label="Permalink to &quot;0010 需求总览现场生成，不维护 INDEX.md&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>设计方案计划在 <code>docs/features/INDEX.md</code> 中维护所有需求的一览。但每个需求在自己的 worktree 和分支上进行，如果每个分支都修改同一个提交进仓库的文件，合并时会反复冲突；而且一个工作区里看不到其他工作区尚未合并的需求。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>不提交 <code>INDEX.md</code>。<code>start-pipeline --list</code> 现场扫描这个仓库所有 worktree 中的 <code>docs/features/*/spec.md</code>、状态文件和验收记录，生成总览；同一需求出现在多个工作区时取最近更新的一份。<code>/req</code> 在路由、查看进度和接手时使用它。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>没有合并冲突，能看到所有工作区中的需求。代价是总览只在本机生成；不在这台机器上的工作区看不到。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0010-generated-feature-overview.md">docs/adr/0010-generated-feature-overview.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0010-generated-feature-overview.md">在 GitHub 上编辑</a></p>',2)])])}const m=a(o,[["render",i]]);export{h as __pageData,m as default};
+import{_ as a,o as r,c as t,a2 as d}from"./chunks/framework.BetZR81g.js";const h=JSON.parse('{"title":"0010 需求总览现场生成，不维护 INDEX.md","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0010-generated-feature-overview.md","filePath":"reference/adr/0010-generated-feature-overview.md","lastUpdated":null}'),o={name:"reference/adr/0010-generated-feature-overview.md"};function i(n,e,s,c,l,u){return r(),t("div",null,[...e[0]||(e[0]=[d('<div><h1 id="_0010-需求总览现场生成-不维护-index-md" tabindex="-1">0010 需求总览现场生成，不维护 INDEX.md <a class="header-anchor" href="#_0010-需求总览现场生成-不维护-index-md" aria-label="Permalink to &quot;0010 需求总览现场生成，不维护 INDEX.md&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>设计方案计划在 <code>docs/features/INDEX.md</code> 中维护所有需求的一览。但每个需求在自己的 worktree 和分支上进行，如果每个分支都修改同一个提交进仓库的文件，合并时会反复冲突；而且一个工作区里看不到其他工作区尚未合并的需求。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>不提交 <code>INDEX.md</code>。<code>start-pipeline --list</code> 现场扫描这个仓库所有 worktree 中的 <code>docs/features/*/spec.md</code>、状态文件和验收记录，生成总览；同一需求出现在多个工作区时取最近更新的一份。<code>/req</code> 在路由、查看进度和接手时使用它。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>没有合并冲突，能看到所有工作区中的需求。代价是总览只在本机生成；不在这台机器上的工作区看不到。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0010-generated-feature-overview.md">docs/adr/0010-generated-feature-overview.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0010-generated-feature-overview.md">在 GitHub 上编辑</a></p>',2)])])}const m=a(o,[["render",i]]);export{h as __pageData,m as default};

package/site-dist/assets/{reference_adr_0010-generated-feature-overview.md.D8F3MK-h.lean.js → reference_adr_0010-generated-feature-overview.md.CHOwcV4c.lean.js}

@@ -1 +1 @@
-import{_ as a,o as r,c as t,a3 as d}from"./chunks/framework.B9qR_F1m.js";const h=JSON.parse('{"title":"0010 需求总览现场生成，不维护 INDEX.md","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0010-generated-feature-overview.md","filePath":"reference/adr/0010-generated-feature-overview.md","lastUpdated":null}'),o={name:"reference/adr/0010-generated-feature-overview.md"};function i(n,e,s,c,l,u){return r(),t("div",null,[...e[0]||(e[0]=[d("",2)])])}const m=a(o,[["render",i]]);export{h as __pageData,m as default};
+import{_ as a,o as r,c as t,a2 as d}from"./chunks/framework.BetZR81g.js";const h=JSON.parse('{"title":"0010 需求总览现场生成，不维护 INDEX.md","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0010-generated-feature-overview.md","filePath":"reference/adr/0010-generated-feature-overview.md","lastUpdated":null}'),o={name:"reference/adr/0010-generated-feature-overview.md"};function i(n,e,s,c,l,u){return r(),t("div",null,[...e[0]||(e[0]=[d("",2)])])}const m=a(o,[["render",i]]);export{h as __pageData,m as default};

package/site-dist/assets/{reference_adr_0011-resume-after-completion.md.BCrZrKjf.js → reference_adr_0011-resume-after-completion.md.CqdSPi49.js}

@@ -1 +1 @@
-import{_ as a,o as t,c as r,a3 as o}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0011 完成后修改 spec 可以继续开发","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0011-resume-after-completion.md","filePath":"reference/adr/0011-resume-after-completion.md","lastUpdated":null}'),s={name:"reference/adr/0011-resume-after-completion.md"};function i(c,e,d,n,l,p){return t(),r("div",null,[...e[0]||(e[0]=[o('<div><h1 id="_0011-完成后修改-spec-可以继续开发" tabindex="-1">0011 完成后修改 spec 可以继续开发 <a class="header-anchor" href="#_0011-完成后修改-spec-可以继续开发" aria-label="Permalink to &quot;0011 完成后修改 spec 可以继续开发&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>修改需求、验收发现问题时，流水线往往已经完成。原来的规则是&quot;已完成的流水线不能 --resume，只能 --restart&quot;，而 --restart 会丢掉运行记录，也不是使用者想表达的意思。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>流水线已完成、且 spec.md 在完成后被修改过时，<code>--resume</code> 从方案设计重新开始（第 N+1 次尝试），沿用原来的发起对话和分支；spec 没有改过时仍然拒绝，并说明先更新 spec。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>&quot;修改需求&quot;和&quot;验收&quot;手册可以统一用&quot;继续&quot;命令；每次重开都有 changes.md 中的记录可查。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0011-resume-after-completion.md">docs/adr/0011-resume-after-completion.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0011-resume-after-completion.md">在 GitHub 上编辑</a></p>',2)])])}const h=a(s,[["render",i]]);export{u as __pageData,h as default};
+import{_ as a,o as t,c as r,a2 as o}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0011 完成后修改 spec 可以继续开发","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0011-resume-after-completion.md","filePath":"reference/adr/0011-resume-after-completion.md","lastUpdated":null}'),s={name:"reference/adr/0011-resume-after-completion.md"};function i(c,e,d,n,l,p){return t(),r("div",null,[...e[0]||(e[0]=[o('<div><h1 id="_0011-完成后修改-spec-可以继续开发" tabindex="-1">0011 完成后修改 spec 可以继续开发 <a class="header-anchor" href="#_0011-完成后修改-spec-可以继续开发" aria-label="Permalink to &quot;0011 完成后修改 spec 可以继续开发&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>修改需求、验收发现问题时，流水线往往已经完成。原来的规则是&quot;已完成的流水线不能 --resume，只能 --restart&quot;，而 --restart 会丢掉运行记录，也不是使用者想表达的意思。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>流水线已完成、且 spec.md 在完成后被修改过时，<code>--resume</code> 从方案设计重新开始（第 N+1 次尝试），沿用原来的发起对话和分支；spec 没有改过时仍然拒绝，并说明先更新 spec。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>&quot;修改需求&quot;和&quot;验收&quot;手册可以统一用&quot;继续&quot;命令；每次重开都有 changes.md 中的记录可查。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0011-resume-after-completion.md">docs/adr/0011-resume-after-completion.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0011-resume-after-completion.md">在 GitHub 上编辑</a></p>',2)])])}const h=a(s,[["render",i]]);export{u as __pageData,h as default};

package/site-dist/assets/{reference_adr_0011-resume-after-completion.md.BCrZrKjf.lean.js → reference_adr_0011-resume-after-completion.md.CqdSPi49.lean.js}

@@ -1 +1 @@
-import{_ as a,o as t,c as r,a3 as o}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0011 完成后修改 spec 可以继续开发","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0011-resume-after-completion.md","filePath":"reference/adr/0011-resume-after-completion.md","lastUpdated":null}'),s={name:"reference/adr/0011-resume-after-completion.md"};function i(c,e,d,n,l,p){return t(),r("div",null,[...e[0]||(e[0]=[o("",2)])])}const h=a(s,[["render",i]]);export{u as __pageData,h as default};
+import{_ as a,o as t,c as r,a2 as o}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0011 完成后修改 spec 可以继续开发","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0011-resume-after-completion.md","filePath":"reference/adr/0011-resume-after-completion.md","lastUpdated":null}'),s={name:"reference/adr/0011-resume-after-completion.md"};function i(c,e,d,n,l,p){return t(),r("div",null,[...e[0]||(e[0]=[o("",2)])])}const h=a(s,[["render",i]]);export{u as __pageData,h as default};

package/site-dist/assets/{reference_adr_0012-review-panel.md.k9rrHFFc.js → reference_adr_0012-review-panel.md.d4wmLrNF.js}

@@ -1 +1 @@
-import{_ as a,o as r,c as t,a3 as i}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0012 评审小组：首轮并行评审，评审者核实汇总","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0012-review-panel.md","filePath":"reference/adr/0012-review-panel.md","lastUpdated":null}'),o={name:"reference/adr/0012-review-panel.md"};function d(l,e,n,c,s,p){return r(),t("div",null,[...e[0]||(e[0]=[i('<div><h1 id="_0012-评审小组-首轮并行评审-评审者核实汇总" tabindex="-1">0012 评审小组：首轮并行评审，评审者核实汇总 <a class="header-anchor" href="#_0012-评审小组-首轮并行评审-评审者核实汇总" aria-label="Permalink to &quot;0012 评审小组：首轮并行评审，评审者核实汇总&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>单一模型评审容易有固定的盲区；参考 pstack 的 <code>/interrogate</code>，多个模型独立评审能发现更多问题。但成员意见直接投票会放大误报，而且并行的成员在同一个目录里提交代码会互相冲突。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li>配置 <code>reviewPanel</code> 开启，默认关闭；默认只用于标准档、方案审核和代码评审的第一轮。后续轮次只核对修复，用单个评审者。</li><li>成员并行运行，只读代码，各写一份意见文件到 <code>&lt;功能目录&gt;/review-panel/</code>，不提交、不写 <code>progress.md</code> 和 <code>decisions.tsv</code>。</li><li>配置的 <code>reviewer</code> 作为汇总者，逐条核实并归入&quot;必须修改 / 建议修改 / 留给人决定 / 已驳回&quot;四类；结论只依据核实后的&quot;必须修改&quot;，不按成员数量投票。被驳回和留给人决定的意见记入 <code>decisions.tsv</code>，最终报告展示。</li><li>部分成员失败时只汇总完成的成员；全部失败时该步骤失败。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>开启后每次评审多出 N 个 agent 的用量。汇总者的核实质量决定了效果，需要通过评估观察误报和漏报。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0012-review-panel.md">docs/adr/0012-review-panel.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0012-review-panel.md">在 GitHub 上编辑</a></p>',2)])])}const _=a(o,[["render",d]]);export{u as __pageData,_ as default};
+import{_ as a,o as r,c as t,a2 as i}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0012 评审小组：首轮并行评审，评审者核实汇总","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0012-review-panel.md","filePath":"reference/adr/0012-review-panel.md","lastUpdated":null}'),o={name:"reference/adr/0012-review-panel.md"};function d(l,e,n,c,s,p){return r(),t("div",null,[...e[0]||(e[0]=[i('<div><h1 id="_0012-评审小组-首轮并行评审-评审者核实汇总" tabindex="-1">0012 评审小组：首轮并行评审，评审者核实汇总 <a class="header-anchor" href="#_0012-评审小组-首轮并行评审-评审者核实汇总" aria-label="Permalink to &quot;0012 评审小组：首轮并行评审，评审者核实汇总&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>单一模型评审容易有固定的盲区；参考 pstack 的 <code>/interrogate</code>，多个模型独立评审能发现更多问题。但成员意见直接投票会放大误报，而且并行的成员在同一个目录里提交代码会互相冲突。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li>配置 <code>reviewPanel</code> 开启，默认关闭；默认只用于标准档、方案审核和代码评审的第一轮。后续轮次只核对修复，用单个评审者。</li><li>成员并行运行，只读代码，各写一份意见文件到 <code>&lt;功能目录&gt;/review-panel/</code>，不提交、不写 <code>progress.md</code> 和 <code>decisions.tsv</code>。</li><li>配置的 <code>reviewer</code> 作为汇总者，逐条核实并归入&quot;必须修改 / 建议修改 / 留给人决定 / 已驳回&quot;四类；结论只依据核实后的&quot;必须修改&quot;，不按成员数量投票。被驳回和留给人决定的意见记入 <code>decisions.tsv</code>，最终报告展示。</li><li>部分成员失败时只汇总完成的成员；全部失败时该步骤失败。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>开启后每次评审多出 N 个 agent 的用量。汇总者的核实质量决定了效果，需要通过评估观察误报和漏报。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0012-review-panel.md">docs/adr/0012-review-panel.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0012-review-panel.md">在 GitHub 上编辑</a></p>',2)])])}const _=a(o,[["render",d]]);export{u as __pageData,_ as default};

package/site-dist/assets/{reference_adr_0012-review-panel.md.k9rrHFFc.lean.js → reference_adr_0012-review-panel.md.d4wmLrNF.lean.js}

@@ -1 +1 @@
-import{_ as a,o as r,c as t,a3 as i}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0012 评审小组：首轮并行评审，评审者核实汇总","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0012-review-panel.md","filePath":"reference/adr/0012-review-panel.md","lastUpdated":null}'),o={name:"reference/adr/0012-review-panel.md"};function d(l,e,n,c,s,p){return r(),t("div",null,[...e[0]||(e[0]=[i("",2)])])}const _=a(o,[["render",d]]);export{u as __pageData,_ as default};
+import{_ as a,o as r,c as t,a2 as i}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0012 评审小组：首轮并行评审，评审者核实汇总","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0012-review-panel.md","filePath":"reference/adr/0012-review-panel.md","lastUpdated":null}'),o={name:"reference/adr/0012-review-panel.md"};function d(l,e,n,c,s,p){return r(),t("div",null,[...e[0]||(e[0]=[i("",2)])])}const _=a(o,[["render",d]]);export{u as __pageData,_ as default};

package/site-dist/assets/{reference_adr_0013-no-release-tooling.md.BQeJ8dEI.js → reference_adr_0013-no-release-tooling.md.BOROmwvq.js}

@@ -1 +1 @@
-import{_ as a,o as t,c as o,a3 as r}from"./chunks/framework.B9qR_F1m.js";const p=JSON.parse('{"title":"0013 发布不使用 changesets 等工具","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0013-no-release-tooling.md","filePath":"reference/adr/0013-no-release-tooling.md","lastUpdated":null}'),s={name:"reference/adr/0013-no-release-tooling.md"};function n(i,e,l,d,c,h){return t(),o("div",null,[...e[0]||(e[0]=[r('<div><h1 id="_0013-发布不使用-changesets-等工具" tabindex="-1">0013 发布不使用 changesets 等工具 <a class="header-anchor" href="#_0013-发布不使用-changesets-等工具" aria-label="Permalink to &quot;0013 发布不使用 changesets 等工具&quot;">​</a></h1><ul><li>状态：已采纳（取代设计方案中&quot;由 changesets 维护 CHANGELOG&quot;的计划）</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>设计方案计划用 changesets 维护版本号和 CHANGELOG。req-kit 是单一包、发布频率低，CHANGELOG 的主要读者是使用者和安装者，需要&quot;使用者会看到的变化&quot;和&quot;升级须知&quot;这样的结构，工具生成的条目还要人工改写。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>版本号和 CHANGELOG 由维护者按 <a href="./../../guide/maintainer">维护者指南</a> 的发布流程手工维护；标签不带 <code>v</code> 前缀。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>少一个开发依赖。需要维护者在每次发布时认真写 CHANGELOG；发布流程中的验证步骤由指南约束。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0013-no-release-tooling.md">docs/adr/0013-no-release-tooling.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0013-no-release-tooling.md">在 GitHub 上编辑</a></p>',2)])])}const _=a(s,[["render",n]]);export{p as __pageData,_ as default};
+import{_ as a,o as t,c as o,a2 as r}from"./chunks/framework.BetZR81g.js";const p=JSON.parse('{"title":"0013 发布不使用 changesets 等工具","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0013-no-release-tooling.md","filePath":"reference/adr/0013-no-release-tooling.md","lastUpdated":null}'),s={name:"reference/adr/0013-no-release-tooling.md"};function n(i,e,l,d,c,h){return t(),o("div",null,[...e[0]||(e[0]=[r('<div><h1 id="_0013-发布不使用-changesets-等工具" tabindex="-1">0013 发布不使用 changesets 等工具 <a class="header-anchor" href="#_0013-发布不使用-changesets-等工具" aria-label="Permalink to &quot;0013 发布不使用 changesets 等工具&quot;">​</a></h1><ul><li>状态：已采纳（取代设计方案中&quot;由 changesets 维护 CHANGELOG&quot;的计划）</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>设计方案计划用 changesets 维护版本号和 CHANGELOG。req-kit 是单一包、发布频率低，CHANGELOG 的主要读者是使用者和安装者，需要&quot;使用者会看到的变化&quot;和&quot;升级须知&quot;这样的结构，工具生成的条目还要人工改写。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>版本号和 CHANGELOG 由维护者按 <a href="./../../guide/maintainer">维护者指南</a> 的发布流程手工维护；标签不带 <code>v</code> 前缀。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>少一个开发依赖。需要维护者在每次发布时认真写 CHANGELOG；发布流程中的验证步骤由指南约束。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0013-no-release-tooling.md">docs/adr/0013-no-release-tooling.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0013-no-release-tooling.md">在 GitHub 上编辑</a></p>',2)])])}const _=a(s,[["render",n]]);export{p as __pageData,_ as default};

package/site-dist/assets/{reference_adr_0013-no-release-tooling.md.BQeJ8dEI.lean.js → reference_adr_0013-no-release-tooling.md.BOROmwvq.lean.js}

@@ -1 +1 @@
-import{_ as a,o as t,c as o,a3 as r}from"./chunks/framework.B9qR_F1m.js";const p=JSON.parse('{"title":"0013 发布不使用 changesets 等工具","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0013-no-release-tooling.md","filePath":"reference/adr/0013-no-release-tooling.md","lastUpdated":null}'),s={name:"reference/adr/0013-no-release-tooling.md"};function n(i,e,l,d,c,h){return t(),o("div",null,[...e[0]||(e[0]=[r("",2)])])}const _=a(s,[["render",n]]);export{p as __pageData,_ as default};
+import{_ as a,o as t,c as o,a2 as r}from"./chunks/framework.BetZR81g.js";const p=JSON.parse('{"title":"0013 发布不使用 changesets 等工具","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0013-no-release-tooling.md","filePath":"reference/adr/0013-no-release-tooling.md","lastUpdated":null}'),s={name:"reference/adr/0013-no-release-tooling.md"};function n(i,e,l,d,c,h){return t(),o("div",null,[...e[0]||(e[0]=[r("",2)])])}const _=a(s,[["render",n]]);export{p as __pageData,_ as default};

package/site-dist/assets/{reference_adr_0014-notifier-slot.md.C23QR1xO.js → reference_adr_0014-notifier-slot.md.BAqt1Xj1.js}

@@ -1 +1 @@
-import{_ as t,o as a,c as i,a3 as o}from"./chunks/framework.B9qR_F1m.js";const m=JSON.parse('{"title":"0014 外部通知只留接口，不内置任何 IM","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0014-notifier-slot.md","filePath":"reference/adr/0014-notifier-slot.md","lastUpdated":null}'),r={name:"reference/adr/0014-notifier-slot.md"};function l(s,e,d,n,c,f){return a(),i("div",null,[...e[0]||(e[0]=[o('<div><h1 id="_0014-外部通知只留接口-不内置任何-im" tabindex="-1">0014 外部通知只留接口，不内置任何 IM <a class="header-anchor" href="#_0014-外部通知只留接口-不内置任何-im" aria-label="Permalink to &quot;0014 外部通知只留接口，不内置任何 IM&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>需求方往往不一直盯着 Paseo 对话，&quot;需要你决定&quot;&quot;开发中断&quot;&quot;已完成&quot;这几个时刻希望在企业内部 IM 中收到。各企业的 IM 不同，鉴权和接口多是内部的，req-kit 无法也不应该内置。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li>引擎在 milestone、blocked、permission、failed、completed 五个时刻，除发回发起的对话外，调用配置中 <code>notifiers</code> 列出的本机模块，事件格式见 <a href="./../contracts/notifier-event">contracts/notifier-event.md</a>（<code>schema: 1</code>）。</li><li>模块由使用方实现（从 <code>notifiers/im-template.mjs</code> 复制），req-kit 不为它安装依赖。</li><li><code>notifiers</code> 只能写在本机或团队配置中，项目配置中的会被忽略：项目仓库里的内容不应决定在本机执行哪段代码、往哪里发消息。</li><li>通知失败或超过 15 秒只记日志，不影响流水线。</li><li><code>req notify-test</code> 发示例事件，接入时不需要真的运行流水线。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>接入 IM 只需写一个函数。事件格式成为对外约定，同一 <code>schema</code> 内只增加字段。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0014-notifier-slot.md">docs/adr/0014-notifier-slot.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0014-notifier-slot.md">在 GitHub 上编辑</a></p>',2)])])}const u=t(r,[["render",l]]);export{m as __pageData,u as default};
+import{_ as t,o as a,c as i,a2 as o}from"./chunks/framework.BetZR81g.js";const m=JSON.parse('{"title":"0014 外部通知只留接口，不内置任何 IM","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0014-notifier-slot.md","filePath":"reference/adr/0014-notifier-slot.md","lastUpdated":null}'),r={name:"reference/adr/0014-notifier-slot.md"};function l(s,e,d,n,c,f){return a(),i("div",null,[...e[0]||(e[0]=[o('<div><h1 id="_0014-外部通知只留接口-不内置任何-im" tabindex="-1">0014 外部通知只留接口，不内置任何 IM <a class="header-anchor" href="#_0014-外部通知只留接口-不内置任何-im" aria-label="Permalink to &quot;0014 外部通知只留接口，不内置任何 IM&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>需求方往往不一直盯着 Paseo 对话，&quot;需要你决定&quot;&quot;开发中断&quot;&quot;已完成&quot;这几个时刻希望在企业内部 IM 中收到。各企业的 IM 不同，鉴权和接口多是内部的，req-kit 无法也不应该内置。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li>引擎在 milestone、blocked、permission、failed、completed 五个时刻，除发回发起的对话外，调用配置中 <code>notifiers</code> 列出的本机模块，事件格式见 <a href="./../contracts/notifier-event">contracts/notifier-event.md</a>（<code>schema: 1</code>）。</li><li>模块由使用方实现（从 <code>notifiers/im-template.mjs</code> 复制），req-kit 不为它安装依赖。</li><li><code>notifiers</code> 只能写在本机或团队配置中，项目配置中的会被忽略：项目仓库里的内容不应决定在本机执行哪段代码、往哪里发消息。</li><li>通知失败或超过 15 秒只记日志，不影响流水线。</li><li><code>req notify-test</code> 发示例事件，接入时不需要真的运行流水线。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>接入 IM 只需写一个函数。事件格式成为对外约定，同一 <code>schema</code> 内只增加字段。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0014-notifier-slot.md">docs/adr/0014-notifier-slot.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0014-notifier-slot.md">在 GitHub 上编辑</a></p>',2)])])}const u=t(r,[["render",l]]);export{m as __pageData,u as default};

package/site-dist/assets/{reference_adr_0014-notifier-slot.md.C23QR1xO.lean.js → reference_adr_0014-notifier-slot.md.BAqt1Xj1.lean.js}

@@ -1 +1 @@
-import{_ as t,o as a,c as i,a3 as o}from"./chunks/framework.B9qR_F1m.js";const m=JSON.parse('{"title":"0014 外部通知只留接口，不内置任何 IM","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0014-notifier-slot.md","filePath":"reference/adr/0014-notifier-slot.md","lastUpdated":null}'),r={name:"reference/adr/0014-notifier-slot.md"};function l(s,e,d,n,c,f){return a(),i("div",null,[...e[0]||(e[0]=[o("",2)])])}const u=t(r,[["render",l]]);export{m as __pageData,u as default};
+import{_ as t,o as a,c as i,a2 as o}from"./chunks/framework.BetZR81g.js";const m=JSON.parse('{"title":"0014 外部通知只留接口，不内置任何 IM","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0014-notifier-slot.md","filePath":"reference/adr/0014-notifier-slot.md","lastUpdated":null}'),r={name:"reference/adr/0014-notifier-slot.md"};function l(s,e,d,n,c,f){return a(),i("div",null,[...e[0]||(e[0]=[o("",2)])])}const u=t(r,[["render",l]]);export{m as __pageData,u as default};

package/site-dist/assets/{reference_adr_0015-incremental-continue.md.Buy7wwO8.js → reference_adr_0015-incremental-continue.md.BiUdpeq5.js}

@@ -1 +1 @@
-import{_ as a,o as t,c as r,a3 as n}from"./chunks/framework.B9qR_F1m.js";const h=JSON.parse('{"title":"0015 需求变更后增量继续，而不是从零重做","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0015-incremental-continue.md","filePath":"reference/adr/0015-incremental-continue.md","lastUpdated":null}'),o={name:"reference/adr/0015-incremental-continue.md"};function i(c,e,l,d,s,u){return t(),r("div",null,[...e[0]||(e[0]=[n('<div><h1 id="_0015-需求变更后增量继续-而不是从零重做" tabindex="-1">0015 需求变更后增量继续，而不是从零重做 <a class="header-anchor" href="#_0015-需求变更后增量继续-而不是从零重做" aria-label="Permalink to &quot;0015 需求变更后增量继续，而不是从零重做&quot;">​</a></h1><ul><li>状态：已采纳（细化 <a href="./0011-resume-after-completion">0011</a>：0011 决定&quot;可以继续&quot;，本条决定&quot;怎么继续&quot;）</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>1.2 中 spec 改动或回答了需求方的问题后继续，是&quot;从方案设计重新开始&quot;：步骤 agent 拿到的提示与第一次相同，往往重新写一遍方案、重新审核全部代码，耗时接近第一次，还可能改掉已经验收过的部分。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li>从方案设计继续时，状态中记录 <code>incremental</code>：接着第几次尝试、原因、本次开始时的提交、上一次是否已写过代码。</li><li>各步骤的提示附加 <code>engine/prompts/incremental.md</code>：方案在原文末尾追加&quot;第 N 次尝试：需求变更&quot;一节，只设计变化的部分；实现只改需要改的；代码评审只看本次开始以来的改动；验证重点验变化的验收标准，并回归其余的；报告说明这是第几次。</li><li><code>--restart</code> 仍是完全从零开始，不参考上次的方案和代码。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>变更后的继续通常比第一次快很多。增量的前提是上次的方案和提交还在分支上；如果分支被重置过，应使用 <code>--restart</code>。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0015-incremental-continue.md">docs/adr/0015-incremental-continue.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0015-incremental-continue.md">在 GitHub 上编辑</a></p>',2)])])}const p=a(o,[["render",i]]);export{h as __pageData,p as default};
+import{_ as a,o as t,c as r,a2 as n}from"./chunks/framework.BetZR81g.js";const h=JSON.parse('{"title":"0015 需求变更后增量继续，而不是从零重做","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0015-incremental-continue.md","filePath":"reference/adr/0015-incremental-continue.md","lastUpdated":null}'),o={name:"reference/adr/0015-incremental-continue.md"};function i(c,e,l,d,s,u){return t(),r("div",null,[...e[0]||(e[0]=[n('<div><h1 id="_0015-需求变更后增量继续-而不是从零重做" tabindex="-1">0015 需求变更后增量继续，而不是从零重做 <a class="header-anchor" href="#_0015-需求变更后增量继续-而不是从零重做" aria-label="Permalink to &quot;0015 需求变更后增量继续，而不是从零重做&quot;">​</a></h1><ul><li>状态：已采纳（细化 <a href="./0011-resume-after-completion">0011</a>：0011 决定&quot;可以继续&quot;，本条决定&quot;怎么继续&quot;）</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>1.2 中 spec 改动或回答了需求方的问题后继续，是&quot;从方案设计重新开始&quot;：步骤 agent 拿到的提示与第一次相同，往往重新写一遍方案、重新审核全部代码，耗时接近第一次，还可能改掉已经验收过的部分。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li>从方案设计继续时，状态中记录 <code>incremental</code>：接着第几次尝试、原因、本次开始时的提交、上一次是否已写过代码。</li><li>各步骤的提示附加 <code>engine/prompts/incremental.md</code>：方案在原文末尾追加&quot;第 N 次尝试：需求变更&quot;一节，只设计变化的部分；实现只改需要改的；代码评审只看本次开始以来的改动；验证重点验变化的验收标准，并回归其余的；报告说明这是第几次。</li><li><code>--restart</code> 仍是完全从零开始，不参考上次的方案和代码。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>变更后的继续通常比第一次快很多。增量的前提是上次的方案和提交还在分支上；如果分支被重置过，应使用 <code>--restart</code>。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0015-incremental-continue.md">docs/adr/0015-incremental-continue.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0015-incremental-continue.md">在 GitHub 上编辑</a></p>',2)])])}const p=a(o,[["render",i]]);export{h as __pageData,p as default};

package/site-dist/assets/{reference_adr_0015-incremental-continue.md.Buy7wwO8.lean.js → reference_adr_0015-incremental-continue.md.BiUdpeq5.lean.js}

@@ -1 +1 @@
-import{_ as a,o as t,c as r,a3 as n}from"./chunks/framework.B9qR_F1m.js";const h=JSON.parse('{"title":"0015 需求变更后增量继续，而不是从零重做","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0015-incremental-continue.md","filePath":"reference/adr/0015-incremental-continue.md","lastUpdated":null}'),o={name:"reference/adr/0015-incremental-continue.md"};function i(c,e,l,d,s,u){return t(),r("div",null,[...e[0]||(e[0]=[n("",2)])])}const p=a(o,[["render",i]]);export{h as __pageData,p as default};
+import{_ as a,o as t,c as r,a2 as n}from"./chunks/framework.BetZR81g.js";const h=JSON.parse('{"title":"0015 需求变更后增量继续，而不是从零重做","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0015-incremental-continue.md","filePath":"reference/adr/0015-incremental-continue.md","lastUpdated":null}'),o={name:"reference/adr/0015-incremental-continue.md"};function i(c,e,l,d,s,u){return t(),r("div",null,[...e[0]||(e[0]=[n("",2)])])}const p=a(o,[["render",i]]);export{h as __pageData,p as default};

package/site-dist/assets/{reference_adr_0016-upgrade-from-tags.md.qfIW-tqJ.js → reference_adr_0016-upgrade-from-tags.md.D48PfEFP.js}

@@ -1 +1 @@
-import{_ as a,o,c as t,a3 as r}from"./chunks/framework.B9qR_F1m.js";const g=JSON.parse('{"title":"0016 一键升级：从 git 标签下载到 versions/ 再切换","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0016-upgrade-from-tags.md","filePath":"reference/adr/0016-upgrade-from-tags.md","lastUpdated":null}'),d={name:"reference/adr/0016-upgrade-from-tags.md"};function i(s,e,l,c,n,m){return o(),t("div",null,[...e[0]||(e[0]=[r('<div><h1 id="_0016-一键升级-从-git-标签下载到-versions-再切换" tabindex="-1">0016 一键升级：从 git 标签下载到 versions/ 再切换 <a class="header-anchor" href="#_0016-一键升级-从-git-标签下载到-versions-再切换" aria-label="Permalink to &quot;0016 一键升级：从 git 标签下载到 versions/ 再切换&quot;">​</a></h1><ul><li>状态：已采纳（在 <a href="./0009-versioned-install-layout">0009</a> 的目录结构上增加自动化）</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>手工升级要 clone、npm install、运行 install.mjs 三步，非专业开发的使用者容易漏掉 npm install 或在错误的目录运行。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li><code>node install.mjs --upgrade [版本]</code>（<code>req upgrade</code>）：用 <code>git ls-remote --tags</code> 读取已发布版本，<code>git clone --depth 1 --branch &lt;标签&gt;</code> 到 <code>versions/&lt;版本&gt;</code>，<code>npm install --omit=dev</code>，再运行新版本的 <code>install.mjs</code> 切换。</li><li>不写版本时取最新版本；当前是正式版时只升级到正式版，当前是预发布版（beta）时也考虑预发布版。</li><li>下载地址取 <code>package.json</code> 的 <code>repository</code>，可用环境变量 <code>REQ_KIT_REPO_URL</code> 或 <code>--from</code> 改为内网镜像。</li><li>任何一步失败，当前版本不受影响；下载先写到临时目录，完整后才改名为版本目录。</li><li>安装时在 <code>~/.req-kit/bin</code> 写入 <code>req</code>（和 Windows 的 <code>req.cmd</code>），指向当前启用的版本。是否加入 PATH 由使用者决定，安装程序只给出命令，不修改系统设置。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>升级只需要 git 和 npm 可用；回滚仍是在旧版本目录运行 <code>node install.mjs</code>。体检会提示有新版本（离线时跳过）。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0016-upgrade-from-tags.md">docs/adr/0016-upgrade-from-tags.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0016-upgrade-from-tags.md">在 GitHub 上编辑</a></p>',2)])])}const h=a(d,[["render",i]]);export{g as __pageData,h as default};
+import{_ as a,o,c as t,a2 as r}from"./chunks/framework.BetZR81g.js";const g=JSON.parse('{"title":"0016 一键升级：从 git 标签下载到 versions/ 再切换","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0016-upgrade-from-tags.md","filePath":"reference/adr/0016-upgrade-from-tags.md","lastUpdated":null}'),d={name:"reference/adr/0016-upgrade-from-tags.md"};function i(s,e,l,c,n,m){return o(),t("div",null,[...e[0]||(e[0]=[r('<div><h1 id="_0016-一键升级-从-git-标签下载到-versions-再切换" tabindex="-1">0016 一键升级：从 git 标签下载到 versions/ 再切换 <a class="header-anchor" href="#_0016-一键升级-从-git-标签下载到-versions-再切换" aria-label="Permalink to &quot;0016 一键升级：从 git 标签下载到 versions/ 再切换&quot;">​</a></h1><ul><li>状态：已采纳（在 <a href="./0009-versioned-install-layout">0009</a> 的目录结构上增加自动化）</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>手工升级要 clone、npm install、运行 install.mjs 三步，非专业开发的使用者容易漏掉 npm install 或在错误的目录运行。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li><code>node install.mjs --upgrade [版本]</code>（<code>req upgrade</code>）：用 <code>git ls-remote --tags</code> 读取已发布版本，<code>git clone --depth 1 --branch &lt;标签&gt;</code> 到 <code>versions/&lt;版本&gt;</code>，<code>npm install --omit=dev</code>，再运行新版本的 <code>install.mjs</code> 切换。</li><li>不写版本时取最新版本；当前是正式版时只升级到正式版，当前是预发布版（beta）时也考虑预发布版。</li><li>下载地址取 <code>package.json</code> 的 <code>repository</code>，可用环境变量 <code>REQ_KIT_REPO_URL</code> 或 <code>--from</code> 改为内网镜像。</li><li>任何一步失败，当前版本不受影响；下载先写到临时目录，完整后才改名为版本目录。</li><li>安装时在 <code>~/.req-kit/bin</code> 写入 <code>req</code>（和 Windows 的 <code>req.cmd</code>），指向当前启用的版本。是否加入 PATH 由使用者决定，安装程序只给出命令，不修改系统设置。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>升级只需要 git 和 npm 可用；回滚仍是在旧版本目录运行 <code>node install.mjs</code>。体检会提示有新版本（离线时跳过）。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0016-upgrade-from-tags.md">docs/adr/0016-upgrade-from-tags.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0016-upgrade-from-tags.md">在 GitHub 上编辑</a></p>',2)])])}const h=a(d,[["render",i]]);export{g as __pageData,h as default};

package/site-dist/assets/{reference_adr_0016-upgrade-from-tags.md.qfIW-tqJ.lean.js → reference_adr_0016-upgrade-from-tags.md.D48PfEFP.lean.js}

@@ -1 +1 @@
-import{_ as a,o,c as t,a3 as r}from"./chunks/framework.B9qR_F1m.js";const g=JSON.parse('{"title":"0016 一键升级：从 git 标签下载到 versions/ 再切换","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0016-upgrade-from-tags.md","filePath":"reference/adr/0016-upgrade-from-tags.md","lastUpdated":null}'),d={name:"reference/adr/0016-upgrade-from-tags.md"};function i(s,e,l,c,n,m){return o(),t("div",null,[...e[0]||(e[0]=[r("",2)])])}const h=a(d,[["render",i]]);export{g as __pageData,h as default};
+import{_ as a,o,c as t,a2 as r}from"./chunks/framework.BetZR81g.js";const g=JSON.parse('{"title":"0016 一键升级：从 git 标签下载到 versions/ 再切换","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0016-upgrade-from-tags.md","filePath":"reference/adr/0016-upgrade-from-tags.md","lastUpdated":null}'),d={name:"reference/adr/0016-upgrade-from-tags.md"};function i(s,e,l,c,n,m){return o(),t("div",null,[...e[0]||(e[0]=[r("",2)])])}const h=a(d,[["render",i]]);export{g as __pageData,h as default};

package/site-dist/assets/{reference_adr_0017-use-paseo-capabilities.md.CjcGli87.js → reference_adr_0017-use-paseo-capabilities.md.CAMkamzJ.js}

@@ -1 +1 @@
-import{_ as a,o,c as i,a3 as t}from"./chunks/framework.B9qR_F1m.js";const f=JSON.parse('{"title":"0017 用好 Paseo 自身的能力：profile、工作区脚本、用量和时间线","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0017-use-paseo-capabilities.md","filePath":"reference/adr/0017-use-paseo-capabilities.md","lastUpdated":null}'),s={name:"reference/adr/0017-use-paseo-capabilities.md"};function r(l,e,d,n,c,p){return o(),i("div",null,[...e[0]||(e[0]=[t('<div><h1 id="_0017-用好-paseo-自身的能力-profile、工作区脚本、用量和时间线" tabindex="-1">0017 用好 Paseo 自身的能力：profile、工作区脚本、用量和时间线 <a class="header-anchor" href="#_0017-用好-paseo-自身的能力-profile、工作区脚本、用量和时间线" aria-label="Permalink to &quot;0017 用好 Paseo 自身的能力：profile、工作区脚本、用量和时间线&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>1.3 及以前，req-kit 只用到 Paseo 的&quot;创建 agent 并挂在对话下&quot;和&quot;等待结束&quot;。Paseo 0.11 已经提供了 agent profile（带使用说明的启动配置）、<code>paseo.json</code>（worktree 准备脚本和受监管的服务，每个工作区独立端口）、provider 用量、agent 时间线等能力。req-kit 自己再实现一遍既重复，又和使用者在 Paseo 界面里看到的不一致。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li><strong>agent 配置可以引用 Paseo profile</strong>（<code>paseoProfile</code>），在每次运行开始时从 daemon 读取并解析；找不到时拒绝启动并列出现有的 profile。</li><li><strong>服务交给 Paseo</strong>：对话所在工作区的 <code>paseo.json</code> 定义了服务时，流水线在需要服务的步骤前通过 Paseo 重启它们，结束后停止；步骤 agent 只拿到地址和状态。<code>paseoServices: &quot;off&quot;</code> 或没有发起对话时，仍由步骤 agent 自己启动。</li><li><strong>用量和时间线只用于提示</strong>：额度紧张时提醒一次，不阻止运行；查看进度时附上 agent 最近的活动，读不到就省略。</li><li>工作区脚本在 <code>@getpaseo/client</code> 0.11 的公开 API 中还没有，暂时通过它导出的 <code>internal/daemon-client</code> 调用，并且每一处都在不可用时退回原来的做法。req-kit 已经把 Paseo 版本限定在 0.11.x（<code>reqKit.paseo</code>），升级 Paseo 支持范围时必须复查这一处。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>使用者在 Paseo 里改 profile、写 <code>paseo.json</code> 就能影响流水线，不必再改 req-kit 的配置。依赖了一个内部接口，升级 Paseo 时有额外的检查项（维护者指南的发布流程中已列出）。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0017-use-paseo-capabilities.md">docs/adr/0017-use-paseo-capabilities.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0017-use-paseo-capabilities.md">在 GitHub 上编辑</a></p>',2)])])}const h=a(s,[["render",r]]);export{f as __pageData,h as default};
+import{_ as a,o,c as i,a2 as t}from"./chunks/framework.BetZR81g.js";const f=JSON.parse('{"title":"0017 用好 Paseo 自身的能力：profile、工作区脚本、用量和时间线","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0017-use-paseo-capabilities.md","filePath":"reference/adr/0017-use-paseo-capabilities.md","lastUpdated":null}'),s={name:"reference/adr/0017-use-paseo-capabilities.md"};function r(l,e,d,n,c,p){return o(),i("div",null,[...e[0]||(e[0]=[t('<div><h1 id="_0017-用好-paseo-自身的能力-profile、工作区脚本、用量和时间线" tabindex="-1">0017 用好 Paseo 自身的能力：profile、工作区脚本、用量和时间线 <a class="header-anchor" href="#_0017-用好-paseo-自身的能力-profile、工作区脚本、用量和时间线" aria-label="Permalink to &quot;0017 用好 Paseo 自身的能力：profile、工作区脚本、用量和时间线&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>1.3 及以前，req-kit 只用到 Paseo 的&quot;创建 agent 并挂在对话下&quot;和&quot;等待结束&quot;。Paseo 0.11 已经提供了 agent profile（带使用说明的启动配置）、<code>paseo.json</code>（worktree 准备脚本和受监管的服务，每个工作区独立端口）、provider 用量、agent 时间线等能力。req-kit 自己再实现一遍既重复，又和使用者在 Paseo 界面里看到的不一致。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li><strong>agent 配置可以引用 Paseo profile</strong>（<code>paseoProfile</code>），在每次运行开始时从 daemon 读取并解析；找不到时拒绝启动并列出现有的 profile。</li><li><strong>服务交给 Paseo</strong>：对话所在工作区的 <code>paseo.json</code> 定义了服务时，流水线在需要服务的步骤前通过 Paseo 重启它们，结束后停止；步骤 agent 只拿到地址和状态。<code>paseoServices: &quot;off&quot;</code> 或没有发起对话时，仍由步骤 agent 自己启动。</li><li><strong>用量和时间线只用于提示</strong>：额度紧张时提醒一次，不阻止运行；查看进度时附上 agent 最近的活动，读不到就省略。</li><li>工作区脚本在 <code>@getpaseo/client</code> 0.11 的公开 API 中还没有，暂时通过它导出的 <code>internal/daemon-client</code> 调用，并且每一处都在不可用时退回原来的做法。req-kit 已经把 Paseo 版本限定在 0.11.x（<code>reqKit.paseo</code>），升级 Paseo 支持范围时必须复查这一处。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>使用者在 Paseo 里改 profile、写 <code>paseo.json</code> 就能影响流水线，不必再改 req-kit 的配置。依赖了一个内部接口，升级 Paseo 时有额外的检查项（维护者指南的发布流程中已列出）。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0017-use-paseo-capabilities.md">docs/adr/0017-use-paseo-capabilities.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0017-use-paseo-capabilities.md">在 GitHub 上编辑</a></p>',2)])])}const h=a(s,[["render",r]]);export{f as __pageData,h as default};

package/site-dist/assets/{reference_adr_0017-use-paseo-capabilities.md.CjcGli87.lean.js → reference_adr_0017-use-paseo-capabilities.md.CAMkamzJ.lean.js}

@@ -1 +1 @@
-import{_ as a,o,c as i,a3 as t}from"./chunks/framework.B9qR_F1m.js";const f=JSON.parse('{"title":"0017 用好 Paseo 自身的能力：profile、工作区脚本、用量和时间线","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0017-use-paseo-capabilities.md","filePath":"reference/adr/0017-use-paseo-capabilities.md","lastUpdated":null}'),s={name:"reference/adr/0017-use-paseo-capabilities.md"};function r(l,e,d,n,c,p){return o(),i("div",null,[...e[0]||(e[0]=[t("",2)])])}const h=a(s,[["render",r]]);export{f as __pageData,h as default};
+import{_ as a,o,c as i,a2 as t}from"./chunks/framework.BetZR81g.js";const f=JSON.parse('{"title":"0017 用好 Paseo 自身的能力：profile、工作区脚本、用量和时间线","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0017-use-paseo-capabilities.md","filePath":"reference/adr/0017-use-paseo-capabilities.md","lastUpdated":null}'),s={name:"reference/adr/0017-use-paseo-capabilities.md"};function r(l,e,d,n,c,p){return o(),i("div",null,[...e[0]||(e[0]=[t("",2)])])}const h=a(s,[["render",r]]);export{f as __pageData,h as default};

package/site-dist/assets/{reference_adr_0018-own-worktree-option.md.fVDpgGSE.js → reference_adr_0018-own-worktree-option.md.DgkWjYL-.js}

@@ -1 +1 @@
-import{_ as o,o as r,c as t,a3 as a}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0018 可选：流水线为需求新建 worktree 工作区","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0018-own-worktree-option.md","filePath":"reference/adr/0018-own-worktree-option.md","lastUpdated":null}'),i={name:"reference/adr/0018-own-worktree-option.md"};function n(d,e,s,l,c,p){return r(),t("div",null,[...e[0]||(e[0]=[a('<div><h1 id="_0018-可选-流水线为需求新建-worktree-工作区" tabindex="-1">0018 可选：流水线为需求新建 worktree 工作区 <a class="header-anchor" href="#_0018-可选-流水线为需求新建-worktree-工作区" aria-label="Permalink to &quot;0018 可选：流水线为需求新建 worktree 工作区&quot;">​</a></h1><ul><li>状态：已采纳（补充 <a href="./0001-step-agents-under-origin-chat">0001</a>、<a href="./0002-no-directory-switch-in-chat">0002</a>：两条的规则不变，增加一种由流水线放置步骤的方式）</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>在项目主目录、主分支上发起的需求，原来只能请使用者自己在 Paseo 中新建 worktree 工作区、换到那里的对话重新开始，或者在主目录新建分支（主目录被占用几个小时）。对不熟悉 worktree 的使用者来说，第一种多了一次切换，第三种影响主目录。</p><p>Paseo 0.11 支持在指定的工作区中创建 agent，同时保持它是发起对话的子 agent（&quot;放置不改变归属&quot;），也能由 SDK 新建 worktree 工作区并执行 <code>paseo.json</code> 的准备脚本。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li>启动时加 <code>--worktree</code>（<code>/req</code> 中的&quot;启动（自动新建工作区）&quot;）：流水线用 Paseo 从当前分支切出 <code>feature/&lt;功能目录名&gt;</code>，新建 worktree 工作区；把需求说明等文件移过去并在新分支上提交（原处未提交的副本删除，已提交的保留）；之后各步骤 agent 放在这个工作区中运行，仍然挂在发起的对话下。</li><li><strong>对话的工作目录不变</strong>（0002 不变）。对话里的查看进度、暂停、继续、验收命令照常在原目录执行，启动器会按状态文件中记录的来源目录找到新工作区；只允许从这个来源目录的对话操作。</li><li>发给对话的通知中，功能目录和报告写完整路径，因为它们不在对话的目录里。</li><li>只用于第一次启动；已经在原处运行过的需求不能中途改为新工作区。</li><li>默认仍然是原来的方式，这是一个可选项。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>主分支上发起的需求不再需要使用者手动建工作区；<code>paseo.json</code> 的准备脚本自动执行。对话 agent 需要用完整路径读写需求文件，<code>/req</code> 中已写明。新工作区的归档和清理仍由使用者在 Paseo 中决定。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0018-own-worktree-option.md">docs/adr/0018-own-worktree-option.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0018-own-worktree-option.md">在 GitHub 上编辑</a></p>',2)])])}const k=o(i,[["render",n]]);export{u as __pageData,k as default};
+import{_ as o,o as r,c as t,a2 as a}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0018 可选：流水线为需求新建 worktree 工作区","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0018-own-worktree-option.md","filePath":"reference/adr/0018-own-worktree-option.md","lastUpdated":null}'),i={name:"reference/adr/0018-own-worktree-option.md"};function n(d,e,s,l,c,p){return r(),t("div",null,[...e[0]||(e[0]=[a('<div><h1 id="_0018-可选-流水线为需求新建-worktree-工作区" tabindex="-1">0018 可选：流水线为需求新建 worktree 工作区 <a class="header-anchor" href="#_0018-可选-流水线为需求新建-worktree-工作区" aria-label="Permalink to &quot;0018 可选：流水线为需求新建 worktree 工作区&quot;">​</a></h1><ul><li>状态：已采纳（补充 <a href="./0001-step-agents-under-origin-chat">0001</a>、<a href="./0002-no-directory-switch-in-chat">0002</a>：两条的规则不变，增加一种由流水线放置步骤的方式）</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>在项目主目录、主分支上发起的需求，原来只能请使用者自己在 Paseo 中新建 worktree 工作区、换到那里的对话重新开始，或者在主目录新建分支（主目录被占用几个小时）。对不熟悉 worktree 的使用者来说，第一种多了一次切换，第三种影响主目录。</p><p>Paseo 0.11 支持在指定的工作区中创建 agent，同时保持它是发起对话的子 agent（&quot;放置不改变归属&quot;），也能由 SDK 新建 worktree 工作区并执行 <code>paseo.json</code> 的准备脚本。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li>启动时加 <code>--worktree</code>（<code>/req</code> 中的&quot;启动（自动新建工作区）&quot;）：流水线用 Paseo 从当前分支切出 <code>feature/&lt;功能目录名&gt;</code>，新建 worktree 工作区；把需求说明等文件移过去并在新分支上提交（原处未提交的副本删除，已提交的保留）；之后各步骤 agent 放在这个工作区中运行，仍然挂在发起的对话下。</li><li><strong>对话的工作目录不变</strong>（0002 不变）。对话里的查看进度、暂停、继续、验收命令照常在原目录执行，启动器会按状态文件中记录的来源目录找到新工作区；只允许从这个来源目录的对话操作。</li><li>发给对话的通知中，功能目录和报告写完整路径，因为它们不在对话的目录里。</li><li>只用于第一次启动；已经在原处运行过的需求不能中途改为新工作区。</li><li>默认仍然是原来的方式，这是一个可选项。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>主分支上发起的需求不再需要使用者手动建工作区；<code>paseo.json</code> 的准备脚本自动执行。对话 agent 需要用完整路径读写需求文件，<code>/req</code> 中已写明。新工作区的归档和清理仍由使用者在 Paseo 中决定。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0018-own-worktree-option.md">docs/adr/0018-own-worktree-option.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0018-own-worktree-option.md">在 GitHub 上编辑</a></p>',2)])])}const k=o(i,[["render",n]]);export{u as __pageData,k as default};

package/site-dist/assets/{reference_adr_0018-own-worktree-option.md.fVDpgGSE.lean.js → reference_adr_0018-own-worktree-option.md.DgkWjYL-.lean.js}

@@ -1 +1 @@
-import{_ as o,o as r,c as t,a3 as a}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0018 可选：流水线为需求新建 worktree 工作区","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0018-own-worktree-option.md","filePath":"reference/adr/0018-own-worktree-option.md","lastUpdated":null}'),i={name:"reference/adr/0018-own-worktree-option.md"};function n(d,e,s,l,c,p){return r(),t("div",null,[...e[0]||(e[0]=[a("",2)])])}const k=o(i,[["render",n]]);export{u as __pageData,k as default};
+import{_ as o,o as r,c as t,a2 as a}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0018 可选：流水线为需求新建 worktree 工作区","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0018-own-worktree-option.md","filePath":"reference/adr/0018-own-worktree-option.md","lastUpdated":null}'),i={name:"reference/adr/0018-own-worktree-option.md"};function n(d,e,s,l,c,p){return r(),t("div",null,[...e[0]||(e[0]=[a("",2)])])}const k=o(i,[["render",n]]);export{u as __pageData,k as default};

package/site-dist/assets/{reference_adr_0019-parallel-orchestration.md.DrfrV0To.js → reference_adr_0019-parallel-orchestration.md.B9xqQidw.js}

@@ -1 +1 @@
-import{_ as a,o,c as r,a3 as t}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0019 用 Paseo 的并行子 agent：确认前独立审阅、方案提案","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0019-parallel-orchestration.md","filePath":"reference/adr/0019-parallel-orchestration.md","lastUpdated":null}'),s={name:"reference/adr/0019-parallel-orchestration.md"};function i(l,e,d,c,n,p){return o(),r("div",null,[...e[0]||(e[0]=[t('<div><h1 id="_0019-用-paseo-的并行子-agent-确认前独立审阅、方案提案" tabindex="-1">0019 用 Paseo 的并行子 agent：确认前独立审阅、方案提案 <a class="header-anchor" href="#_0019-用-paseo-的并行子-agent-确认前独立审阅、方案提案" aria-label="Permalink to &quot;0019 用 Paseo 的并行子 agent：确认前独立审阅、方案提案&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>Paseo 自带 <code>/paseo-advisor</code>（第二意见）、<code>/paseo-committee</code>（两个模型独立分析）等编排 skill。它们由聊天 agent 自由发挥，结果没有固定的去处，也不会稳定地写回需求文件；直接让 <code>/req</code> 调用它们还违反&quot;入口不调用入口&quot;（ADR 0008）。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>同样的思路由 req-kit 的引擎以固定的步骤实现，产物写进功能目录：</p><ul><li><strong>需求说明审阅</strong>（<code>--spec-review</code>）：在需求方确认之前，由 reviewer（通常与对话用的不是同一个模型）在后台独立审阅草稿，写 <code>spec-review.md</code>，把问题写成带推荐的选择题；完成后通知对话，由对话 agent 核对后逐个问用户。不改 spec、不提交。默认只用于标准档（<code>specReview</code>）。</li><li><strong>方案提案</strong>（<code>designProposals</code>，默认关闭）：标准档的方案设计之前，几个 agent（默认 builder 和 reviewer）并行各提一份方案，方案设计步骤比较后决定，并在 <code>design.md</code> 中写&quot;方案比较&quot;。增量继续时不做。</li><li><strong>浏览器验证</strong>（<code>browserVerify</code>）：步骤 agent 有 Paseo 浏览器工具时，验证类步骤按验收标准在浏览器中实际操作。</li></ul><p>Paseo 的编排 skill 仍然推荐使用者单独使用（例如对一个疑难问题请 <code>/paseo-committee</code>），文档中说明。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>确认前多一次几分钟的审阅，能在开发之前发现遗漏和歧义；方案提案以多一份方案的用量换取复杂需求的方案质量，所以默认关闭。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0019-parallel-orchestration.md">docs/adr/0019-parallel-orchestration.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0019-parallel-orchestration.md">在 GitHub 上编辑</a></p>',2)])])}const m=a(s,[["render",i]]);export{u as __pageData,m as default};
+import{_ as a,o,c as r,a2 as t}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0019 用 Paseo 的并行子 agent：确认前独立审阅、方案提案","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0019-parallel-orchestration.md","filePath":"reference/adr/0019-parallel-orchestration.md","lastUpdated":null}'),s={name:"reference/adr/0019-parallel-orchestration.md"};function i(l,e,d,c,n,p){return o(),r("div",null,[...e[0]||(e[0]=[t('<div><h1 id="_0019-用-paseo-的并行子-agent-确认前独立审阅、方案提案" tabindex="-1">0019 用 Paseo 的并行子 agent：确认前独立审阅、方案提案 <a class="header-anchor" href="#_0019-用-paseo-的并行子-agent-确认前独立审阅、方案提案" aria-label="Permalink to &quot;0019 用 Paseo 的并行子 agent：确认前独立审阅、方案提案&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>Paseo 自带 <code>/paseo-advisor</code>（第二意见）、<code>/paseo-committee</code>（两个模型独立分析）等编排 skill。它们由聊天 agent 自由发挥，结果没有固定的去处，也不会稳定地写回需求文件；直接让 <code>/req</code> 调用它们还违反&quot;入口不调用入口&quot;（ADR 0008）。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><p>同样的思路由 req-kit 的引擎以固定的步骤实现，产物写进功能目录：</p><ul><li><strong>需求说明审阅</strong>（<code>--spec-review</code>）：在需求方确认之前，由 reviewer（通常与对话用的不是同一个模型）在后台独立审阅草稿，写 <code>spec-review.md</code>，把问题写成带推荐的选择题；完成后通知对话，由对话 agent 核对后逐个问用户。不改 spec、不提交。默认只用于标准档（<code>specReview</code>）。</li><li><strong>方案提案</strong>（<code>designProposals</code>，默认关闭）：标准档的方案设计之前，几个 agent（默认 builder 和 reviewer）并行各提一份方案，方案设计步骤比较后决定，并在 <code>design.md</code> 中写&quot;方案比较&quot;。增量继续时不做。</li><li><strong>浏览器验证</strong>（<code>browserVerify</code>）：步骤 agent 有 Paseo 浏览器工具时，验证类步骤按验收标准在浏览器中实际操作。</li></ul><p>Paseo 的编排 skill 仍然推荐使用者单独使用（例如对一个疑难问题请 <code>/paseo-committee</code>），文档中说明。</p><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>确认前多一次几分钟的审阅，能在开发之前发现遗漏和歧义；方案提案以多一份方案的用量换取复杂需求的方案质量，所以默认关闭。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0019-parallel-orchestration.md">docs/adr/0019-parallel-orchestration.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0019-parallel-orchestration.md">在 GitHub 上编辑</a></p>',2)])])}const m=a(s,[["render",i]]);export{u as __pageData,m as default};

package/site-dist/assets/{reference_adr_0019-parallel-orchestration.md.DrfrV0To.lean.js → reference_adr_0019-parallel-orchestration.md.B9xqQidw.lean.js}

@@ -1 +1 @@
-import{_ as a,o,c as r,a3 as t}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0019 用 Paseo 的并行子 agent：确认前独立审阅、方案提案","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0019-parallel-orchestration.md","filePath":"reference/adr/0019-parallel-orchestration.md","lastUpdated":null}'),s={name:"reference/adr/0019-parallel-orchestration.md"};function i(l,e,d,c,n,p){return o(),r("div",null,[...e[0]||(e[0]=[t("",2)])])}const m=a(s,[["render",i]]);export{u as __pageData,m as default};
+import{_ as a,o,c as r,a2 as t}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0019 用 Paseo 的并行子 agent：确认前独立审阅、方案提案","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0019-parallel-orchestration.md","filePath":"reference/adr/0019-parallel-orchestration.md","lastUpdated":null}'),s={name:"reference/adr/0019-parallel-orchestration.md"};function i(l,e,d,c,n,p){return o(),r("div",null,[...e[0]||(e[0]=[t("",2)])])}const m=a(s,[["render",i]]);export{u as __pageData,m as default};

package/site-dist/assets/{reference_adr_0020-scheduling-through-the-chat.md.BqSemGFG.js → reference_adr_0020-scheduling-through-the-chat.md.Dh81be7G.js}

@@ -1 +1 @@
-import{_ as a,o as t,c as o,a3 as r}from"./chunks/framework.B9qR_F1m.js";const g=JSON.parse('{"title":"0020 调度：用 Paseo 定时任务把消息发回对话，排队在本机进行","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0020-scheduling-through-the-chat.md","filePath":"reference/adr/0020-scheduling-through-the-chat.md","lastUpdated":null}'),d={name:"reference/adr/0020-scheduling-through-the-chat.md"};function s(i,e,c,h,n,l){return t(),o("div",null,[...e[0]||(e[0]=[r('<div><h1 id="_0020-调度-用-paseo-定时任务把消息发回对话-排队在本机进行" tabindex="-1">0020 调度：用 Paseo 定时任务把消息发回对话，排队在本机进行 <a class="header-anchor" href="#_0020-调度-用-paseo-定时任务把消息发回对话-排队在本机进行" aria-label="Permalink to &quot;0020 调度：用 Paseo 定时任务把消息发回对话，排队在本机进行&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>需求开发要几个小时，使用者常常不在电脑前：希望晚上或明天早上再开始；限流中断后能自己接着做；等自己回答问题太久时有人提醒；同一台机器同时跑太多条流水线会抢资源和额度。</p><p>流水线进程是后台脚本，进程结束后就没有谁来做&quot;过一会儿再做某事&quot;。Paseo 的定时任务（schedules）由 daemon 保存，机器重启后仍然有效，可以在指定时间把一段话发进某个 agent 的对话，也可以按时间表启动新 agent。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li><strong>需要&quot;以后再做&quot;的事，都用 Paseo 定时任务把一条写明步骤的消息发回发起的对话</strong>，由对话 agent 执行 req-kit 的命令：预约开始（<code>--at</code>）、等待回答的提醒（<code>waitingReminderHours</code>）、临时错误后的自动继续（<code>autoResumeMinutes</code>，每次尝试最多 <code>autoResumeMax</code> 次）、可选的定时检查（<code>watchdogMinutes</code>，默认关闭）。消息先让对话 agent 查看进度，状态不符就什么也不做，所以重复或过期的消息无害。</li><li>这些定时任务记在状态文件中，下一次运行和暂停命令会取消它们；预约开始记在 <code>.pipeline/scheduled-start.json</code>。</li><li><strong>并发上限在本机实现</strong>（<code>maxConcurrentPipelines</code>，<code>~/.req-kit/slots/</code>）：排队的流水线进程自己等待名额，不需要 Paseo 参与。</li><li><strong>需求总览</strong>（<code>req digest</code>）发给外部通知；<code>--schedule</code> 用 Paseo 定时任务按时间表启动一个短暂的 agent 执行这条命令（会产生少量用量）。</li><li>Paseo 定时任务在 0.11 的公开 SDK 中还没有，和工作区脚本一样经由内部客户端调用（见 ADR 0017），不可用时这些功能自动关闭，并在输出中说明。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>使用者不在时，开发可以按时开始、出错后自己继续、等待太久会被提醒。每条定时消息会让对话 agent 运行一个回合，有少量用量；定时检查的回合最多，所以默认关闭。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0020-scheduling-through-the-chat.md">docs/adr/0020-scheduling-through-the-chat.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0020-scheduling-through-the-chat.md">在 GitHub 上编辑</a></p>',2)])])}const p=a(d,[["render",s]]);export{g as __pageData,p as default};
+import{_ as a,o as t,c as o,a2 as r}from"./chunks/framework.BetZR81g.js";const g=JSON.parse('{"title":"0020 调度：用 Paseo 定时任务把消息发回对话，排队在本机进行","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0020-scheduling-through-the-chat.md","filePath":"reference/adr/0020-scheduling-through-the-chat.md","lastUpdated":null}'),d={name:"reference/adr/0020-scheduling-through-the-chat.md"};function s(i,e,c,h,n,l){return t(),o("div",null,[...e[0]||(e[0]=[r('<div><h1 id="_0020-调度-用-paseo-定时任务把消息发回对话-排队在本机进行" tabindex="-1">0020 调度：用 Paseo 定时任务把消息发回对话，排队在本机进行 <a class="header-anchor" href="#_0020-调度-用-paseo-定时任务把消息发回对话-排队在本机进行" aria-label="Permalink to &quot;0020 调度：用 Paseo 定时任务把消息发回对话，排队在本机进行&quot;">​</a></h1><ul><li>状态：已采纳</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>需求开发要几个小时，使用者常常不在电脑前：希望晚上或明天早上再开始；限流中断后能自己接着做；等自己回答问题太久时有人提醒；同一台机器同时跑太多条流水线会抢资源和额度。</p><p>流水线进程是后台脚本，进程结束后就没有谁来做&quot;过一会儿再做某事&quot;。Paseo 的定时任务（schedules）由 daemon 保存，机器重启后仍然有效，可以在指定时间把一段话发进某个 agent 的对话，也可以按时间表启动新 agent。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li><strong>需要&quot;以后再做&quot;的事，都用 Paseo 定时任务把一条写明步骤的消息发回发起的对话</strong>，由对话 agent 执行 req-kit 的命令：预约开始（<code>--at</code>）、等待回答的提醒（<code>waitingReminderHours</code>）、临时错误后的自动继续（<code>autoResumeMinutes</code>，每次尝试最多 <code>autoResumeMax</code> 次）、可选的定时检查（<code>watchdogMinutes</code>，默认关闭）。消息先让对话 agent 查看进度，状态不符就什么也不做，所以重复或过期的消息无害。</li><li>这些定时任务记在状态文件中，下一次运行和暂停命令会取消它们；预约开始记在 <code>.pipeline/scheduled-start.json</code>。</li><li><strong>并发上限在本机实现</strong>（<code>maxConcurrentPipelines</code>，<code>~/.req-kit/slots/</code>）：排队的流水线进程自己等待名额，不需要 Paseo 参与。</li><li><strong>需求总览</strong>（<code>req digest</code>）发给外部通知；<code>--schedule</code> 用 Paseo 定时任务按时间表启动一个短暂的 agent 执行这条命令（会产生少量用量）。</li><li>Paseo 定时任务在 0.11 的公开 SDK 中还没有，和工作区脚本一样经由内部客户端调用（见 ADR 0017），不可用时这些功能自动关闭，并在输出中说明。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>使用者不在时，开发可以按时开始、出错后自己继续、等待太久会被提醒。每条定时消息会让对话 agent 运行一个回合，有少量用量；定时检查的回合最多，所以默认关闭。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0020-scheduling-through-the-chat.md">docs/adr/0020-scheduling-through-the-chat.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0020-scheduling-through-the-chat.md">在 GitHub 上编辑</a></p>',2)])])}const p=a(d,[["render",s]]);export{g as __pageData,p as default};

package/site-dist/assets/{reference_adr_0020-scheduling-through-the-chat.md.BqSemGFG.lean.js → reference_adr_0020-scheduling-through-the-chat.md.Dh81be7G.lean.js}

@@ -1 +1 @@
-import{_ as a,o as t,c as o,a3 as r}from"./chunks/framework.B9qR_F1m.js";const g=JSON.parse('{"title":"0020 调度：用 Paseo 定时任务把消息发回对话，排队在本机进行","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0020-scheduling-through-the-chat.md","filePath":"reference/adr/0020-scheduling-through-the-chat.md","lastUpdated":null}'),d={name:"reference/adr/0020-scheduling-through-the-chat.md"};function s(i,e,c,h,n,l){return t(),o("div",null,[...e[0]||(e[0]=[r("",2)])])}const p=a(d,[["render",s]]);export{g as __pageData,p as default};
+import{_ as a,o as t,c as o,a2 as r}from"./chunks/framework.BetZR81g.js";const g=JSON.parse('{"title":"0020 调度：用 Paseo 定时任务把消息发回对话，排队在本机进行","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0020-scheduling-through-the-chat.md","filePath":"reference/adr/0020-scheduling-through-the-chat.md","lastUpdated":null}'),d={name:"reference/adr/0020-scheduling-through-the-chat.md"};function s(i,e,c,h,n,l){return t(),o("div",null,[...e[0]||(e[0]=[r("",2)])])}const p=a(d,[["render",s]]);export{g as __pageData,p as default};

package/site-dist/assets/{reference_adr_0021-npm-version-manager.md.CU3PG6y5.js → reference_adr_0021-npm-version-manager.md.Pz4vZbkE.js}

@@ -1 +1 @@
-import{_ as o,o as a,c as r,a3 as n}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0021 npm 分发：全局包是版本管理器，各版本仍装在 versions/ 下","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0021-npm-version-manager.md","filePath":"reference/adr/0021-npm-version-manager.md","lastUpdated":null}'),i={name:"reference/adr/0021-npm-version-manager.md"};function t(d,e,s,c,l,p){return a(),r("div",null,[...e[0]||(e[0]=[n('<div><h1 id="_0021-npm-分发-全局包是版本管理器-各版本仍装在-versions-下" tabindex="-1">0021 npm 分发：全局包是版本管理器，各版本仍装在 versions/ 下 <a class="header-anchor" href="#_0021-npm-分发-全局包是版本管理器-各版本仍装在-versions-下" aria-label="Permalink to &quot;0021 npm 分发：全局包是版本管理器，各版本仍装在 versions/ 下&quot;">​</a></h1><ul><li>状态：已采纳（在 <a href="./0009-versioned-install-layout">0009</a>、<a href="./0016-upgrade-from-tags">0016</a> 的基础上增加 npm 来源）</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>git 安装要 clone、npm install、运行安装器三步，Windows 上还要自己把 <code>~/.req-kit/bin</code> 加进 PATH。npm 全局安装能解决这两点，但 <code>npm i -g</code> 升级时原地覆盖：正在运行的流水线每个步骤都从磁盘读提示词，会混用新旧版本，也失去了&quot;旧版本目录保留、随时回滚&quot;的保证（0009）。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li>只发布一个包 <code>paseo-req-kit</code>。用 <code>npm i -g</code> 安装的那一份是<strong>版本管理器</strong>：<code>req setup</code>、<code>req upgrade</code>、<code>req use</code>、<code>req versions</code> 由它处理，其他命令转交给 <code>~/.req-kit/active.json</code> 指向的版本。</li><li>版本仍装在 <code>~/tools/req-kit/versions/&lt;版本&gt;</code>，用 <code>npm install --prefix versions/&lt;版本&gt; paseo-req-kit@&lt;版本&gt;</code> 安装，程序在其中的 <code>node_modules/paseo-req-kit</code>。<code>req setup</code> 用 <code>npm pack</code> 把管理器自己装进去，不必再从仓库下载一次。</li><li><code>req upgrade</code> 从 npm 读版本列表，用本机 daemon 报告的版本和每个版本声明的 <code>reqKit.paseo</code> 范围筛选，只升级到能支持本机 Paseo 的版本。正式版另设 <code>paseo-&lt;小版本&gt;</code> dist-tag，供手工安装。</li><li>git 方式安装继续支持，默认来源按安装方式决定，<code>--from</code> 可以改。</li><li>发布由 GitHub Actions 在标签推送时完成，使用 npm 可信发布（OIDC），不保存 npm 口令；Release 附带 <code>npm pack</code> 的安装包供离线和内网仓库使用。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>安装变成两条命令，PATH 由 npm 处理。管理器自身很少需要升级（<code>npm i -g paseo-req-kit</code> 即可），版本切换不受影响。读不到 daemon 版本时不能按 Paseo 版本筛选，会提示并在升级后建议体检。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0021-npm-version-manager.md">docs/adr/0021-npm-version-manager.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0021-npm-version-manager.md">在 GitHub 上编辑</a></p>',2)])])}const h=o(i,[["render",t]]);export{u as __pageData,h as default};
+import{_ as o,o as a,c as r,a2 as n}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0021 npm 分发：全局包是版本管理器，各版本仍装在 versions/ 下","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0021-npm-version-manager.md","filePath":"reference/adr/0021-npm-version-manager.md","lastUpdated":null}'),i={name:"reference/adr/0021-npm-version-manager.md"};function t(d,e,s,c,l,p){return a(),r("div",null,[...e[0]||(e[0]=[n('<div><h1 id="_0021-npm-分发-全局包是版本管理器-各版本仍装在-versions-下" tabindex="-1">0021 npm 分发：全局包是版本管理器，各版本仍装在 versions/ 下 <a class="header-anchor" href="#_0021-npm-分发-全局包是版本管理器-各版本仍装在-versions-下" aria-label="Permalink to &quot;0021 npm 分发：全局包是版本管理器，各版本仍装在 versions/ 下&quot;">​</a></h1><ul><li>状态：已采纳（在 <a href="./0009-versioned-install-layout">0009</a>、<a href="./0016-upgrade-from-tags">0016</a> 的基础上增加 npm 来源）</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>git 安装要 clone、npm install、运行安装器三步，Windows 上还要自己把 <code>~/.req-kit/bin</code> 加进 PATH。npm 全局安装能解决这两点，但 <code>npm i -g</code> 升级时原地覆盖：正在运行的流水线每个步骤都从磁盘读提示词，会混用新旧版本，也失去了&quot;旧版本目录保留、随时回滚&quot;的保证（0009）。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li>只发布一个包 <code>paseo-req-kit</code>。用 <code>npm i -g</code> 安装的那一份是<strong>版本管理器</strong>：<code>req setup</code>、<code>req upgrade</code>、<code>req use</code>、<code>req versions</code> 由它处理，其他命令转交给 <code>~/.req-kit/active.json</code> 指向的版本。</li><li>版本仍装在 <code>~/tools/req-kit/versions/&lt;版本&gt;</code>，用 <code>npm install --prefix versions/&lt;版本&gt; paseo-req-kit@&lt;版本&gt;</code> 安装，程序在其中的 <code>node_modules/paseo-req-kit</code>。<code>req setup</code> 用 <code>npm pack</code> 把管理器自己装进去，不必再从仓库下载一次。</li><li><code>req upgrade</code> 从 npm 读版本列表，用本机 daemon 报告的版本和每个版本声明的 <code>reqKit.paseo</code> 范围筛选，只升级到能支持本机 Paseo 的版本。正式版另设 <code>paseo-&lt;小版本&gt;</code> dist-tag，供手工安装。</li><li>git 方式安装继续支持，默认来源按安装方式决定，<code>--from</code> 可以改。</li><li>发布由 GitHub Actions 在标签推送时完成，使用 npm 可信发布（OIDC），不保存 npm 口令；Release 附带 <code>npm pack</code> 的安装包供离线和内网仓库使用。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><p>安装变成两条命令，PATH 由 npm 处理。管理器自身很少需要升级（<code>npm i -g paseo-req-kit</code> 即可），版本切换不受影响。读不到 daemon 版本时不能按 Paseo 版本筛选，会提示并在升级后建议体检。</p></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0021-npm-version-manager.md">docs/adr/0021-npm-version-manager.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0021-npm-version-manager.md">在 GitHub 上编辑</a></p>',2)])])}const h=o(i,[["render",t]]);export{u as __pageData,h as default};

package/site-dist/assets/{reference_adr_0021-npm-version-manager.md.CU3PG6y5.lean.js → reference_adr_0021-npm-version-manager.md.Pz4vZbkE.lean.js}

@@ -1 +1 @@
-import{_ as o,o as a,c as r,a3 as n}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0021 npm 分发：全局包是版本管理器，各版本仍装在 versions/ 下","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0021-npm-version-manager.md","filePath":"reference/adr/0021-npm-version-manager.md","lastUpdated":null}'),i={name:"reference/adr/0021-npm-version-manager.md"};function t(d,e,s,c,l,p){return a(),r("div",null,[...e[0]||(e[0]=[n("",2)])])}const h=o(i,[["render",t]]);export{u as __pageData,h as default};
+import{_ as o,o as a,c as r,a2 as n}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0021 npm 分发：全局包是版本管理器，各版本仍装在 versions/ 下","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0021-npm-version-manager.md","filePath":"reference/adr/0021-npm-version-manager.md","lastUpdated":null}'),i={name:"reference/adr/0021-npm-version-manager.md"};function t(d,e,s,c,l,p){return a(),r("div",null,[...e[0]||(e[0]=[n("",2)])])}const h=o(i,[["render",t]]);export{u as __pageData,h as default};

package/site-dist/assets/{reference_adr_0022-develop-and-verify-phases.md.C6fQDLq4.js → reference_adr_0022-develop-and-verify-phases.md.35MxNOuj.js}

@@ -1 +1 @@
-import{_ as o,o as d,c as a,a3 as c}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0022 分阶段执行：研发阶段、闸口、测试验证阶段","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0022-develop-and-verify-phases.md","filePath":"reference/adr/0022-develop-and-verify-phases.md","lastUpdated":null}'),i={name:"reference/adr/0022-develop-and-verify-phases.md"};function t(r,e,l,s,n,h){return d(),a("div",null,[...e[0]||(e[0]=[c('<div><h1 id="_0022-分阶段执行-研发阶段、闸口、测试验证阶段" tabindex="-1">0022 分阶段执行：研发阶段、闸口、测试验证阶段 <a class="header-anchor" href="#_0022-分阶段执行-研发阶段、闸口、测试验证阶段" aria-label="Permalink to &quot;0022 分阶段执行：研发阶段、闸口、测试验证阶段&quot;">​</a></h1><ul><li>状态：已采纳（补充 <a href="./0015-incremental-continue">0015</a>、<a href="./0018-own-worktree-option">0018</a>：测试阶段可以由同一仓库另一个工作区的对话接手）</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>原来第 3–11 步一口气跑完，只在方案审核需要需求方决定时停下。很多团队的研发和测试是两拨人、两个节奏：研发完成要&quot;提测&quot;，测试同事先部署测试环境、准备数据，再验证，或者干脆人工测试；验证也可能想用另一个模型，在另一个时间进行。</p><p>代码评审通过之后、服务启动和功能验证之前，是天然的分界。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li>分成固定的两个阶段：<strong>研发</strong>（方案设计 → 方案审核 ⇄ 修订 → 实现 → 代码评审 ⇄ 修复 → 提测说明）和<strong>测试验证</strong>（服务启动 → 功能验证 → 缺陷处理），中间一个闸口。不做任意切分、可配置的阶段：常见的交接点只有&quot;提测&quot;一处，任意切分会让状态、继续规则和手册都变复杂。阶段名在状态里用字符串（<code>develop</code>、<code>verify</code>），以后增加阶段不用改格式。</li><li>研发阶段最后新增一步&quot;提测说明&quot;（builder，<code>handoff.md</code>）。三种执行方式都写：连续时它是功能验证的输入，分阶段时是交给测试的单据，只做研发时是人工测试的依据。</li><li>闸口怎么走由<strong>执行方式</strong>决定，来源后者覆盖前者：配置 <code>phases.mode</code> → spec 头部 <code>- 执行方式：</code> → 启动参数 <code>--phases</code>。 <ul><li><code>continuous</code>（连续，默认）：直接进入测试验证，与之前的行为一致。</li><li><code>gated</code>（分阶段）：状态变为 <code>phase_done</code>，进程正常退出、不占排队名额；通知对话&quot;研发完成，可以提测&quot;，外部通知新事件 <code>phase_done</code>；等待提醒（<code>waitingReminderHours</code>）也覆盖这个状态。<code>--resume --phase verify</code>（或在闸口单独的 <code>--resume</code>）开始测试验证，沿用研发阶段的结果。<code>--verify-at</code> 在研发完成时预约开始时间（复用 <a href="./0020-scheduling-through-the-chat">0020</a> 的定时任务）；研发完成时时间已过就直接继续。</li><li><code>develop-only</code>（只做研发）：写完提测说明后写一份研发报告并结束，状态为 <code>completed</code>；之后仍可用 <code>--phase verify</code> 让流水线做测试验证。</li></ul></li><li>测试验证阶段的选项写在 <code>phases.verify</code>，开始测试时也可以用参数临时指定： <ul><li><code>environment</code>：<code>local</code>（本地启动服务）或 <code>deployed</code>（对已部署的测试环境验证，需要功能目录中的 <code>test-env.md</code>，没有就拒绝开始；不在本地启动服务）。</li><li><code>agents</code>：测试阶段的步骤（服务启动、功能验证、缺陷修复、复验）可以用单独的 agent，格式同顶层 <code>agents</code>，可用 <code>paseoProfile</code>。完成报告仍用顶层的 builder。</li><li><code>defects</code>：<code>fix</code>（当场修复并复验，原来的做法）、<code>handback</code>（只记录，退回研发阶段：在 <code>changes.md</code> 追加&quot;测试验证退回&quot;一节，开始新的一次尝试，按 <a href="./0015-incremental-continue">0015</a> 从方案设计增量处理，修复经过代码评审、重新写提测说明后再提测；次数上限为档位的缺陷修复轮数）、<code>report</code>（只记录，直接出报告）。</li></ul></li><li>测试阶段开始前需求说明改过：按增量继续的规则回到研发阶段的方案设计。</li><li><strong>测试同事接手</strong>：需求在自动新建的工作区中开发（0018）且研发已完成（或已在测试验证阶段）时，同一仓库任何工作区中的对话都可以开始或继续测试验证；通知转到那个对话，步骤仍放在需求的工作区、挂在那个对话下。研发阶段仍然只能从来源目录的对话操作。不在自动新建工作区中的需求，测试同事需要在同一目录的对话中接手（步骤 agent 使用对话的目录，见 <a href="./0001-step-agents-under-origin-chat">0001</a>）。</li><li>安全边界不变：测试环境只能是测试用途的环境；<code>test-env.md</code> 只写口令在哪里取，不写口令本身；提示词继续禁止连接生产环境、使用生产凭据。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><ul><li>状态文件只增加可选字段（<code>phases</code>、<code>phase</code>、<code>verifyAt</code>、<code>handbacks</code>、步骤记录的 <code>phase</code>）和状态值 <code>phase_done</code>，格式版本仍为 1。回滚到 1.6 后，旧引擎把 <code>phase_done</code> 当作可以继续的中断，继续时沿用研发结果、直接做验证，可以接受。</li><li>所有运行（包括连续方式）多一个&quot;提测说明&quot;步骤，通常几分钟。</li><li>外部通知按约定只增加了事件类型 <code>phase_done</code> 和字段。</li><li>用时与用量可以按阶段统计（状态、完成报告）。</li></ul></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0022-develop-and-verify-phases.md">docs/adr/0022-develop-and-verify-phases.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0022-develop-and-verify-phases.md">在 GitHub 上编辑</a></p>',2)])])}const f=o(i,[["render",t]]);export{u as __pageData,f as default};
+import{_ as o,o as d,c as a,a2 as c}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0022 分阶段执行：研发阶段、闸口、测试验证阶段","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0022-develop-and-verify-phases.md","filePath":"reference/adr/0022-develop-and-verify-phases.md","lastUpdated":null}'),i={name:"reference/adr/0022-develop-and-verify-phases.md"};function t(r,e,l,s,n,h){return d(),a("div",null,[...e[0]||(e[0]=[c('<div><h1 id="_0022-分阶段执行-研发阶段、闸口、测试验证阶段" tabindex="-1">0022 分阶段执行：研发阶段、闸口、测试验证阶段 <a class="header-anchor" href="#_0022-分阶段执行-研发阶段、闸口、测试验证阶段" aria-label="Permalink to &quot;0022 分阶段执行：研发阶段、闸口、测试验证阶段&quot;">​</a></h1><ul><li>状态：已采纳（补充 <a href="./0015-incremental-continue">0015</a>、<a href="./0018-own-worktree-option">0018</a>：测试阶段可以由同一仓库另一个工作区的对话接手）</li></ul><h2 id="背景" tabindex="-1">背景 <a class="header-anchor" href="#背景" aria-label="Permalink to &quot;背景&quot;">​</a></h2><p>原来第 3–11 步一口气跑完，只在方案审核需要需求方决定时停下。很多团队的研发和测试是两拨人、两个节奏：研发完成要&quot;提测&quot;，测试同事先部署测试环境、准备数据，再验证，或者干脆人工测试；验证也可能想用另一个模型，在另一个时间进行。</p><p>代码评审通过之后、服务启动和功能验证之前，是天然的分界。</p><h2 id="决定" tabindex="-1">决定 <a class="header-anchor" href="#决定" aria-label="Permalink to &quot;决定&quot;">​</a></h2><ul><li>分成固定的两个阶段：<strong>研发</strong>（方案设计 → 方案审核 ⇄ 修订 → 实现 → 代码评审 ⇄ 修复 → 提测说明）和<strong>测试验证</strong>（服务启动 → 功能验证 → 缺陷处理），中间一个闸口。不做任意切分、可配置的阶段：常见的交接点只有&quot;提测&quot;一处，任意切分会让状态、继续规则和手册都变复杂。阶段名在状态里用字符串（<code>develop</code>、<code>verify</code>），以后增加阶段不用改格式。</li><li>研发阶段最后新增一步&quot;提测说明&quot;（builder，<code>handoff.md</code>）。三种执行方式都写：连续时它是功能验证的输入，分阶段时是交给测试的单据，只做研发时是人工测试的依据。</li><li>闸口怎么走由<strong>执行方式</strong>决定，来源后者覆盖前者：配置 <code>phases.mode</code> → spec 头部 <code>- 执行方式：</code> → 启动参数 <code>--phases</code>。 <ul><li><code>continuous</code>（连续，默认）：直接进入测试验证，与之前的行为一致。</li><li><code>gated</code>（分阶段）：状态变为 <code>phase_done</code>，进程正常退出、不占排队名额；通知对话&quot;研发完成，可以提测&quot;，外部通知新事件 <code>phase_done</code>；等待提醒（<code>waitingReminderHours</code>）也覆盖这个状态。<code>--resume --phase verify</code>（或在闸口单独的 <code>--resume</code>）开始测试验证，沿用研发阶段的结果。<code>--verify-at</code> 在研发完成时预约开始时间（复用 <a href="./0020-scheduling-through-the-chat">0020</a> 的定时任务）；研发完成时时间已过就直接继续。</li><li><code>develop-only</code>（只做研发）：写完提测说明后写一份研发报告并结束，状态为 <code>completed</code>；之后仍可用 <code>--phase verify</code> 让流水线做测试验证。</li></ul></li><li>测试验证阶段的选项写在 <code>phases.verify</code>，开始测试时也可以用参数临时指定： <ul><li><code>environment</code>：<code>local</code>（本地启动服务）或 <code>deployed</code>（对已部署的测试环境验证，需要功能目录中的 <code>test-env.md</code>，没有就拒绝开始；不在本地启动服务）。</li><li><code>agents</code>：测试阶段的步骤（服务启动、功能验证、缺陷修复、复验）可以用单独的 agent，格式同顶层 <code>agents</code>，可用 <code>paseoProfile</code>。完成报告仍用顶层的 builder。</li><li><code>defects</code>：<code>fix</code>（当场修复并复验，原来的做法）、<code>handback</code>（只记录，退回研发阶段：在 <code>changes.md</code> 追加&quot;测试验证退回&quot;一节，开始新的一次尝试，按 <a href="./0015-incremental-continue">0015</a> 从方案设计增量处理，修复经过代码评审、重新写提测说明后再提测；次数上限为档位的缺陷修复轮数）、<code>report</code>（只记录，直接出报告）。</li></ul></li><li>测试阶段开始前需求说明改过：按增量继续的规则回到研发阶段的方案设计。</li><li><strong>测试同事接手</strong>：需求在自动新建的工作区中开发（0018）且研发已完成（或已在测试验证阶段）时，同一仓库任何工作区中的对话都可以开始或继续测试验证；通知转到那个对话，步骤仍放在需求的工作区、挂在那个对话下。研发阶段仍然只能从来源目录的对话操作。不在自动新建工作区中的需求，测试同事需要在同一目录的对话中接手（步骤 agent 使用对话的目录，见 <a href="./0001-step-agents-under-origin-chat">0001</a>）。</li><li>安全边界不变：测试环境只能是测试用途的环境；<code>test-env.md</code> 只写口令在哪里取，不写口令本身；提示词继续禁止连接生产环境、使用生产凭据。</li></ul><h2 id="影响" tabindex="-1">影响 <a class="header-anchor" href="#影响" aria-label="Permalink to &quot;影响&quot;">​</a></h2><ul><li>状态文件只增加可选字段（<code>phases</code>、<code>phase</code>、<code>verifyAt</code>、<code>handbacks</code>、步骤记录的 <code>phase</code>）和状态值 <code>phase_done</code>，格式版本仍为 1。回滚到 1.6 后，旧引擎把 <code>phase_done</code> 当作可以继续的中断，继续时沿用研发结果、直接做验证，可以接受。</li><li>所有运行（包括连续方式）多一个&quot;提测说明&quot;步骤，通常几分钟。</li><li>外部通知按约定只增加了事件类型 <code>phase_done</code> 和字段。</li><li>用时与用量可以按阶段统计（状态、完成报告）。</li></ul></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/adr/0022-develop-and-verify-phases.md">docs/adr/0022-develop-and-verify-phases.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/adr/0022-develop-and-verify-phases.md">在 GitHub 上编辑</a></p>',2)])])}const f=o(i,[["render",t]]);export{u as __pageData,f as default};

package/site-dist/assets/{reference_adr_0022-develop-and-verify-phases.md.C6fQDLq4.lean.js → reference_adr_0022-develop-and-verify-phases.md.35MxNOuj.lean.js}

@@ -1 +1 @@
-import{_ as o,o as d,c as a,a3 as c}from"./chunks/framework.B9qR_F1m.js";const u=JSON.parse('{"title":"0022 分阶段执行：研发阶段、闸口、测试验证阶段","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0022-develop-and-verify-phases.md","filePath":"reference/adr/0022-develop-and-verify-phases.md","lastUpdated":null}'),i={name:"reference/adr/0022-develop-and-verify-phases.md"};function t(r,e,l,s,n,h){return d(),a("div",null,[...e[0]||(e[0]=[c("",2)])])}const f=o(i,[["render",t]]);export{u as __pageData,f as default};
+import{_ as o,o as d,c as a,a2 as c}from"./chunks/framework.BetZR81g.js";const u=JSON.parse('{"title":"0022 分阶段执行：研发阶段、闸口、测试验证阶段","description":"","frontmatter":{"editLink":false},"headers":[],"relativePath":"reference/adr/0022-develop-and-verify-phases.md","filePath":"reference/adr/0022-develop-and-verify-phases.md","lastUpdated":null}'),i={name:"reference/adr/0022-develop-and-verify-phases.md"};function t(r,e,l,s,n,h){return d(),a("div",null,[...e[0]||(e[0]=[c("",2)])])}const f=o(i,[["render",t]]);export{u as __pageData,f as default};