paseo-req-kit 1.13.0 → 1.14.0-beta.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +21 -0
- package/contracts/cli-json.md +4 -4
- package/contracts/usage-record.md +5 -1
- package/docs/guide//344/275/277/347/224/250/350/200/205/346/214/207/345/215/227.md +2 -0
- package/docs/guide//351/241/271/347/233/256/345/256/232/345/210/266/344/270/216/350/277/220/350/241/214/350/247/204/345/210/231.md +5 -0
- package/engine/src/api.ts +106 -5
- package/engine/src/cli-args.ts +3 -0
- package/engine/src/features.ts +43 -4
- package/engine/src/launch.ts +25 -4
- package/engine/src/paseo-runtime.ts +5 -0
- package/engine/src/preflight.ts +2 -0
- package/engine/src/records.ts +24 -2
- package/engine/src/runtime.ts +2 -0
- package/engine/src/worktree.ts +180 -25
- package/package.json +1 -1
- package/paseo-plugin/client/format.ts +6 -2
- package/paseo-plugin/client/inbox.tsx +6 -1
- package/paseo-plugin/package.json +1 -1
- package/paseo-plugin/shared/contracts.ts +4 -2
- package/site-dist/404.html +2 -2
- package/site-dist/assets/{app.C6QQarr3.js → app.gI1JF182.js} +1 -1
- package/site-dist/assets/changelog.md.2xf690VW.js +1 -0
- package/site-dist/assets/chunks/@localSearchIndexroot.CiFeI6qC.js +1 -0
- package/site-dist/assets/chunks/{VPLocalSearchBox.NZKA1cjk.js → VPLocalSearchBox.DNmhkkfS.js} +1 -1
- package/site-dist/assets/chunks/{theme.BP9XiatK.js → theme.CZzkCOAC.js} +2 -2
- package/site-dist/assets/{guide_getting-started.md.CA-aS0r_.js → guide_getting-started.md.zmtXv15G.js} +1 -1
- package/site-dist/assets/guide_project.md.Csi5wiyt.js +77 -0
- package/site-dist/assets/guide_project.md.Csi5wiyt.lean.js +77 -0
- package/site-dist/assets/{guide_user.md.Cenm9vlN.js → guide_user.md.2v7b_fzd.js} +1 -1
- package/site-dist/assets/{guide_user.md.Cenm9vlN.lean.js → guide_user.md.2v7b_fzd.lean.js} +1 -1
- package/site-dist/assets/reference_contracts_cli-json.md.BR6gwq-e.js +1 -0
- package/site-dist/assets/reference_contracts_cli-json.md.BR6gwq-e.lean.js +1 -0
- package/site-dist/assets/reference_contracts_usage-record.md.D5krNLW7.js +10 -0
- package/site-dist/assets/reference_contracts_usage-record.md.D5krNLW7.lean.js +10 -0
- package/site-dist/changelog.html +5 -5
- package/site-dist/guide/getting-started.html +5 -5
- package/site-dist/guide/how-it-works.html +4 -4
- package/site-dist/guide/index.html +4 -4
- package/site-dist/guide/install.html +4 -4
- package/site-dist/guide/maintainer.html +4 -4
- package/site-dist/guide/phases.html +4 -4
- package/site-dist/guide/project.html +6 -6
- package/site-dist/guide/user.html +5 -5
- package/site-dist/hashmap.json +1 -1
- package/site-dist/index.html +4 -4
- package/site-dist/reference/adr/0001-step-agents-under-origin-chat.html +4 -4
- package/site-dist/reference/adr/0002-no-directory-switch-in-chat.html +4 -4
- package/site-dist/reference/adr/0003-script-engine-not-hub.html +4 -4
- package/site-dist/reference/adr/0004-result-files.html +4 -4
- package/site-dist/reference/adr/0005-no-default-branch-local-commits-only.html +4 -4
- package/site-dist/reference/adr/0006-skill-install-targets.html +4 -4
- package/site-dist/reference/adr/0007-own-interview-skill.html +4 -4
- package/site-dist/reference/adr/0008-entries-do-not-call-entries.html +4 -4
- package/site-dist/reference/adr/0009-versioned-install-layout.html +4 -4
- package/site-dist/reference/adr/0010-generated-feature-overview.html +4 -4
- package/site-dist/reference/adr/0011-resume-after-completion.html +4 -4
- package/site-dist/reference/adr/0012-review-panel.html +4 -4
- package/site-dist/reference/adr/0013-no-release-tooling.html +4 -4
- package/site-dist/reference/adr/0014-notifier-slot.html +4 -4
- package/site-dist/reference/adr/0015-incremental-continue.html +4 -4
- package/site-dist/reference/adr/0016-upgrade-from-tags.html +4 -4
- package/site-dist/reference/adr/0017-use-paseo-capabilities.html +4 -4
- package/site-dist/reference/adr/0018-own-worktree-option.html +4 -4
- package/site-dist/reference/adr/0019-parallel-orchestration.html +4 -4
- package/site-dist/reference/adr/0020-scheduling-through-the-chat.html +4 -4
- package/site-dist/reference/adr/0021-npm-version-manager.html +4 -4
- package/site-dist/reference/adr/0022-develop-and-verify-phases.html +4 -4
- package/site-dist/reference/adr/0023-types-gate-slices.html +4 -4
- package/site-dist/reference/adr/0024-confirm-early-review-axes.html +4 -4
- package/site-dist/reference/adr/0025-joint-requirements.html +4 -4
- package/site-dist/reference/adr/0026-machine-records-and-api.html +4 -4
- package/site-dist/reference/adr/0027-paseo-plugin.html +4 -4
- package/site-dist/reference/adr/0028-external-integrations.html +4 -4
- package/site-dist/reference/adr/0029-requirements-from-cards.html +4 -4
- package/site-dist/reference/adr/0030-card-intake-process.html +4 -4
- package/site-dist/reference/adr/0031-fewer-interventions.html +4 -4
- package/site-dist/reference/adr/0032-npm-only-install.html +4 -4
- package/site-dist/reference/adr/0033-prototype-review-and-ui-check.html +4 -4
- package/site-dist/reference/adr/index.html +4 -4
- package/site-dist/reference/commands.html +4 -4
- package/site-dist/reference/config.html +4 -4
- package/site-dist/reference/contracts/cli-json.html +5 -5
- package/site-dist/reference/contracts/feature-files.html +4 -4
- package/site-dist/reference/contracts/index.html +4 -4
- package/site-dist/reference/contracts/notifier-event.html +4 -4
- package/site-dist/reference/contracts/result-file.html +4 -4
- package/site-dist/reference/contracts/spec.html +4 -4
- package/site-dist/reference/contracts/state.html +4 -4
- package/site-dist/reference/contracts/usage-record.html +6 -6
- package/site-dist/reference/contracts/verify.html +4 -4
- package/site-dist/reference/scope.html +4 -4
- package/skills/req/SKILL.md +1 -0
- package/skills/req/playbooks/incident.md +3 -3
- package/skills/req/playbooks/new.md +1 -1
- package/skills/req/playbooks/small.md +1 -1
- package/skills/spec-writing/SKILL.md +3 -1
- package/site-dist/assets/changelog.md.BzAEYWi7.js +0 -1
- package/site-dist/assets/chunks/@localSearchIndexroot.BjRGqGQa.js +0 -1
- package/site-dist/assets/guide_project.md.qQLH2fWy.js +0 -77
- package/site-dist/assets/guide_project.md.qQLH2fWy.lean.js +0 -77
- package/site-dist/assets/reference_contracts_cli-json.md.B7o8deSY.js +0 -1
- package/site-dist/assets/reference_contracts_cli-json.md.B7o8deSY.lean.js +0 -1
- package/site-dist/assets/reference_contracts_usage-record.md.DBMNY4OP.js +0 -10
- package/site-dist/assets/reference_contracts_usage-record.md.DBMNY4OP.lean.js +0 -10
- /package/site-dist/assets/{changelog.md.BzAEYWi7.lean.js → changelog.md.2xf690VW.lean.js} +0 -0
- /package/site-dist/assets/{guide_getting-started.md.CA-aS0r_.lean.js → guide_getting-started.md.zmtXv15G.lean.js} +0 -0
|
@@ -9,11 +9,11 @@
|
|
|
9
9
|
<link rel="preload stylesheet" href="/assets/style.Dwsa4SMe.css" as="style">
|
|
10
10
|
<link rel="preload stylesheet" href="/vp-icons.css" as="style">
|
|
11
11
|
|
|
12
|
-
<script type="module" src="/assets/app.
|
|
12
|
+
<script type="module" src="/assets/app.gI1JF182.js"></script>
|
|
13
13
|
<link rel="preload" href="/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
|
-
<link rel="modulepreload" href="/assets/chunks/theme.
|
|
14
|
+
<link rel="modulepreload" href="/assets/chunks/theme.CZzkCOAC.js">
|
|
15
15
|
<link rel="modulepreload" href="/assets/chunks/framework.B9qR_F1m.js">
|
|
16
|
-
<link rel="modulepreload" href="/assets/guide_project.md.
|
|
16
|
+
<link rel="modulepreload" href="/assets/guide_project.md.Csi5wiyt.lean.js">
|
|
17
17
|
<link rel="icon" type="image/svg+xml" href="/logo.svg">
|
|
18
18
|
<meta name="theme-color" content="#3f6fd8">
|
|
19
19
|
<meta property="og:type" content="website">
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
<script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
|
|
24
24
|
</head>
|
|
25
25
|
<body>
|
|
26
|
-
<div id="app"><div class="Layout" data-v-d8b57b2d><!--[--><!--]--><!--[--><span tabindex="-1" data-v-fcbfc0e0></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-fcbfc0e0>Skip to content</a><!--]--><!----><header class="VPNav" data-v-d8b57b2d data-v-7ad780c2><div class="VPNavBar" data-v-7ad780c2 data-v-9fd4d1dd><div class="wrapper" data-v-9fd4d1dd><div class="container" data-v-9fd4d1dd><div class="title" data-v-9fd4d1dd><div class="VPNavBarTitle has-sidebar" data-v-9fd4d1dd data-v-9f43907a><a class="title" href="/" data-v-9f43907a><!--[--><!--]--><!--[--><img class="VPImage logo" src="/logo.svg" alt data-v-ab19afbb><!--]--><span data-v-9f43907a>req-kit</span><!--[--><!--]--></a></div></div><div class="content" data-v-9fd4d1dd><div class="content-body" data-v-9fd4d1dd><!--[--><!--]--><div class="VPNavBarSearch search" data-v-9fd4d1dd><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="搜索文档"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">搜索文档</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-9fd4d1dd data-v-afb2845e><span id="main-nav-aria-label" class="visually-hidden" data-v-afb2845e> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/guide/" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>指南</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/reference/commands" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>参考</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/changelog" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>更新记录</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-afb2845e data-v-bfe7971f><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-bfe7971f><span class="text" data-v-bfe7971f><!----><span data-v-bfe7971f>v1.13.0</span><span class="vpi-chevron-down text-icon" data-v-bfe7971f></span></span></button><div class="menu" data-v-bfe7971f><div class="VPMenu" data-v-bfe7971f data-v-20ed86d6><div class="items" data-v-20ed86d6><!--[--><!--[--><div class="VPMenuLink" data-v-20ed86d6 data-v-7eeeb2dc><a class="VPLink link" href="/changelog" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>更新记录</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-20ed86d6 data-v-7eeeb2dc><a class="VPLink link vp-external-link-icon" href="https://github.com/yiyisf/paseo-req-kit/releases" target="_blank" rel="noreferrer" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>GitHub Releases</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-20ed86d6 data-v-7eeeb2dc><a class="VPLink link" href="/reference/scope" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>范围与取舍</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-9fd4d1dd data-v-3f90c1a5><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-3f90c1a5 data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-9fd4d1dd data-v-ef6192dc data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://github.com/yiyisf/paseo-req-kit" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-60a9a2d3><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-9fd4d1dd data-v-f953d92f data-v-bfe7971f><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-bfe7971f><span class="vpi-more-horizontal icon" data-v-bfe7971f></span></button><div class="menu" data-v-bfe7971f><div class="VPMenu" data-v-bfe7971f data-v-20ed86d6><!----><!--[--><!--[--><!----><div class="group" data-v-f953d92f><div class="item appearance" data-v-f953d92f><p class="label" data-v-f953d92f>外观</p><div class="appearance-action" data-v-f953d92f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-f953d92f data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div></div></div><div class="group" data-v-f953d92f><div class="item social-links" data-v-f953d92f><div class="VPSocialLinks social-links-list" data-v-f953d92f data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://github.com/yiyisf/paseo-req-kit" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-60a9a2d3><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-9fd4d1dd data-v-6bee1efd><span class="container" data-v-6bee1efd><span class="top" data-v-6bee1efd></span><span class="middle" data-v-6bee1efd></span><span class="bottom" data-v-6bee1efd></span></span></button></div></div></div></div><div class="divider" data-v-9fd4d1dd><div class="divider-line" data-v-9fd4d1dd></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-d8b57b2d data-v-2488c25a><div class="container" data-v-2488c25a><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-2488c25a><span class="vpi-align-left menu-icon" data-v-2488c25a></span><span class="menu-text" data-v-2488c25a>目录</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-2488c25a data-v-6b867909><button data-v-6b867909>回到顶部</button><!----></div></div></div><aside class="VPSidebar" data-v-d8b57b2d data-v-42c4c606><div class="curtain" data-v-42c4c606></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-42c4c606><span class="visually-hidden" id="sidebar-aria-label" data-v-42c4c606> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>开始</h2><!----></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/" data-v-0009425e><!--[--><p class="text" data-v-0009425e>req-kit 是什么</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/getting-started" data-v-0009425e><!--[--><p class="text" data-v-0009425e>快速开始</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/how-it-works" data-v-0009425e><!--[--><p class="text" data-v-0009425e>工作原理</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>使用</h2><!----></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/user" data-v-0009425e><!--[--><p class="text" data-v-0009425e>使用者指南</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/phases" data-v-0009425e><!--[--><p class="text" data-v-0009425e>分阶段执行与提测</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 has-active" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>安装与维护</h2><!----></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/install" data-v-0009425e><!--[--><p class="text" data-v-0009425e>安装与升级</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/project" data-v-0009425e><!--[--><p class="text" data-v-0009425e>项目定制与运行规则</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/maintainer" data-v-0009425e><!--[--><p class="text" data-v-0009425e>维护者指南</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-d8b57b2d data-v-9a6c75ad><div class="VPDoc has-sidebar has-aside" data-v-9a6c75ad data-v-e6f2a212><!--[--><!--]--><div class="container" data-v-e6f2a212><div class="aside" data-v-e6f2a212><div class="aside-curtain" data-v-e6f2a212></div><div class="aside-container" data-v-e6f2a212><div class="aside-content" data-v-e6f2a212><div class="VPDocAside" data-v-e6f2a212 data-v-cb998dce><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-cb998dce data-v-f610f197><div class="content" data-v-f610f197><div class="outline-marker" data-v-f610f197></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-f610f197>本页内容</div><ul class="VPDocOutlineItem root" data-v-f610f197 data-v-53c99d69><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-cb998dce></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-e6f2a212><div class="content-container" data-v-e6f2a212><!--[--><!--]--><main class="main" data-v-e6f2a212><div style="position:relative;" class="vp-doc _guide_project external-link-icon-enabled" data-v-e6f2a212><div><div><h1 id="项目定制与运行规则" tabindex="-1">项目定制与运行规则 <a class="header-anchor" href="#项目定制与运行规则" aria-label="Permalink to "项目定制与运行规则""></a></h1><h2 id="每个需求一个-worktree-工作区" tabindex="-1">每个需求一个 worktree 工作区 <a class="header-anchor" href="#每个需求一个-worktree-工作区" aria-label="Permalink to "每个需求一个 worktree 工作区""></a></h2><p>在 Paseo 中为每个需求新建工作区：<strong>New workspace</strong> → 选择项目 → <strong>Isolation</strong> 选 <strong>New worktree</strong> → 起点选主分支，然后在这个工作区的对话里输入 <code>/req</code>。</p><ul><li>流水线在这个工作区自己的目录和分支上运行、提交，不影响项目主目录。</li><li>同一个目录一次只能运行一条流水线；用了 worktree，几个需求可以同时进行。</li><li>在主目录发起时，<code>/req</code> 会先建议改用 worktree；使用者坚持的话，它会新建 <code>feature/<功能目录名></code> 分支再继续。</li></ul><p><strong>分支规则</strong>：流水线把启动时检出的分支作为本次需求的工作分支，所有步骤都提交到这里，不切换、不新建分支。它拒绝在默认分支（<code>main</code>、<code>master</code> 或 <code>origin/HEAD</code> 指向的分支）或 detached HEAD 上启动；续跑时分支变了也会拒绝。</p><h2 id="档位" tabindex="-1">档位 <a class="header-anchor" href="#档位" aria-label="Permalink to "档位""></a></h2><table tabindex="0"><thead><tr><th>档位</th><th>适用</th><th>访谈</th><th>流程</th></tr></thead><tbody><tr><td>快速（<code>quick</code>）</td><td>小改动：文案、样式、配置项、字段显示等，不涉及数据结构、权限、对外接口</td><td>只问要改什么、改成什么样、不改什么、验收标准</td><td>审核、评审、缺陷修复各一轮；不做服务启动验证；产物从简</td></tr><tr><td>标准（<code>standard</code>）</td><td>其他情况</td><td>完整访谈</td><td>审核最多 2 轮、评审最多 3 轮、缺陷修复最多 3 轮</td></tr></tbody></table><p><code>/req</code> 会根据需求推荐档位，用户确认后写进 spec（<code>- 档位：快速</code>）。流水线按以下顺序决定档位：<code>--profile</code> 参数 → 续跑时沿用上次的档位 → spec 中的档位 → 配置中的 <code>defaultProfile</code>。各档的轮数和是否做服务启动验证可以在配置的 <code>profiles</code> 中调整。</p><h2 id="需求类型" tabindex="-1">需求类型 <a class="header-anchor" href="#需求类型" aria-label="Permalink to "需求类型""></a></h2><p>spec 头部的 <code>- 类型：</code> 决定流水线走哪种做法（1.8 起）。缺陷、重构、评估有自己的做法，新需求和小改动走通常的流程：</p><table tabindex="0"><thead><tr><th>类型</th><th>做法</th><th>关键证据</th></tr></thead><tbody><tr><td>缺陷（<code>缺陷</code>、<code>bug</code>）</td><td>方案设计改为"复现与定位"：先提交一个修复前失败的复现测试或脚本，写 <code>diagnosis.md</code>（根因、影响面）；复现不了就暂停，把需要补充的信息发回对话。修复要让复现转绿，评审实际确认它修复前失败</td><td>同一个复现，修复前失败、修复后通过</td></tr><tr><td>重构（<code>重构</code>、<code>技术改进</code>）</td><td>先补特征测试锁住现有行为并单独提交，再小步改动、每步全绿；评审的首要问题是"行为有没有变"</td><td>重构前后同一组测试一致</td></tr><tr><td>评估（<code>评估</code>、<code>调研</code>）</td><td>只读：调研评估（<code>assessment.md</code>）→ 评估审阅 ⇄ 修订 → 评估报告；没有实现、评审、提测和验证，执行方式按连续</td><td>引用的代码位置和实际运行的命令</td></tr></tbody></table><p>各类型的做法写在 <code>engine/prompts/types/<类型>.md</code>，按步骤分节，接在每一步的任务之后；可以用 <code>prompts.local/types/</code> 覆盖。不想用某个类型的做法时，从配置 <code>requirementTypes</code>（默认 <code>["defect", "refactor", "assessment"]</code>）中去掉它，这个类型就按新需求处理。设计决定见 ADR 0023。</p><h2 id="方案确认点-开工前请需求方确认-做完后会看到什么" tabindex="-1">方案确认点：开工前请需求方确认"做完后会看到什么" <a class="header-anchor" href="#方案确认点-开工前请需求方确认-做完后会看到什么" aria-label="Permalink to "方案确认点：开工前请需求方确认"做完后会看到什么"""></a></h2><p>方案审核通过后、写代码之前，流水线可以停下来请需求方确认（1.8 起）。方案设计写 <code>preview.md</code>（按操作顺序描述做完后会看到什么、需要确认的假设、不会变的地方），界面改动还在 <code>prototype/</code> 中画出静态的原型页面。对话里的 AI 把要点讲给需求方：确认后执行 <code>--approve</code>（终端里 <code>req approve <需求></code>）开始写代码；要改的，更新需求说明后 <code>--resume</code>，方案调整后再确认一次。需求方确认过的预览和原型，实现和功能验证都以它为准：界面与原型不一致按缺陷处理。</p><table tabindex="0"><thead><tr><th>配置</th><th>默认</th><th>说明</th></tr></thead><tbody><tr><td><code>designApproval.mode</code></td><td><code>ui</code></td><td><code>ui</code>：方案判断这次是界面改动（结果文件 <code>ui_change</code>）时才停；<code>always</code>：每次都停；<code>off</code>：不停</td></tr><tr><td><code>designApproval.profiles</code></td><td><code>["standard"]</code></td><td>哪些档位使用；快速档默认不停</td></tr><tr><td><code>designApproval.autoContinueHours</code></td><td>0</td><td>大于 0 时，等了这么久还没确认就按方案继续（通过对话执行）；0 表示一直等待。等待超过 <code>waitingReminderHours</code> 会提醒一次</td></tr></tbody></table><p>等待确认时进度显示"等待需求方确认方案"，需求总览归入"需要处理"，外部通知收到 <code>approval</code> 事件。评估类需求不写代码，不经过确认点。</p><p><strong>原型审查页（1.13 起）。</strong> 有 <code>prototype/</code> 的需求，插件的需求页面和"等你处理"里有"审查原型"按钮（等待确认方案时是最醒目的"审查原型并确认方案"），审查页嵌在 Paseo 的网页端和桌面端里打开，手机上在浏览器中打开；终端里是 <code>req review <需求></code>。需求方在原型上点选要改的地方（页面记下元素、文字、颜色、大小和位置）、双击直接改文字，切换状态和电脑、手机宽度，然后提交：意见整理成带位置信息的清单转给需求会话（与插件中写修改意见的效果相同），或者直接确认方案。草稿和提交记录在功能目录的 <code>.pipeline/review/</code> 中，每一版原型也存在那里，原型改过后页面会标出这一版改了哪里。</p><p>为了让审查页能用，方案设计按约定写原型：每个改动区域标 <code>data-ac</code>（对应的 AC）和 <code>data-label</code>（用需求方的话说是什么），各种状态包在 <code><section data-state="状态名"></code> 中，按钮、标题、字段名写最终的文字。原型里的脚本不会运行。</p><p>审查页由一个本机服务提供：用到时在后台启动，空闲 4 小时后自己退出，只监听 <code>127.0.0.1</code>，地址中带随机令牌（插件设为只读时给只读的地址）。审查页允许被本机地址上的页面（Paseo 网页端）嵌入；要限定或放开，设 <code>REQ_KIT_REVIEW_FRAME_ANCESTORS</code>（CSP <code>frame-ancestors</code> 的值）。需求方在别的电脑上用浏览器访问 Paseo 网页端时，在运行 Paseo daemon 的机器上设置环境变量 <code>REQ_KIT_REVIEW_HOST</code>（例如 <code>0.0.0.0</code>）、<code>REQ_KIT_REVIEW_PUBLIC_URL</code>（别人访问这台机器用的地址，例如 <code>http://10.1.2.3:6781</code>），需要时用 <code>REQ_KIT_REVIEW_PORT</code> 换端口（默认 6781），然后重启 Paseo daemon 让插件拿到新的环境变量（只设 <code>REQ_KIT_REVIEW_HOST</code> 时，地址用这台电脑的计算机名）。没有设置时从别的电脑打开 Paseo 网页、点"审查原型"，页面会说明为什么打不开、该怎么设置（1.13）。</p><h2 id="代码评审分两个方向" tabindex="-1">代码评审分两个方向 <a class="header-anchor" href="#代码评审分两个方向" aria-label="Permalink to "代码评审分两个方向""></a></h2><p>标准档第一轮代码评审由两位评审者同时进行（1.8 起），各自写意见，再由 reviewer 核实、汇总成一份结论：</p><ul><li><strong>规格评审</strong>：每条验收标准是否真的实现并有测试、测试的期望值是否与验收标准的例子一致、有没有做需求之外的事、与确认过的预览是否一致。</li><li><strong>规范评审</strong>：项目惯例和范例文件、术语表中的代码名称、测试质量、安全与数据、简单性，以及可以变成规则的问题。</li></ul><p>两位都用配置的 reviewer agent，相当于多两次评审的用量；之后的轮次只核对修复，仍由一位评审。<code>reviewAxes.enabled</code> 设为 <code>false</code> 关闭，<code>reviewAxes.profiles</code> 选择档位（默认只有标准档）。配置了评审小组（<code>reviewPanel</code>）时，以评审小组为准。</p><h2 id="验收测试先提交" tabindex="-1">验收测试先提交 <a class="header-anchor" href="#验收测试先提交" aria-label="Permalink to "验收测试先提交""></a></h2><p>方案判断适合测试先行时，代码实现先把从验收标准的例子写出的测试单独提交一次（这时它们是失败的），在结果文件中写明这些测试文件和那次提交。代码评审前，流水线核对它们之后有没有被改过，被改过的交给评审逐个确认有没有依据：为了让测试通过而放宽断言的，按阻塞提出。</p><h2 id="术语表和范例文件" tabindex="-1">术语表和范例文件 <a class="header-anchor" href="#术语表和范例文件" aria-label="Permalink to "术语表和范例文件""></a></h2><ul><li><strong><code>GLOSSARY.md</code></strong>（仓库根目录）：业务词、含义、代码中的名字。<code>/req-setup</code> 第一次整理，访谈遇到新词时补充，方案设计为新概念补上代码中的名字；各步骤按它命名，规范评审检查是否一致。</li><li><strong>范例文件</strong>：<code>/req-setup</code> 在 <code>project-notes.md</code> 中列出各类代码（接口、页面、测试、迁移脚本）写得最好的文件。方案的每个任务写明参照哪个文件，实现照它的结构、命名、错误处理和测试写法来。</li></ul><h2 id="反复出现的问题变成规则" tabindex="-1">反复出现的问题变成规则 <a class="header-anchor" href="#反复出现的问题变成规则" aria-label="Permalink to "反复出现的问题变成规则""></a></h2><p>完成报告把这次评审、质量门、缺陷中"一条项目规则就能挡住"的问题写进功能目录的 <code>lessons.tsv</code>（类别、问题、出处、建议的规则、放在哪一层）。同一个类别在两个以上的需求里出现时，<code>req digest</code> 的需求总览会列在"反复出现的问题"中，<code>/req-retro</code> 会建议把它变成 lint 规则、类型约束、测试或项目说明里的一行，批准后落地。已经处理的类别写进 <code>.requirement-pipeline/lessons-handled.txt</code>（一行一个），总览不再提示。</p><h2 id="质量门-流水线自己运行的检查" tabindex="-1">质量门：流水线自己运行的检查 <a class="header-anchor" href="#质量门-流水线自己运行的检查" aria-label="Permalink to "质量门：流水线自己运行的检查""></a></h2><p>项目配置 <code>.requirement-pipeline.json</code> 的 <code>checks</code> 列出流水线<strong>自己运行</strong>的检查，通常由 <code>/req-setup</code> 从实际跑通的命令写入：</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0" v-pre=""><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
|
|
26
|
+
<div id="app"><div class="Layout" data-v-d8b57b2d><!--[--><!--]--><!--[--><span tabindex="-1" data-v-fcbfc0e0></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-fcbfc0e0>Skip to content</a><!--]--><!----><header class="VPNav" data-v-d8b57b2d data-v-7ad780c2><div class="VPNavBar" data-v-7ad780c2 data-v-9fd4d1dd><div class="wrapper" data-v-9fd4d1dd><div class="container" data-v-9fd4d1dd><div class="title" data-v-9fd4d1dd><div class="VPNavBarTitle has-sidebar" data-v-9fd4d1dd data-v-9f43907a><a class="title" href="/" data-v-9f43907a><!--[--><!--]--><!--[--><img class="VPImage logo" src="/logo.svg" alt data-v-ab19afbb><!--]--><span data-v-9f43907a>req-kit</span><!--[--><!--]--></a></div></div><div class="content" data-v-9fd4d1dd><div class="content-body" data-v-9fd4d1dd><!--[--><!--]--><div class="VPNavBarSearch search" data-v-9fd4d1dd><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="搜索文档"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">搜索文档</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-9fd4d1dd data-v-afb2845e><span id="main-nav-aria-label" class="visually-hidden" data-v-afb2845e> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/guide/" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>指南</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/reference/commands" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>参考</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/changelog" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>更新记录</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-afb2845e data-v-bfe7971f><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-bfe7971f><span class="text" data-v-bfe7971f><!----><span data-v-bfe7971f>v1.14.0-beta.2</span><span class="vpi-chevron-down text-icon" data-v-bfe7971f></span></span></button><div class="menu" data-v-bfe7971f><div class="VPMenu" data-v-bfe7971f data-v-20ed86d6><div class="items" data-v-20ed86d6><!--[--><!--[--><div class="VPMenuLink" data-v-20ed86d6 data-v-7eeeb2dc><a class="VPLink link" href="/changelog" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>更新记录</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-20ed86d6 data-v-7eeeb2dc><a class="VPLink link vp-external-link-icon" href="https://github.com/yiyisf/paseo-req-kit/releases" target="_blank" rel="noreferrer" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>GitHub Releases</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-20ed86d6 data-v-7eeeb2dc><a class="VPLink link" href="/reference/scope" data-v-7eeeb2dc><!--[--><span data-v-7eeeb2dc>范围与取舍</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-9fd4d1dd data-v-3f90c1a5><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-3f90c1a5 data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-9fd4d1dd data-v-ef6192dc data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://github.com/yiyisf/paseo-req-kit" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-60a9a2d3><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-9fd4d1dd data-v-f953d92f data-v-bfe7971f><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-bfe7971f><span class="vpi-more-horizontal icon" data-v-bfe7971f></span></button><div class="menu" data-v-bfe7971f><div class="VPMenu" data-v-bfe7971f data-v-20ed86d6><!----><!--[--><!--[--><!----><div class="group" data-v-f953d92f><div class="item appearance" data-v-f953d92f><p class="label" data-v-f953d92f>外观</p><div class="appearance-action" data-v-f953d92f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-f953d92f data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div></div></div><div class="group" data-v-f953d92f><div class="item social-links" data-v-f953d92f><div class="VPSocialLinks social-links-list" data-v-f953d92f data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://github.com/yiyisf/paseo-req-kit" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-60a9a2d3><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-9fd4d1dd data-v-6bee1efd><span class="container" data-v-6bee1efd><span class="top" data-v-6bee1efd></span><span class="middle" data-v-6bee1efd></span><span class="bottom" data-v-6bee1efd></span></span></button></div></div></div></div><div class="divider" data-v-9fd4d1dd><div class="divider-line" data-v-9fd4d1dd></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-d8b57b2d data-v-2488c25a><div class="container" data-v-2488c25a><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-2488c25a><span class="vpi-align-left menu-icon" data-v-2488c25a></span><span class="menu-text" data-v-2488c25a>目录</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-2488c25a data-v-6b867909><button data-v-6b867909>回到顶部</button><!----></div></div></div><aside class="VPSidebar" data-v-d8b57b2d data-v-42c4c606><div class="curtain" data-v-42c4c606></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-42c4c606><span class="visually-hidden" id="sidebar-aria-label" data-v-42c4c606> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>开始</h2><!----></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/" data-v-0009425e><!--[--><p class="text" data-v-0009425e>req-kit 是什么</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/getting-started" data-v-0009425e><!--[--><p class="text" data-v-0009425e>快速开始</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/how-it-works" data-v-0009425e><!--[--><p class="text" data-v-0009425e>工作原理</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>使用</h2><!----></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/user" data-v-0009425e><!--[--><p class="text" data-v-0009425e>使用者指南</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/phases" data-v-0009425e><!--[--><p class="text" data-v-0009425e>分阶段执行与提测</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 has-active" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>安装与维护</h2><!----></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/install" data-v-0009425e><!--[--><p class="text" data-v-0009425e>安装与升级</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/project" data-v-0009425e><!--[--><p class="text" data-v-0009425e>项目定制与运行规则</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/guide/maintainer" data-v-0009425e><!--[--><p class="text" data-v-0009425e>维护者指南</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-d8b57b2d data-v-9a6c75ad><div class="VPDoc has-sidebar has-aside" data-v-9a6c75ad data-v-e6f2a212><!--[--><!--]--><div class="container" data-v-e6f2a212><div class="aside" data-v-e6f2a212><div class="aside-curtain" data-v-e6f2a212></div><div class="aside-container" data-v-e6f2a212><div class="aside-content" data-v-e6f2a212><div class="VPDocAside" data-v-e6f2a212 data-v-cb998dce><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-cb998dce data-v-f610f197><div class="content" data-v-f610f197><div class="outline-marker" data-v-f610f197></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-f610f197>本页内容</div><ul class="VPDocOutlineItem root" data-v-f610f197 data-v-53c99d69><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-cb998dce></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-e6f2a212><div class="content-container" data-v-e6f2a212><!--[--><!--]--><main class="main" data-v-e6f2a212><div style="position:relative;" class="vp-doc _guide_project external-link-icon-enabled" data-v-e6f2a212><div><div><h1 id="项目定制与运行规则" tabindex="-1">项目定制与运行规则 <a class="header-anchor" href="#项目定制与运行规则" aria-label="Permalink to "项目定制与运行规则""></a></h1><h2 id="每个需求一个-worktree-工作区" tabindex="-1">每个需求一个 worktree 工作区 <a class="header-anchor" href="#每个需求一个-worktree-工作区" aria-label="Permalink to "每个需求一个 worktree 工作区""></a></h2><p>在 Paseo 中为每个需求新建工作区：<strong>New workspace</strong> → 选择项目 → <strong>Isolation</strong> 选 <strong>New worktree</strong> → 起点选主分支，然后在这个工作区的对话里输入 <code>/req</code>。</p><ul><li>流水线在这个工作区自己的目录和分支上运行、提交，不影响项目主目录。</li><li>同一个目录一次只能运行一条流水线；用了 worktree，几个需求可以同时进行。</li><li>在主目录发起时，<code>/req</code> 会先建议改用 worktree；使用者坚持的话，它会新建 <code>feature/<功能目录名></code> 分支再继续。</li></ul><p><strong>分支规则</strong>：流水线把启动时检出的分支作为本次需求的工作分支，所有步骤都提交到这里，不切换、不新建分支。它拒绝在默认分支（<code>main</code>、<code>master</code> 或 <code>origin/HEAD</code> 指向的分支）或 detached HEAD 上启动；续跑时分支变了也会拒绝。</p><h2 id="档位" tabindex="-1">档位 <a class="header-anchor" href="#档位" aria-label="Permalink to "档位""></a></h2><table tabindex="0"><thead><tr><th>档位</th><th>适用</th><th>访谈</th><th>流程</th></tr></thead><tbody><tr><td>快速（<code>quick</code>）</td><td>小改动：文案、样式、配置项、字段显示等，不涉及数据结构、权限、对外接口</td><td>只问要改什么、改成什么样、不改什么、验收标准</td><td>审核、评审、缺陷修复各一轮；不做服务启动验证；产物从简</td></tr><tr><td>标准（<code>standard</code>）</td><td>其他情况</td><td>完整访谈</td><td>审核最多 2 轮、评审最多 3 轮、缺陷修复最多 3 轮</td></tr></tbody></table><p><code>/req</code> 会根据需求推荐档位，用户确认后写进 spec（<code>- 档位：快速</code>）。流水线按以下顺序决定档位：<code>--profile</code> 参数 → 续跑时沿用上次的档位 → spec 中的档位 → 配置中的 <code>defaultProfile</code>。各档的轮数和是否做服务启动验证可以在配置的 <code>profiles</code> 中调整。</p><h2 id="需求类型" tabindex="-1">需求类型 <a class="header-anchor" href="#需求类型" aria-label="Permalink to "需求类型""></a></h2><p>spec 头部的 <code>- 类型：</code> 决定流水线走哪种做法（1.8 起）。缺陷、重构、评估有自己的做法，新需求和小改动走通常的流程：</p><table tabindex="0"><thead><tr><th>类型</th><th>做法</th><th>关键证据</th></tr></thead><tbody><tr><td>缺陷（<code>缺陷</code>、<code>bug</code>）</td><td>方案设计改为"复现与定位"：先提交一个修复前失败的复现测试或脚本，写 <code>diagnosis.md</code>（根因、影响面）；复现不了就暂停，把需要补充的信息发回对话。修复要让复现转绿，评审实际确认它修复前失败</td><td>同一个复现，修复前失败、修复后通过</td></tr><tr><td>重构（<code>重构</code>、<code>技术改进</code>）</td><td>先补特征测试锁住现有行为并单独提交，再小步改动、每步全绿；评审的首要问题是"行为有没有变"</td><td>重构前后同一组测试一致</td></tr><tr><td>评估（<code>评估</code>、<code>调研</code>）</td><td>只读：调研评估（<code>assessment.md</code>）→ 评估审阅 ⇄ 修订 → 评估报告；没有实现、评审、提测和验证，执行方式按连续</td><td>引用的代码位置和实际运行的命令</td></tr></tbody></table><p>各类型的做法写在 <code>engine/prompts/types/<类型>.md</code>，按步骤分节，接在每一步的任务之后；可以用 <code>prompts.local/types/</code> 覆盖。不想用某个类型的做法时，从配置 <code>requirementTypes</code>（默认 <code>["defect", "refactor", "assessment"]</code>）中去掉它，这个类型就按新需求处理。设计决定见 ADR 0023。</p><h2 id="方案确认点-开工前请需求方确认-做完后会看到什么" tabindex="-1">方案确认点：开工前请需求方确认"做完后会看到什么" <a class="header-anchor" href="#方案确认点-开工前请需求方确认-做完后会看到什么" aria-label="Permalink to "方案确认点：开工前请需求方确认"做完后会看到什么"""></a></h2><p>方案审核通过后、写代码之前，流水线可以停下来请需求方确认（1.8 起）。方案设计写 <code>preview.md</code>（按操作顺序描述做完后会看到什么、需要确认的假设、不会变的地方），界面改动还在 <code>prototype/</code> 中画出静态的原型页面。对话里的 AI 把要点讲给需求方：确认后执行 <code>--approve</code>（终端里 <code>req approve <需求></code>）开始写代码；要改的，更新需求说明后 <code>--resume</code>，方案调整后再确认一次。需求方确认过的预览和原型，实现和功能验证都以它为准：界面与原型不一致按缺陷处理。</p><table tabindex="0"><thead><tr><th>配置</th><th>默认</th><th>说明</th></tr></thead><tbody><tr><td><code>designApproval.mode</code></td><td><code>ui</code></td><td><code>ui</code>：方案判断这次是界面改动（结果文件 <code>ui_change</code>）时才停；<code>always</code>：每次都停；<code>off</code>：不停</td></tr><tr><td><code>designApproval.profiles</code></td><td><code>["standard"]</code></td><td>哪些档位使用；快速档默认不停</td></tr><tr><td><code>designApproval.autoContinueHours</code></td><td>0</td><td>大于 0 时，等了这么久还没确认就按方案继续（通过对话执行）；0 表示一直等待。等待超过 <code>waitingReminderHours</code> 会提醒一次</td></tr></tbody></table><p>等待确认时进度显示"等待需求方确认方案"，需求总览归入"需要处理"，外部通知收到 <code>approval</code> 事件。评估类需求不写代码，不经过确认点。</p><p><strong>原型审查页（1.13 起）。</strong> 有 <code>prototype/</code> 的需求，插件的需求页面和"等你处理"里有"审查原型"按钮（等待确认方案时是最醒目的"审查原型并确认方案"），审查页嵌在 Paseo 的网页端和桌面端里打开，手机上在浏览器中打开；终端里是 <code>req review <需求></code>。需求方在原型上点选要改的地方（页面记下元素、文字、颜色、大小和位置）、双击直接改文字，切换状态和电脑、手机宽度，然后提交：意见整理成带位置信息的清单转给需求会话（与插件中写修改意见的效果相同），或者直接确认方案。草稿和提交记录在功能目录的 <code>.pipeline/review/</code> 中，每一版原型也存在那里，原型改过后页面会标出这一版改了哪里。</p><p>为了让审查页能用，方案设计按约定写原型：每个改动区域标 <code>data-ac</code>（对应的 AC）和 <code>data-label</code>（用需求方的话说是什么），各种状态包在 <code><section data-state="状态名"></code> 中，按钮、标题、字段名写最终的文字。原型里的脚本不会运行。</p><p>审查页由一个本机服务提供：用到时在后台启动，空闲 4 小时后自己退出，只监听 <code>127.0.0.1</code>，地址中带随机令牌（插件设为只读时给只读的地址）。审查页允许被本机地址上的页面（Paseo 网页端）嵌入；要限定或放开，设 <code>REQ_KIT_REVIEW_FRAME_ANCESTORS</code>（CSP <code>frame-ancestors</code> 的值）。需求方在别的电脑上用浏览器访问 Paseo 网页端时，在运行 Paseo daemon 的机器上设置环境变量 <code>REQ_KIT_REVIEW_HOST</code>（例如 <code>0.0.0.0</code>）、<code>REQ_KIT_REVIEW_PUBLIC_URL</code>（别人访问这台机器用的地址，例如 <code>http://10.1.2.3:6781</code>），需要时用 <code>REQ_KIT_REVIEW_PORT</code> 换端口（默认 6781），然后重启 Paseo daemon 让插件拿到新的环境变量（只设 <code>REQ_KIT_REVIEW_HOST</code> 时，地址用这台电脑的计算机名）。没有设置时从别的电脑打开 Paseo 网页、点"审查原型"，页面会说明为什么打不开、该怎么设置（1.13）。</p><h2 id="代码评审分两个方向" tabindex="-1">代码评审分两个方向 <a class="header-anchor" href="#代码评审分两个方向" aria-label="Permalink to "代码评审分两个方向""></a></h2><p>标准档第一轮代码评审由两位评审者同时进行（1.8 起），各自写意见，再由 reviewer 核实、汇总成一份结论：</p><ul><li><strong>规格评审</strong>：每条验收标准是否真的实现并有测试、测试的期望值是否与验收标准的例子一致、有没有做需求之外的事、与确认过的预览是否一致。</li><li><strong>规范评审</strong>：项目惯例和范例文件、术语表中的代码名称、测试质量、安全与数据、简单性，以及可以变成规则的问题。</li></ul><p>两位都用配置的 reviewer agent，相当于多两次评审的用量；之后的轮次只核对修复，仍由一位评审。<code>reviewAxes.enabled</code> 设为 <code>false</code> 关闭，<code>reviewAxes.profiles</code> 选择档位（默认只有标准档）。配置了评审小组（<code>reviewPanel</code>）时，以评审小组为准。</p><h2 id="验收测试先提交" tabindex="-1">验收测试先提交 <a class="header-anchor" href="#验收测试先提交" aria-label="Permalink to "验收测试先提交""></a></h2><p>方案判断适合测试先行时，代码实现先把从验收标准的例子写出的测试单独提交一次（这时它们是失败的），在结果文件中写明这些测试文件和那次提交。代码评审前，流水线核对它们之后有没有被改过，被改过的交给评审逐个确认有没有依据：为了让测试通过而放宽断言的，按阻塞提出。</p><h2 id="术语表和范例文件" tabindex="-1">术语表和范例文件 <a class="header-anchor" href="#术语表和范例文件" aria-label="Permalink to "术语表和范例文件""></a></h2><ul><li><strong><code>GLOSSARY.md</code></strong>（仓库根目录）：业务词、含义、代码中的名字。<code>/req-setup</code> 第一次整理，访谈遇到新词时补充，方案设计为新概念补上代码中的名字；各步骤按它命名，规范评审检查是否一致。</li><li><strong>范例文件</strong>：<code>/req-setup</code> 在 <code>project-notes.md</code> 中列出各类代码（接口、页面、测试、迁移脚本）写得最好的文件。方案的每个任务写明参照哪个文件，实现照它的结构、命名、错误处理和测试写法来。</li></ul><h2 id="反复出现的问题变成规则" tabindex="-1">反复出现的问题变成规则 <a class="header-anchor" href="#反复出现的问题变成规则" aria-label="Permalink to "反复出现的问题变成规则""></a></h2><p>完成报告把这次评审、质量门、缺陷中"一条项目规则就能挡住"的问题写进功能目录的 <code>lessons.tsv</code>（类别、问题、出处、建议的规则、放在哪一层）。同一个类别在两个以上的需求里出现时，<code>req digest</code> 的需求总览会列在"反复出现的问题"中，<code>/req-retro</code> 会建议把它变成 lint 规则、类型约束、测试或项目说明里的一行，批准后落地。已经处理的类别写进 <code>.requirement-pipeline/lessons-handled.txt</code>（一行一个），总览不再提示。</p><h2 id="质量门-流水线自己运行的检查" tabindex="-1">质量门：流水线自己运行的检查 <a class="header-anchor" href="#质量门-流水线自己运行的检查" aria-label="Permalink to "质量门：流水线自己运行的检查""></a></h2><p>项目配置 <code>.requirement-pipeline.json</code> 的 <code>checks</code> 列出流水线<strong>自己运行</strong>的检查，通常由 <code>/req-setup</code> 从实际跑通的命令写入：</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0" v-pre=""><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
|
|
27
27
|
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "checks"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span></span>
|
|
28
28
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"name"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"lint"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"command"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"npm run lint"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
29
29
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"name"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"web 测试"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"command"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"npm test"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"cwd"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"web"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
@@ -56,7 +56,7 @@
|
|
|
56
56
|
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "test"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"command"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"npm test"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
57
57
|
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "web"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"type"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"service"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"command"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"node scripts/paseo/with-port.mjs npm run dev -- --port {PORT}"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
|
|
58
58
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
|
|
59
|
-
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p><code>paseo.json</code> 是团队共用的，而 Paseo 在各系统上用不同的 shell 执行它的命令（macOS/Linux：bash 和 sh；Windows：准备命令用 PowerShell，带 <code>-ExecutionPolicy Bypass</code>，不受执行策略限制；脚本和服务用 cmd.exe）。所以 <code>/req-setup</code> 只写各系统一样的命令，用到环境变量的地方交给它写进项目的两个小脚本：<code>scripts/paseo/copy-local-files.mjs</code>（从来源目录复制不提交的本地文件，没有就跳过）和 <code>scripts/paseo/with-port.mjs</code>（把 <code>{PORT}</code> 换成 Paseo 分配的端口，并设置 <code>PORT</code>）。手写 <code>$PASEO_PORT</code>、<code>%PASEO_PORT%</code>、<code>cp</code>、<code>Copy-Item</code> 这类只在某个系统上能用的命令时，<code>/req-doctor</code> 会指出：在本机上会失败的标为⚠，只是换系统会失败的给出提示。</p><ul><li><code>worktree.setup</code>：Paseo 新建 worktree 工作区时自动执行，新需求的工作区一建好就装好了依赖、带上了本地配置。</li><li><code>"type": "service"</code> 的脚本：流水线在服务启动验证、功能验证、缺陷修复和复验之前，通过 Paseo 带着当前代码重启它们，把地址（<code>http://web--<分支>--<项目>.localhost:6767</code> 这样的代理地址）交给步骤 agent，验证结束后停止。Paseo 为每个工作区分配独立端口，几个需求同时验证不会冲突，服务必须监听 Paseo 分配的端口（环境变量 <code>PASEO_PORT</code>，用 <code>with-port.mjs</code> 传给程序）。</li><li>服务没有启动成功时，最后的输出写到功能目录的 <code>.pipeline/services/<服务名>.log</code>，交给步骤 agent 查原因。</li><li>只有从 Paseo 对话启动的流水线才会这样做（需要知道是哪个工作区）。不想用时在配置中设 <code>"paseoServices": "off"</code>，步骤 agent 会像以前一样自己启动服务。<code>serviceReadySeconds</code>（默认 120）是等待服务就绪的时间。</li><li>在 Paseo 设置中打开 <strong>Enable Paseo tools</strong> 后，步骤 agent 改完代码还可以自己重启这些服务。</li><li>写错时服务起不来，流水线会改由步骤 agent 自己启动服务，不会中断。</li><li>PowerShell 被完全禁用（不只是执行策略）的 Windows 机器上，<code>worktree.setup</code> 无法执行；新工作区不会自动装依赖，步骤 agent 会按验证方法自己准备。</li></ul><h2 id="额度提醒" tabindex="-1">额度提醒 <a class="header-anchor" href="#额度提醒" aria-label="Permalink to "额度提醒""></a></h2><p>开始前，流水线读取 Paseo 的用量信息（需要 Paseo 能读到对应 agent 的订阅用量）。所用 agent 的某个额度窗口用到 <code>quotaWarnPercent</code>（默认 85）以上时，在对话里提醒一次，流水线照常进行；用完时遇到限流会自动等待重试。设为 0 关闭提醒。</p><h2 id="token-预算和用时估算-1-13-起" tabindex="-1">token 预算和用时估算（1.13 起） <a class="header-anchor" href="#token-预算和用时估算-1-13-起" aria-label="Permalink to "token 预算和用时估算（1.13 起）""></a></h2><p>内网模型通常不报金额，所以按 token（输入 + 输出）计：</p><table tabindex="0"><thead><tr><th>配置</th><th>默认</th><th>说明</th></tr></thead><tbody><tr><td><code>budget.tokens</code></td><td><code>null</code>（不限）</td><td>一个需求所有步骤、所有尝试合计最多用多少 tokens，例如 <code>3000000</code>。每个新步骤开始前检查：用完时，已完成的步骤都保留，流水线在下一步开始前停下（状态"已中断"，停下原因 <code>budget</code>），请对话问需求方是否继续；继续（<code>req resume</code> 或在对话里说"继续开发"）会再给一份同样多的预算</td></tr><tr><td><code>budget.warnPercent</code></td><td>80</td><td>用到预算的这个比例时在对话里告知一次（不停），同时发 <code>milestone</code> 外部通知</td></tr></tbody></table><p>写在本机、团队或项目配置中都可以，例如 <code>"budget": { "tokens": 3000000 }</code>。还没有数据时，先不设预算跑几个需求，用 <code>req stats</code> 的"token 花在哪"看每个需求的中位数，再按它的两三倍设。</p><p>agent 不报告 token 用量时（有些模型或接入方式不报告），预算不会起作用：设了预算的需求在第一个步骤结束后会在对话里说明一次，流水线照常继续；<code>req doctor</code> 也会检查本机最近的需求有没有用量数据。</p><p>用时估算不用配置：本机已完成的同档位需求有 3 个以上时，开始开发的回复里写出"agent 合计用时和 token 的中位数"作为参考；<code>req status</code> 和插件的需求页面显示"预计还要约多久"（按中位数减去已用的 agent 时间，不含等人的时间），超过中位数时如实说"已超过通常的用时"。</p><h2 id="并行编排-确认前审阅、方案提案、浏览器验证" tabindex="-1">并行编排：确认前审阅、方案提案、浏览器验证 <a class="header-anchor" href="#并行编排-确认前审阅、方案提案、浏览器验证" aria-label="Permalink to "并行编排：确认前审阅、方案提案、浏览器验证""></a></h2><table tabindex="0"><thead><tr><th>配置</th><th>默认</th><th>作用</th></tr></thead><tbody><tr><td><code>specReview</code></td><td><code>"standard"</code></td><td>请需求方确认之前，由 reviewer 在后台独立审阅需求说明草稿，问题写进 <code>spec-review.md</code>。<code>"always"</code> 快速档也做，<code>"off"</code> 关闭</td></tr><tr><td><code>designProposals</code></td><td>关闭</td><td><code>{"enabled": true}</code> 后，标准档的方案设计之前由几个 agent 并行各提一份方案（<code>design-proposals/</code>），方案设计比较后决定。<code>members</code> 不写时用 builder 和 reviewer，也可以像评审小组一样列出成员（可用 <code>paseoProfile</code>）。需求变更后的增量继续不做</td></tr><tr><td><code>browserVerify</code></td><td><code>"auto"</code></td><td>功能验证、缺陷修复、复验检查网页界面的方式。1.13 起总是附上界面检查命令 <code>req ui-check</code>：用本机的 Edge 或 Chrome（无界面）打开页面，按电脑和手机宽度用文字报告显示不全、遮挡、超出屏幕、图片没加载、文字太淡、控件没有名字、控制台报错和请求失败，并和确认过的原型逐项对文字；不需要模型看图，也不需要 Paseo 桌面端。第一次使用时从 npm 源安装 <code>playwright-core</code> 到 <code>~/.req-kit/tools</code>（不下载浏览器）。步骤 agent 还有 Paseo 浏览器工具（桌面端在线）时，另外按验收标准在浏览器中实际操作。<code>"off"</code> 都不用</td></tr></tbody></table><p>Paseo 自带的 <code>/paseo-advisor</code>、<code>/paseo-committee</code> 等编排 skill 也可以单独使用，例如对一个疑难问题请两个模型分别分析；它们不参与流水线（见 ADR 0019）。</p><h2 id="自动新建工作区-可选" tabindex="-1">自动新建工作区（可选） <a class="header-anchor" href="#自动新建工作区-可选" aria-label="Permalink to "自动新建工作区（可选）""></a></h2><p>在项目主目录、主分支上发起的需求，可以用 <code>--worktree</code> 启动（<code>/req</code> 中的"启动（自动新建工作区）"）：流水线从当前分支切出 <code>feature/<功能目录名></code>，在 Paseo 中新建 worktree 工作区，把需求说明移过去并提交，之后的步骤都在那个工作区中运行，仍然挂在发起的对话下。对话的工作目录不变，查看进度、暂停、继续都在原对话中进行；读写需求文件用通知中给出的完整路径。只能在第一次启动时选择。见 ADR 0018。</p><h2 id="调度-预约、提醒、自动继续、排队" tabindex="-1">调度：预约、提醒、自动继续、排队 <a class="header-anchor" href="#调度-预约、提醒、自动继续、排队" aria-label="Permalink to "调度：预约、提醒、自动继续、排队""></a></h2><p>需要"以后再做"的事，流水线用 Paseo 的定时任务把一条写明步骤的消息发回发起的对话，由对话 agent 执行（机器或 daemon 重启后仍然有效，在 Paseo 的 Schedules 中可以看到）。暂停命令会取消这些预约。</p><table tabindex="0"><thead><tr><th>配置</th><th>默认</th><th>作用</th></tr></thead><tbody><tr><td>（启动参数 <code>--at</code>）</td><td>—</td><td>预约开始时间：<code>22:00</code>、<code>明天 8:30</code>、<code>2026-10-14 08:30</code>、<code>+2h</code></td></tr><tr><td><code>waitingReminderHours</code></td><td>24</td><td>等待需求方回答、或研发完成后等待测试验证超过这么久，在对话里提醒一次；0 关闭</td></tr><tr><td>（启动参数 <code>--verify-at</code>）</td><td>—</td><td>分阶段时，研发完成后在这个时间自动开始测试验证（写法同 <code>--at</code>；隐含分阶段）。研发完成时时间已过就直接继续</td></tr><tr><td><code>autoResumeMinutes</code> / <code>autoResumeMax</code></td><td>30 / 2</td><td>临时错误（重试用完）中断后，这么久之后在对话里自动继续；每次尝试最多几次；0 关闭</td></tr><tr><td><code>watchdogMinutes</code></td><td>60（1.12 起默认打开）</td><td>运行期间对话定时检查，后台进程意外退出时自动继续。每次检查对话 agent 会运行一个回合；0 关闭。1.13 起：装了 req-kit 插件时，插件每 5 分钟在 daemon 里直接检查本机所有需求，发现"运行中但后台进程已不在"的就执行 <code>req resume</code>（不经过模型，每个进程只继续一次，每个需求 24 小时内最多 3 次），这时不再预约对话的定时检查；插件设为只读时不做。接单器（<code>req factory</code>）每次检查也同样直接继续</td></tr><tr><td><code>maxConcurrentPipelines</code></td><td>0（不限）</td><td>本机同时运行的流水线上限，满了排队。只能写在本机配置中才有意义</td></tr></tbody></table><h2 id="需求总览" tabindex="-1">需求总览 <a class="header-anchor" href="#需求总览" aria-label="Permalink to "需求总览""></a></h2><p><code>req digest</code> 在项目目录中列出所有工作区里的需求，按"需要处理、待验收、开发中、对齐中、已验收（最近 7 天）"分组，附用时与用量。<code>--notify</code> 同时发给外部通知（事件类型 <code>digest</code>）；<code>--schedule "<cron>"</code> 让 Paseo 按时间表（本机时区）启动一个短暂的 agent 执行 <code>req digest --notify</code>，例如每周一 9 点：<code>req digest --schedule "0 9 * * 1"</code>；取消：<code>req digest --cancel <定时任务 ID></code>。</p><h2 id="使用统计" tabindex="-1">使用统计 <a class="header-anchor" href="#使用统计" aria-label="Permalink to "使用统计""></a></h2><p>1.9.0 起，每次流水线运行结束时，引擎在本机的 <code>~/.req-kit/usage/runs.jsonl</code> 追加一条记录：各步骤的用时和用量、质量门、评审和缺陷轮数、结束时的状态（格式见 <a href="./../reference/contracts/usage-record">使用记录</a>）。只记在本机，不记需求内容和代码，也不会自动发往任何地方。</p><ul><li><code>req stats</code>：最近 30 天的统计（<code>--since 2w</code>、<code>--since 2026-10-01</code>、<code>--month 2026-10</code>）：有进展和完成的需求数、交付周期、返工（评审轮数、需要缺陷修复的占比、质量门失败）、各种等待的时长、各步骤用时、用量，以及不同 builder 的比较。1.13 起有"token 花在哪"一节：按步骤和按模型的 token 及占比、返工（方案修订、评审问题修复、缺陷修复、复验，以及第 2 轮起的审核和评审）的占比、输入中来自提示缓存的比例、每个完成需求的中位数；插件的"使用统计"页用条形图显示同样的内容。<code>--json</code>、<code>--csv</code> 输出机器可读的格式。</li><li><code>req stats --report --month 2026-10 [--out 目录]</code>：生成给管理方汇报用的两份文件：<code>req-kit-usage-2026-10.md</code>（汇总）和 <code>.csv</code>（每个需求一行，可以用表格软件打开）。</li><li>几台机器一起汇报：每台机器运行 <code>req stats --month 2026-10 --export</code>，得到 <code>req-kit-usage-<主机名>-<日期>.jsonl</code>；把这些文件放到一起，运行 <code>req stats --merge <文件…> --month 2026-10 --report</code>。</li></ul><p>本机的需求索引 <code>~/.req-kit/index/</code> 记录每个运行过的需求在哪个目录，Paseo 插件据此在一个页面列出本机所有项目的需求。1.9 之前运行过的需求不在索引里，在项目目录运行一次 <code>req index --rebuild</code> 补登；目录删掉后用 <code>req index --prune</code> 清理。</p><h2 id="外部系统对接-需求管理等" tabindex="-1">外部系统对接（需求管理等） <a class="header-anchor" href="#外部系统对接-需求管理等" aria-label="Permalink to "外部系统对接（需求管理等）""></a></h2><p>1.9.0 起，流水线可以把需求同步到团队的需求管理系统：需求开始时建一张卡片，之后每到一个阶段改卡片的状态，卡片编号和链接写回需求，显示在进度、完成报告和 Paseo 插件里。对接的是本机已有的命令行工具（例如需求管理系统的 CLI），写在本机或团队配置中（它会运行命令，项目配置中的会被忽略）：</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0" v-pre=""><code><span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"integrations"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span></span>
|
|
59
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p><code>paseo.json</code> 是团队共用的，而 Paseo 在各系统上用不同的 shell 执行它的命令（macOS/Linux：bash 和 sh；Windows：准备命令用 PowerShell，带 <code>-ExecutionPolicy Bypass</code>，不受执行策略限制；脚本和服务用 cmd.exe）。所以 <code>/req-setup</code> 只写各系统一样的命令，用到环境变量的地方交给它写进项目的两个小脚本：<code>scripts/paseo/copy-local-files.mjs</code>（从来源目录复制不提交的本地文件，没有就跳过）和 <code>scripts/paseo/with-port.mjs</code>（把 <code>{PORT}</code> 换成 Paseo 分配的端口，并设置 <code>PORT</code>）。手写 <code>$PASEO_PORT</code>、<code>%PASEO_PORT%</code>、<code>cp</code>、<code>Copy-Item</code> 这类只在某个系统上能用的命令时，<code>/req-doctor</code> 会指出：在本机上会失败的标为⚠，只是换系统会失败的给出提示。</p><ul><li><code>worktree.setup</code>：Paseo 新建 worktree 工作区时自动执行，新需求的工作区一建好就装好了依赖、带上了本地配置。</li><li><code>"type": "service"</code> 的脚本：流水线在服务启动验证、功能验证、缺陷修复和复验之前，通过 Paseo 带着当前代码重启它们，把地址（<code>http://web--<分支>--<项目>.localhost:6767</code> 这样的代理地址）交给步骤 agent，验证结束后停止。Paseo 为每个工作区分配独立端口，几个需求同时验证不会冲突，服务必须监听 Paseo 分配的端口（环境变量 <code>PASEO_PORT</code>，用 <code>with-port.mjs</code> 传给程序）。</li><li>服务没有启动成功时，最后的输出写到功能目录的 <code>.pipeline/services/<服务名>.log</code>，交给步骤 agent 查原因。</li><li>只有从 Paseo 对话启动的流水线才会这样做（需要知道是哪个工作区）。不想用时在配置中设 <code>"paseoServices": "off"</code>，步骤 agent 会像以前一样自己启动服务。<code>serviceReadySeconds</code>（默认 120）是等待服务就绪的时间。</li><li>在 Paseo 设置中打开 <strong>Enable Paseo tools</strong> 后，步骤 agent 改完代码还可以自己重启这些服务。</li><li>写错时服务起不来，流水线会改由步骤 agent 自己启动服务，不会中断。</li><li>PowerShell 被完全禁用（不只是执行策略）的 Windows 机器上，<code>worktree.setup</code> 无法执行；新工作区不会自动装依赖，步骤 agent 会按验证方法自己准备。</li></ul><h2 id="额度提醒" tabindex="-1">额度提醒 <a class="header-anchor" href="#额度提醒" aria-label="Permalink to "额度提醒""></a></h2><p>开始前，流水线读取 Paseo 的用量信息（需要 Paseo 能读到对应 agent 的订阅用量）。所用 agent 的某个额度窗口用到 <code>quotaWarnPercent</code>（默认 85）以上时，在对话里提醒一次，流水线照常进行；用完时遇到限流会自动等待重试。设为 0 关闭提醒。</p><h2 id="token-预算和用时估算-1-13-起" tabindex="-1">token 预算和用时估算（1.13 起） <a class="header-anchor" href="#token-预算和用时估算-1-13-起" aria-label="Permalink to "token 预算和用时估算（1.13 起）""></a></h2><p>内网模型通常不报金额，所以按 token（输入 + 输出）计：</p><table tabindex="0"><thead><tr><th>配置</th><th>默认</th><th>说明</th></tr></thead><tbody><tr><td><code>budget.tokens</code></td><td><code>null</code>（不限）</td><td>一个需求所有步骤、所有尝试合计最多用多少 tokens，例如 <code>3000000</code>。每个新步骤开始前检查：用完时，已完成的步骤都保留，流水线在下一步开始前停下（状态"已中断"，停下原因 <code>budget</code>），请对话问需求方是否继续；继续（<code>req resume</code> 或在对话里说"继续开发"）会再给一份同样多的预算</td></tr><tr><td><code>budget.warnPercent</code></td><td>80</td><td>用到预算的这个比例时在对话里告知一次（不停），同时发 <code>milestone</code> 外部通知</td></tr></tbody></table><p>写在本机、团队或项目配置中都可以，例如 <code>"budget": { "tokens": 3000000 }</code>。还没有数据时，先不设预算跑几个需求，用 <code>req stats</code> 的"token 花在哪"看每个需求的中位数，再按它的两三倍设。</p><p>agent 不报告 token 用量时（有些模型或接入方式不报告），预算不会起作用：设了预算的需求在第一个步骤结束后会在对话里说明一次，流水线照常继续；<code>req doctor</code> 也会检查本机最近的需求有没有用量数据。</p><p>用时估算不用配置：本机已完成的同档位需求有 3 个以上时，开始开发的回复里写出"agent 合计用时和 token 的中位数"作为参考；<code>req status</code> 和插件的需求页面显示"预计还要约多久"（按中位数减去已用的 agent 时间，不含等人的时间），超过中位数时如实说"已超过通常的用时"。</p><h2 id="并行编排-确认前审阅、方案提案、浏览器验证" tabindex="-1">并行编排：确认前审阅、方案提案、浏览器验证 <a class="header-anchor" href="#并行编排-确认前审阅、方案提案、浏览器验证" aria-label="Permalink to "并行编排：确认前审阅、方案提案、浏览器验证""></a></h2><table tabindex="0"><thead><tr><th>配置</th><th>默认</th><th>作用</th></tr></thead><tbody><tr><td><code>specReview</code></td><td><code>"standard"</code></td><td>请需求方确认之前，由 reviewer 在后台独立审阅需求说明草稿，问题写进 <code>spec-review.md</code>。<code>"always"</code> 快速档也做，<code>"off"</code> 关闭</td></tr><tr><td><code>designProposals</code></td><td>关闭</td><td><code>{"enabled": true}</code> 后，标准档的方案设计之前由几个 agent 并行各提一份方案（<code>design-proposals/</code>），方案设计比较后决定。<code>members</code> 不写时用 builder 和 reviewer，也可以像评审小组一样列出成员（可用 <code>paseoProfile</code>）。需求变更后的增量继续不做</td></tr><tr><td><code>browserVerify</code></td><td><code>"auto"</code></td><td>功能验证、缺陷修复、复验检查网页界面的方式。1.13 起总是附上界面检查命令 <code>req ui-check</code>：用本机的 Edge 或 Chrome（无界面）打开页面，按电脑和手机宽度用文字报告显示不全、遮挡、超出屏幕、图片没加载、文字太淡、控件没有名字、控制台报错和请求失败，并和确认过的原型逐项对文字；不需要模型看图，也不需要 Paseo 桌面端。第一次使用时从 npm 源安装 <code>playwright-core</code> 到 <code>~/.req-kit/tools</code>（不下载浏览器）。步骤 agent 还有 Paseo 浏览器工具（桌面端在线）时，另外按验收标准在浏览器中实际操作。<code>"off"</code> 都不用</td></tr></tbody></table><p>Paseo 自带的 <code>/paseo-advisor</code>、<code>/paseo-committee</code> 等编排 skill 也可以单独使用，例如对一个疑难问题请两个模型分别分析；它们不参与流水线（见 ADR 0019）。</p><h2 id="自动新建工作区-可选" tabindex="-1">自动新建工作区（可选） <a class="header-anchor" href="#自动新建工作区-可选" aria-label="Permalink to "自动新建工作区（可选）""></a></h2><p>在项目主目录、主分支上发起的需求，可以用 <code>--worktree</code> 启动（<code>/req</code> 中的"启动（自动新建工作区）"）：流水线从当前分支切出 <code>feature/<功能目录名></code>，在 Paseo 中新建 worktree 工作区，把需求说明移过去并提交，之后的步骤都在那个工作区中运行，仍然挂在发起的对话下。对话的工作目录不变，查看进度、暂停、继续都在原对话中进行；读写需求文件用通知中给出的完整路径。只能在第一次启动时选择。见 ADR 0018。</p><p>1.14 起：</p><ul><li><strong>启动没成功也能接着做。</strong> 工作区一建好就记下来（<code>~/.req-kit/worktrees/</code>）。之后不管哪一步失败（建工作区慢、启动前的检查没通过），再次执行启动命令都会在这个工作区里接着开始，不会报"分支已存在"，也不会留下只有需求说明的分支。新建工作区最多等 15 分钟（以前是 2 分钟，大仓库在 Windows 上常常不够）。以前版本留下的"分支和工作区都在、开发没开始"的，也会由 Paseo 接手那个目录接着做。</li><li><strong>访谈改过的 <code>GLOSSARY.md</code>、<code>docs/adr/</code> 一起带过去</strong>，和需求说明在需求自己的分支上一起提交；主目录里的这些未提交改动保留不动（可能和别的改动在一起），确认后可以撤销。</li><li><strong>如实提示起点的问题</strong>：需求说明已经提交在主分支上、本地主分支比远端落后、主目录里还有别的未提交改动时，启动结果里会写明。流水线不改动主分支。</li></ul><h2 id="调度-预约、提醒、自动继续、排队" tabindex="-1">调度：预约、提醒、自动继续、排队 <a class="header-anchor" href="#调度-预约、提醒、自动继续、排队" aria-label="Permalink to "调度：预约、提醒、自动继续、排队""></a></h2><p>需要"以后再做"的事，流水线用 Paseo 的定时任务把一条写明步骤的消息发回发起的对话，由对话 agent 执行（机器或 daemon 重启后仍然有效，在 Paseo 的 Schedules 中可以看到）。暂停命令会取消这些预约。</p><table tabindex="0"><thead><tr><th>配置</th><th>默认</th><th>作用</th></tr></thead><tbody><tr><td>（启动参数 <code>--at</code>）</td><td>—</td><td>预约开始时间：<code>22:00</code>、<code>明天 8:30</code>、<code>2026-10-14 08:30</code>、<code>+2h</code></td></tr><tr><td><code>waitingReminderHours</code></td><td>24</td><td>等待需求方回答、或研发完成后等待测试验证超过这么久，在对话里提醒一次；0 关闭</td></tr><tr><td>（启动参数 <code>--verify-at</code>）</td><td>—</td><td>分阶段时，研发完成后在这个时间自动开始测试验证（写法同 <code>--at</code>；隐含分阶段）。研发完成时时间已过就直接继续</td></tr><tr><td><code>autoResumeMinutes</code> / <code>autoResumeMax</code></td><td>30 / 2</td><td>临时错误（重试用完）中断后，这么久之后在对话里自动继续；每次尝试最多几次；0 关闭</td></tr><tr><td><code>watchdogMinutes</code></td><td>60（1.12 起默认打开）</td><td>运行期间对话定时检查，后台进程意外退出时自动继续。每次检查对话 agent 会运行一个回合；0 关闭。1.13 起：装了 req-kit 插件时，插件每 5 分钟在 daemon 里直接检查本机所有需求，发现"运行中但后台进程已不在"的就执行 <code>req resume</code>（不经过模型，每个进程只继续一次，每个需求 24 小时内最多 3 次），这时不再预约对话的定时检查；插件设为只读时不做。接单器（<code>req factory</code>）每次检查也同样直接继续</td></tr><tr><td><code>maxConcurrentPipelines</code></td><td>0（不限）</td><td>本机同时运行的流水线上限，满了排队。只能写在本机配置中才有意义</td></tr></tbody></table><h2 id="需求总览" tabindex="-1">需求总览 <a class="header-anchor" href="#需求总览" aria-label="Permalink to "需求总览""></a></h2><p><code>req digest</code> 在项目目录中列出所有工作区里的需求，按"需要处理、待验收、开发中、对齐中、已验收（最近 7 天）"分组，附用时与用量。<code>--notify</code> 同时发给外部通知（事件类型 <code>digest</code>）；<code>--schedule "<cron>"</code> 让 Paseo 按时间表（本机时区）启动一个短暂的 agent 执行 <code>req digest --notify</code>，例如每周一 9 点：<code>req digest --schedule "0 9 * * 1"</code>；取消：<code>req digest --cancel <定时任务 ID></code>。</p><h2 id="使用统计" tabindex="-1">使用统计 <a class="header-anchor" href="#使用统计" aria-label="Permalink to "使用统计""></a></h2><p>1.9.0 起，每次流水线运行结束时，引擎在本机的 <code>~/.req-kit/usage/runs.jsonl</code> 追加一条记录：各步骤的用时和用量、质量门、评审和缺陷轮数、结束时的状态（格式见 <a href="./../reference/contracts/usage-record">使用记录</a>）。只记在本机，不记需求内容和代码，也不会自动发往任何地方。</p><ul><li><code>req stats</code>：最近 30 天的统计（<code>--since 2w</code>、<code>--since 2026-10-01</code>、<code>--month 2026-10</code>）：有进展和完成的需求数、交付周期、返工（评审轮数、需要缺陷修复的占比、质量门失败）、各种等待的时长、各步骤用时、用量，以及不同 builder 的比较。1.13 起有"token 花在哪"一节：按步骤和按模型的 token 及占比、返工（方案修订、评审问题修复、缺陷修复、复验，以及第 2 轮起的审核和评审）的占比、输入中来自提示缓存的比例、每个完成需求的中位数；插件的"使用统计"页用条形图显示同样的内容。<code>--json</code>、<code>--csv</code> 输出机器可读的格式。</li><li><code>req stats --report --month 2026-10 [--out 目录]</code>：生成给管理方汇报用的两份文件：<code>req-kit-usage-2026-10.md</code>（汇总）和 <code>.csv</code>（每个需求一行，可以用表格软件打开）。</li><li>几台机器一起汇报：每台机器运行 <code>req stats --month 2026-10 --export</code>，得到 <code>req-kit-usage-<主机名>-<日期>.jsonl</code>；把这些文件放到一起，运行 <code>req stats --merge <文件…> --month 2026-10 --report</code>。</li></ul><p>本机的需求索引 <code>~/.req-kit/index/</code> 记录每个运行过的需求在哪个目录，Paseo 插件据此在一个页面列出本机所有项目的需求。1.9 之前运行过的需求不在索引里，在项目目录运行一次 <code>req index --rebuild</code> 补登；目录删掉后用 <code>req index --prune</code> 清理。</p><h2 id="外部系统对接-需求管理等" tabindex="-1">外部系统对接（需求管理等） <a class="header-anchor" href="#外部系统对接-需求管理等" aria-label="Permalink to "外部系统对接（需求管理等）""></a></h2><p>1.9.0 起，流水线可以把需求同步到团队的需求管理系统：需求开始时建一张卡片，之后每到一个阶段改卡片的状态，卡片编号和链接写回需求，显示在进度、完成报告和 Paseo 插件里。对接的是本机已有的命令行工具（例如需求管理系统的 CLI），写在本机或团队配置中（它会运行命令，项目配置中的会被忽略）：</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0" v-pre=""><code><span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"integrations"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span></span>
|
|
60
60
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
|
|
61
61
|
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "name"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"ALM"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
62
62
|
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> "command"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"alm"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
@@ -100,7 +100,7 @@
|
|
|
100
100
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"name"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"可维护性"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"provider"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"opencode/anthropic/<模型 ID>"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"modeId"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"build"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"featureValues"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"auto_accept"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> } }</span></span>
|
|
101
101
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ]</span></span>
|
|
102
102
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><ul><li>成员并行运行，在同一个目录里只读代码、写各自的意见文件（<code><功能目录>/review-panel/</code>），不提交，不改文件。</li><li>某位成员失败时，只汇总完成的成员；全部失败时该步骤失败。</li><li>成本：每次启用的评审多出 N 个 agent 的用量，所以默认只用于标准档的第一轮。</li><li>成员的模型和模式会在 <code>/req-doctor</code> 中一并检查。</li></ul><h2 id="需求总览、决策记录、变更与验收记录" tabindex="-1">需求总览、决策记录、变更与验收记录 <a class="header-anchor" href="#需求总览、决策记录、变更与验收记录" aria-label="Permalink to "需求总览、决策记录、变更与验收记录""></a></h2><ul><li><strong>需求总览</strong>：<code>node <req-kit>/bin/start-pipeline.mjs --list</code> 列出这个仓库所有 worktree 中的需求和各自的阶段（对齐中、开发中、待验收、已验收等）。总览现场生成，不提交到仓库，避免各分支合并时冲突。</li><li><strong>决策记录</strong> <code>decisions.tsv</code>：各步骤把不显而易见的选择（假设、取舍、偏离方案、驳回的评审意见、决定不修的问题）各记一行。会影响结果的标为 <code>needs_human=yes</code>，完成报告把它们列入"需要你确认的决定"。</li><li><strong>变更记录</strong> <code>changes.md</code>：每次修改需求（包括方案审核提出问题、验收发现问题）记一节，spec 头部的"版本"随之加 1。</li><li><strong>验收记录</strong> <code>acceptance.md</code>：由 <code>/req</code> 的验收手册写，逐条记录验收结果和结论。</li></ul><p>格式见 <code>contracts/feature-files.md</code>。</p><h2 id="运行规则" tabindex="-1">运行规则 <a class="header-anchor" href="#运行规则" aria-label="Permalink to "运行规则""></a></h2><p><strong>步骤和轮数</strong>（轮数按档位，在配置的 <code>profiles</code> 中调整；下面是标准档的默认值）：</p><table tabindex="0"><thead><tr><th>环节</th><th>规则</th></tr></thead><tbody><tr><td>评审小组（可选）</td><td>开启时，标准档的方案审核和代码评审第一轮先由小组成员并行评审，再由评审者核实汇总</td></tr><tr><td>方案审核 ⇄ 方案修订</td><td>最多 2 轮审核。判定"阻塞"时暂停并请需求方决定；最后一轮仍要求修改时，修订后直接进入实现</td></tr><tr><td>代码评审 ⇄ 评审问题修复</td><td>最多 3 轮评审，通过即止；轮数用完时修复后进入下一阶段</td></tr><tr><td>提测说明</td><td>代码评审之后执行，写 <code>handoff.md</code>。分阶段执行时研发阶段到此结束</td></tr><tr><td>服务启动验证</td><td>方案设计判断项目有常驻服务、且档位开启了 <code>serviceStart</code> 时才执行（在已部署的测试环境中验证时不执行）</td></tr><tr><td>缺陷修复 ⇄ 复验</td><td>功能验证发现缺陷时执行，最多 3 轮，复验通过即止（<code>phases.verify.defects</code> 为 <code>handback</code> 或 <code>report</code> 时见上文"执行方式"）</td></tr><tr><td>完成报告</td><td>只要没有暂停或中断就一定执行，遗留问题写进报告</td></tr><tr><td>完成后继续</td><td>完成后 spec.md 被修改过（需求变更、验收发现问题），<code>--resume</code> 从方案设计开始，各步骤在已有方案和代码的基础上只处理变化的部分；没改过则拒绝。<code>--restart</code> 则完全从零开始</td></tr><tr><td>增量继续</td><td>需求变更、回答了方案审核的问题后继续时：方案在原文末尾追加"第 N 次尝试"一节；实现只改需要改的；代码评审只看本次开始以来的改动；验证重新验证变化涉及的验收标准，其余的至少跑一遍现有测试；报告说明是第几次。做法写在 <code>engine/prompts/incremental.md</code>，可以用 <code>prompts.local/</code> 替换</td></tr></tbody></table><p><strong>结果文件</strong>：每步必须写一个 JSON 结果文件，流水线只看它，不看 agent 的回复文字。文件缺失或格式不对时，会在同一个会话里提醒 agent 补写，最多 2 次，仍不对则判定该步骤失败。</p><p><strong>等待与超时</strong>：每步有总时限（<code>stepTimeoutMinutes</code>）。到时 agent 还在做时，先再给它同样长的时间（<code>selfHeal</code>，见下）；仍未完成才判定失败，但不停止 agent。继续（<code>--resume</code>、自动重试）时先看这一步上一次的 agent：已经做完、结果文件有效就直接用它的结果；还在做就接着等它一轮（这一轮不再额外延长）；第二次仍超时才停止它、另起一个 agent。需求改过、开始了新一次尝试时，上一次留下的 agent 直接停掉，不接手（1.12.1）。同一步不会有两个 agent 同时在做（它们会改同样的文件、在同一个工作区提交、写同一个结果文件）。连续读不到 agent 状态时同样处理。等待被拆成每段 10 分钟（打开 <code>scanGuard</code> 时每段 1 分钟，以便查看正在运行的命令），连接断开时自动重试。agent 等待权限批准时，同一个请求只通知一次，然后继续等待。</p><p><strong>临时错误自动重试</strong>：步骤因限流（429）、服务暂时不可用（502/503/504/529、overloaded）、网络中断等临时错误失败时，等待后用新的 agent 重做这一步，并告诉它工作区里可能留有上一次没做完的改动。默认最多重试 2 次，分别等 1 分钟和 5 分钟：</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0" v-pre=""><code><span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"retry"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"attempts"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">2</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"backoffSeconds"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">60</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">300</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">] }</span></span></code></pre></div><p><code>attempts</code> 设为 0 关闭；<code>backoffSeconds</code> 的个数少于重试次数时，后面的重试使用最后一个值。超时、结果文件不合格、agent 自己判定失败等不是临时错误，不按这里重试。重试用完仍失败时，中断通知会注明已重试的次数。</p><p><strong>自愈</strong>（1.12，<code>selfHeal</code>，默认 <code>true</code>）：能安全自动处理的中断不再等人。</p><table tabindex="0"><thead><tr><th>情况</th><th>自动处理</th></tr></thead><tbody><tr><td>步骤超时，agent 还在做</td><td>不打断它，再等同样长的时间；仍未完成才中断</td></tr><tr><td>agent 报错（不是临时错误）</td><td>新开一个 agent 重做这一步一次；配置了备用模型时用备用模型</td></tr><tr><td>提醒后仍没有有效的结果文件</td><td>新开一个 agent 重做这一步一次</td></tr><tr><td>限流、额度用完，重试用完</td><td>配置了备用模型时，用备用模型再做一次；仍不行就中断，并按 Paseo 显示的额度恢复时间预约自动继续（恢复后 5 分钟；没有恢复时间时按 <code>autoResumeMinutes</code>）</td></tr><tr><td>方案审核说需要需求方决定</td><td>先请 builder 从代码、文档和需求说明中找答案（<code>answerQuestionsFirst</code>，默认 <code>true</code>），只把真正的业务取舍连同推荐答案交给需求方；都能回答时不停下。最后一轮审核的问题被自答时，再加一轮审核复核这些答案（1.12.1）</td></tr></tbody></table><p><strong>备用模型</strong>（1.12，可选）：<code>agents.fallback</code>，写法同 builder、reviewer，可以用 <code>paseoProfile</code>。<code>req configure</code> 和插件的"模型"设置页会推荐一个与主模型不同厂商的模型。</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0" v-pre=""><code><span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"agents"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"builder"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#B31D28;--shiki-light-font-style:italic;--shiki-dark:#FDAEB7;--shiki-dark-font-style:italic;">…</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"reviewer"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#B31D28;--shiki-light-font-style:italic;--shiki-dark:#FDAEB7;--shiki-dark-font-style:italic;">…</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"fallback"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"provider"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"opencode/<模型 ID>"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> } }</span></span></code></pre></div><p>自动处理的每一次都记在进度日志、状态文件的 <code>recoveries</code> 和使用记录中，<code>req stats</code> 的"人工介入"一节汇总：停下等人的原因、自动处理了多少次、到达提测的需求中没有非必要介入的比例。</p><p><strong>打断大目录搜索</strong>（1.13，<code>scanGuard</code>，默认开）：步骤 agent 有时为了找一个类或一个包，去搜索整个磁盘、用户目录、Maven 本地仓库（<code>~/.m2</code>）、Gradle 缓存、全局 <code>node_modules</code> 或整个 <code>node_modules</code>，一次就是几十分钟，这一步迟迟做不完。步骤运行时，流水线大约每分钟看一次 agent 正在运行的命令：搜索这类大目录的命令运行超过 1 分钟、或者任何搜索命令运行超过 <code>minutes</code> 分钟，就打断它，并告诉 agent 改用什么办法（在仓库里用 <code>git grep</code>；按 <code>pom.xml</code> 里的坐标直接打开那一个依赖目录、用 <code>unzip -l</code> 看那一个 jar；<code>mvn dependency:tree</code>；找不到就写进"假设"继续）。构建和测试命令（<code>mvn</code>、<code>gradle</code>、<code>npm test</code> 等）不打断；只搜具体的子目录（如 <code>~/.m2/repository/com/acme/foo</code>）或排除了 <code>node_modules</code> 的搜索也不算。同一个命令只打断一次，每轮最多打断 5 次；每次都记在进度日志和 <code>recoveries</code>（<code>stop_scan</code>）中。各步骤的提示词里也写明了只在仓库里搜索。</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0" v-pre=""><code><span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"scanGuard"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"enabled"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"minutes"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">5</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"paths"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"D:/share"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">] }</span></span></code></pre></div><p><code>paths</code>：另外不允许整个搜索的目录（例如共享盘）；<code>enabled: false</code> 关闭。</p><p><strong>同一个目录一次只运行一条流水线</strong>，因为各步骤都在这个目录中修改和提交。需要并行时，为每个需求使用单独的 worktree 工作区。</p><h2 id="注意事项" tabindex="-1">注意事项 <a class="header-anchor" href="#注意事项" aria-label="Permalink to "注意事项""></a></h2><ul><li><strong>发起流水线的聊天 agent 需要能访问本机网络。</strong> 流水线进程继承它的运行环境，需要连接 <code>ws://127.0.0.1:6767</code>。用 Codex 做聊天 agent 时，请使用 <code>full-access</code> 模式；沙箱模式可能禁止网络。</li><li><strong>必须在仓库对应的项目对话中发起，对话过程中不要切换工作目录。</strong> 步骤 agent 一律作为子 agent 挂在发起的对话下，而 Paseo 会让子 agent 使用父 agent 的工作目录，所以仓库目录必须就是这个对话的工作目录。在对话中启动时，<code>--repo</code> 默认就取对话的工作目录；两者不一致、或发起的对话已不存在时，流水线拒绝启动并说明原因。</li><li><strong>步骤 agent 以免确认模式运行</strong>，在本机拥有执行命令的权限。提示词禁止了危险操作，但这不是安全边界。请让仓库目录中不包含生产环境凭据。</li><li><strong>聊天被归档时</strong>，挂在它下面的步骤 agent 也会被归档；通知会发送失败，但流水线会继续运行到结束，结果仍可在 <code>report.md</code> 和日志中查看。</li><li><strong>daemon 重启</strong>会中断正在运行的步骤 agent。流水线会在连续 5 次无法获取状态后判定该步骤失败，之后可以用 <code>--resume</code> 继续。</li></ul></div><p class="source-note">本页由仓库中的 <a href="https://github.com/yiyisf/paseo-req-kit/blob/main/docs/guide/项目定制与运行规则.md">docs/guide/项目定制与运行规则.md</a> 生成。<a href="https://github.com/yiyisf/paseo-req-kit/edit/main/docs/guide/项目定制与运行规则.md">在 GitHub 上编辑</a></p></div></div></main><footer class="VPDocFooter" data-v-e6f2a212 data-v-1bcd8184><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-1bcd8184><span class="visually-hidden" id="doc-footer-aria-label" data-v-1bcd8184>Pager</span><div class="pager" data-v-1bcd8184><a class="VPLink link pager-link prev" href="/guide/install" data-v-1bcd8184><!--[--><span class="desc" data-v-1bcd8184>上一页</span><span class="title" data-v-1bcd8184>安装与升级</span><!--]--></a></div><div class="pager" data-v-1bcd8184><a class="VPLink link pager-link next" href="/guide/maintainer" data-v-1bcd8184><!--[--><span class="desc" data-v-1bcd8184>下一页</span><span class="title" data-v-1bcd8184>维护者指南</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-d8b57b2d data-v-566314d4><div class="container" data-v-566314d4><p class="message" data-v-566314d4>以 MIT 许可发布。req-kit 是运行在 Paseo 上的社区项目。</p><p class="copyright" data-v-566314d4>Copyright © 2026 yiyisf</p></div></footer><!--[--><!--]--></div></div>
|
|
103
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"changelog.md\":\"
|
|
103
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"changelog.md\":\"2xf690VW\",\"guide_getting-started.md\":\"zmtXv15G\",\"guide_how-it-works.md\":\"D-kQsF1t\",\"guide_index.md\":\"CLnGCmGW\",\"guide_install.md\":\"DkCyZsOU\",\"guide_maintainer.md\":\"C1v7EpSY\",\"guide_phases.md\":\"BpGAb1re\",\"guide_project.md\":\"Csi5wiyt\",\"guide_user.md\":\"2v7b_fzd\",\"index.md\":\"Cf_sSf_f\",\"reference_adr_0001-step-agents-under-origin-chat.md\":\"RtRTq7oi\",\"reference_adr_0002-no-directory-switch-in-chat.md\":\"BxtN-Aa2\",\"reference_adr_0003-script-engine-not-hub.md\":\"66EgZtqx\",\"reference_adr_0004-result-files.md\":\"DbqcCozI\",\"reference_adr_0005-no-default-branch-local-commits-only.md\":\"CkImA4s6\",\"reference_adr_0006-skill-install-targets.md\":\"CwY8YepV\",\"reference_adr_0007-own-interview-skill.md\":\"CryhxRyG\",\"reference_adr_0008-entries-do-not-call-entries.md\":\"DsRWAgeA\",\"reference_adr_0009-versioned-install-layout.md\":\"CSg1VqlW\",\"reference_adr_0010-generated-feature-overview.md\":\"D8F3MK-h\",\"reference_adr_0011-resume-after-completion.md\":\"BCrZrKjf\",\"reference_adr_0012-review-panel.md\":\"k9rrHFFc\",\"reference_adr_0013-no-release-tooling.md\":\"BQeJ8dEI\",\"reference_adr_0014-notifier-slot.md\":\"C23QR1xO\",\"reference_adr_0015-incremental-continue.md\":\"Buy7wwO8\",\"reference_adr_0016-upgrade-from-tags.md\":\"qfIW-tqJ\",\"reference_adr_0017-use-paseo-capabilities.md\":\"CjcGli87\",\"reference_adr_0018-own-worktree-option.md\":\"fVDpgGSE\",\"reference_adr_0019-parallel-orchestration.md\":\"DrfrV0To\",\"reference_adr_0020-scheduling-through-the-chat.md\":\"BqSemGFG\",\"reference_adr_0021-npm-version-manager.md\":\"CU3PG6y5\",\"reference_adr_0022-develop-and-verify-phases.md\":\"C6fQDLq4\",\"reference_adr_0023-types-gate-slices.md\":\"D2E6yyYQ\",\"reference_adr_0024-confirm-early-review-axes.md\":\"FmK_ke0x\",\"reference_adr_0025-joint-requirements.md\":\"ChoKvMUx\",\"reference_adr_0026-machine-records-and-api.md\":\"veybjBPq\",\"reference_adr_0027-paseo-plugin.md\":\"BMX33ZNU\",\"reference_adr_0028-external-integrations.md\":\"DtdMe8RK\",\"reference_adr_0029-requirements-from-cards.md\":\"BHd1SQPe\",\"reference_adr_0030-card-intake-process.md\":\"kLc-DG9_\",\"reference_adr_0031-fewer-interventions.md\":\"BDnQcz8g\",\"reference_adr_0032-npm-only-install.md\":\"C-3L1FkX\",\"reference_adr_0033-prototype-review-and-ui-check.md\":\"hFcQzmaa\",\"reference_adr_index.md\":\"BYF-Ofor\",\"reference_commands.md\":\"ClKbS-t8\",\"reference_config.md\":\"CRe27LaA\",\"reference_contracts_cli-json.md\":\"BR6gwq-e\",\"reference_contracts_feature-files.md\":\"DSiA8OEH\",\"reference_contracts_index.md\":\"Bkznz4px\",\"reference_contracts_notifier-event.md\":\"CCfrkm_A\",\"reference_contracts_result-file.md\":\"DmR4fjB-\",\"reference_contracts_spec.md\":\"BwwS0L_j\",\"reference_contracts_state.md\":\"EEBd_l2P\",\"reference_contracts_usage-record.md\":\"D5krNLW7\",\"reference_contracts_verify.md\":\"CbA88u6S\",\"reference_scope.md\":\"Kzqw8U_f\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"dir\":\"ltr\",\"title\":\"req-kit\",\"titleTemplate\":\":title · req-kit\",\"description\":\"在 Paseo 中用对话对齐需求，由一组 AI agent 在后台完成设计、实现、评审和验证。给测试、产品、项目经理用的需求开发体系。\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.svg\",\"siteTitle\":\"req-kit\",\"nav\":[{\"text\":\"指南\",\"link\":\"/guide/\",\"activeMatch\":\"^/guide/\"},{\"text\":\"参考\",\"link\":\"/reference/commands\",\"activeMatch\":\"^/reference/\"},{\"text\":\"更新记录\",\"link\":\"/changelog\"},{\"text\":\"v1.14.0-beta.2\",\"items\":[{\"text\":\"更新记录\",\"link\":\"/changelog\"},{\"text\":\"GitHub Releases\",\"link\":\"https://github.com/yiyisf/paseo-req-kit/releases\"},{\"text\":\"范围与取舍\",\"link\":\"/reference/scope\"}]}],\"sidebar\":{\"/guide/\":[{\"text\":\"开始\",\"items\":[{\"text\":\"req-kit 是什么\",\"link\":\"/guide/\"},{\"text\":\"快速开始\",\"link\":\"/guide/getting-started\"},{\"text\":\"工作原理\",\"link\":\"/guide/how-it-works\"}]},{\"text\":\"使用\",\"items\":[{\"text\":\"使用者指南\",\"link\":\"/guide/user\"},{\"text\":\"分阶段执行与提测\",\"link\":\"/guide/phases\"}]},{\"text\":\"安装与维护\",\"items\":[{\"text\":\"安装与升级\",\"link\":\"/guide/install\"},{\"text\":\"项目定制与运行规则\",\"link\":\"/guide/project\"},{\"text\":\"维护者指南\",\"link\":\"/guide/maintainer\"}]}],\"/reference/\":[{\"text\":\"参考\",\"items\":[{\"text\":\"命令\",\"link\":\"/reference/commands\"},{\"text\":\"配置项\",\"link\":\"/reference/config\"},{\"text\":\"范围与取舍\",\"link\":\"/reference/scope\"}]},{\"text\":\"文件格式约定\",\"collapsed\":false,\"items\":[{\"text\":\"总览\",\"link\":\"/reference/contracts/\"},{\"text\":\"需求说明 spec.md\",\"link\":\"/reference/contracts/spec\"},{\"text\":\"状态文件 state.json\",\"link\":\"/reference/contracts/state\"},{\"text\":\"结果文件\",\"link\":\"/reference/contracts/result-file\"},{\"text\":\"功能目录中的文件\",\"link\":\"/reference/contracts/feature-files\"},{\"text\":\"验证方法 verify.md\",\"link\":\"/reference/contracts/verify\"},{\"text\":\"外部通知事件\",\"link\":\"/reference/contracts/notifier-event\"},{\"text\":\"req api 的 JSON 输出\",\"link\":\"/reference/contracts/cli-json\"},{\"text\":\"需求索引与使用记录\",\"link\":\"/reference/contracts/usage-record\"}]},{\"text\":\"设计决定（ADR）\",\"collapsed\":true,\"items\":[{\"text\":\"总览\",\"link\":\"/reference/adr/\"},{\"text\":\"0001 步骤 agent 挂在发起的对话下\",\"link\":\"/reference/adr/0001-step-agents-under-origin-chat\"},{\"text\":\"0002 对话过程中不切换工作目录\",\"link\":\"/reference/adr/0002-no-directory-switch-in-chat\"},{\"text\":\"0003 第 3–11 步由脚本引擎驱动，不用 Hub 多步骤工作流\",\"link\":\"/reference/adr/0003-script-engine-not-hub\"},{\"text\":\"0004 步骤结论只看结果文件\",\"link\":\"/reference/adr/0004-result-files\"},{\"text\":\"0005 不在默认分支上运行，只做本地提交\",\"link\":\"/reference/adr/0005-no-default-branch-local-commits-only\"},{\"text\":\"0006 只安装到 ~/.agents/skills 和 ~/.claude/skills\",\"link\":\"/reference/adr/0006-skill-install-targets\"},{\"text\":\"0007 自带需求访谈 skill，不依赖外部 skill 包\",\"link\":\"/reference/adr/0007-own-interview-skill\"},{\"text\":\"0008 入口 skill 之间不互相调用\",\"link\":\"/reference/adr/0008-entries-do-not-call-entries\"},{\"text\":\"0009 程序与本机配置分开存放，按版本目录并存\",\"link\":\"/reference/adr/0009-versioned-install-layout\"},{\"text\":\"0010 需求总览现场生成，不维护 INDEX.md\",\"link\":\"/reference/adr/0010-generated-feature-overview\"},{\"text\":\"0011 完成后修改 spec 可以继续开发\",\"link\":\"/reference/adr/0011-resume-after-completion\"},{\"text\":\"0012 评审小组：首轮并行评审，评审者核实汇总\",\"link\":\"/reference/adr/0012-review-panel\"},{\"text\":\"0013 发布不使用 changesets 等工具\",\"link\":\"/reference/adr/0013-no-release-tooling\"},{\"text\":\"0014 外部通知只留接口，不内置任何 IM\",\"link\":\"/reference/adr/0014-notifier-slot\"},{\"text\":\"0015 需求变更后增量继续，而不是从零重做\",\"link\":\"/reference/adr/0015-incremental-continue\"},{\"text\":\"0016 一键升级：从 git 标签下载到 versions/ 再切换\",\"link\":\"/reference/adr/0016-upgrade-from-tags\"},{\"text\":\"0017 用好 Paseo 自身的能力：profile、工作区脚本、用量和时间线\",\"link\":\"/reference/adr/0017-use-paseo-capabilities\"},{\"text\":\"0018 可选：流水线为需求新建 worktree 工作区\",\"link\":\"/reference/adr/0018-own-worktree-option\"},{\"text\":\"0019 用 Paseo 的并行子 agent：确认前独立审阅、方案提案\",\"link\":\"/reference/adr/0019-parallel-orchestration\"},{\"text\":\"0020 调度：用 Paseo 定时任务把消息发回对话，排队在本机进行\",\"link\":\"/reference/adr/0020-scheduling-through-the-chat\"},{\"text\":\"0021 npm 分发：全局包是版本管理器，各版本仍装在 versions/ 下\",\"link\":\"/reference/adr/0021-npm-version-manager\"},{\"text\":\"0022 分阶段执行：研发阶段、闸口、测试验证阶段\",\"link\":\"/reference/adr/0022-develop-and-verify-phases\"},{\"text\":\"0023 需求类型、质量门、按切片实现\",\"link\":\"/reference/adr/0023-types-gate-slices\"},{\"text\":\"0024 让分歧更早暴露：验收例子、方案确认点、两个方向的评审、反复的问题变成规则\",\"link\":\"/reference/adr/0024-confirm-early-review-axes\"},{\"text\":\"0025 联合需求：一个需求同时改几个仓库\",\"link\":\"/reference/adr/0025-joint-requirements\"},{\"text\":\"0026 本机的需求索引、使用记录和 req api\",\"link\":\"/reference/adr/0026-machine-records-and-api\"},{\"text\":\"0027 Paseo 插件：随 req-kit 一起发布，只通过 req api 工作\",\"link\":\"/reference/adr/0027-paseo-plugin\"},{\"text\":\"0028 外部系统对接：命令写法在配置里，内容由 AI 整理，调用是确定的\",\"link\":\"/reference/adr/0028-external-integrations\"},{\"text\":\"0029 从卡片开始的需求：需求会话代替人，卡片描述代替对话\",\"link\":\"/reference/adr/0029-requirements-from-cards\"},{\"text\":\"0030 接单器：共享机器上定时接卡片、转达回复\",\"link\":\"/reference/adr/0030-card-intake-process\"},{\"text\":\"0031 少等人：每种中断都有自动的下一步\",\"link\":\"/reference/adr/0031-fewer-interventions\"},{\"text\":\"0032 安装、升级和文档只依赖 npm 源\",\"link\":\"/reference/adr/0032-npm-only-install\"},{\"text\":\"0033 原型审查页和不靠看图的界面检查\",\"link\":\"/reference/adr/0033-prototype-review-and-ui-check\"}]}]},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/yiyisf/paseo-req-kit\"}],\"editLink\":{\"pattern\":\"https://github.com/yiyisf/paseo-req-kit/edit/main/site/:path\",\"text\":\"在 GitHub 上编辑此页\"},\"footer\":{\"message\":\"以 MIT 许可发布。req-kit 是运行在 Paseo 上的社区项目。\",\"copyright\":\"Copyright © 2026 yiyisf\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"搜索文档\",\"buttonAriaLabel\":\"搜索文档\"},\"modal\":{\"noResultsText\":\"没有找到相关结果\",\"resetButtonTitle\":\"清除\",\"footer\":{\"selectText\":\"选择\",\"navigateText\":\"切换\",\"closeText\":\"关闭\"}}}}},\"outline\":{\"level\":[2,3],\"label\":\"本页内容\"},\"docFooter\":{\"prev\":\"上一页\",\"next\":\"下一页\"},\"lastUpdated\":{\"text\":\"最后更新\"},\"returnToTopLabel\":\"回到顶部\",\"sidebarMenuLabel\":\"目录\",\"darkModeSwitchLabel\":\"外观\",\"lightModeSwitchTitle\":\"切换到浅色\",\"darkModeSwitchTitle\":\"切换到深色\",\"externalLinkIcon\":true,\"notFound\":{\"title\":\"页面不存在\",\"quote\":\"这个页面可能已经移动或删除。\",\"linkText\":\"回到首页\"}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
|
|
104
104
|
|
|
105
105
|
</body>
|
|
106
106
|
</html>
|