设计决定（ADR）

req-kit 自身的设计决定。修改其中任何一条，请新增一条 ADR 说明理由，并在旧的一条中注明被哪条取代。

• 0001 步骤 agent 挂在发起的对话下
• 0002 对话过程中不切换工作目录
• 0003 第 3–11 步由脚本引擎驱动，不用 Hub 多步骤工作流
• 0004 步骤结论只看结果文件
• 0005 不在默认分支上运行，只做本地提交
• 0006 只安装到 ~/.agents/skills 和 ~/.claude/skills
• 0007 自带需求访谈 skill，不依赖外部 skill 包
• 0008 入口 skill 之间不互相调用
• 0009 程序与本机配置分开存放，按版本目录并存
• 0010 需求总览现场生成，不维护 INDEX.md
• 0011 完成后修改 spec 可以继续开发
• 0012 评审小组：首轮并行评审，评审者核实汇总
• 0013 发布不使用 changesets 等工具
• 0014 外部通知只留接口，不内置任何 IM
• 0015 需求变更后增量继续，而不是从零重做
• 0016 一键升级：从 git 标签下载到 versions/ 再切换
• 0017 用好 Paseo 自身的能力：profile、工作区脚本、用量和时间线
• 0018 可选：流水线为需求新建 worktree 工作区
• 0019 用 Paseo 的并行子 agent：确认前独立审阅、方案提案
• 0020 调度：用 Paseo 定时任务把消息发回对话，排队在本机进行
• 0021 npm 分发：全局包是版本管理器，各版本仍装在 versions/ 下
• 0022 分阶段执行：研发阶段、闸口、测试验证阶段
• 0023 需求类型、质量门、按切片实现
• 0024 让分歧更早暴露：验收例子、方案确认点、两个方向的评审、反复的问题变成规则
• 0025 联合需求：一个需求同时改几个仓库
• 0026 本机的需求索引、使用记录和 req api
• 0027 Paseo 插件：随 req-kit 一起发布，只通过 req api 工作
• 0028 外部系统对接：命令写法在配置里，内容由 AI 整理，调用是确定的
• 0029 从卡片开始的需求：需求会话代替人，卡片描述代替对话
• 0030 接单器：共享机器上定时接卡片、转达回复
• 0031 少等人：每种中断都有自动的下一步
• 0032 安装、升级和文档只依赖 npm 源
• 0033 原型审查页和不靠看图的界面检查

本页由仓库中的 docs/adr/README.md 生成。在 GitHub 上编辑