paseo-req-kit 1.10.0-beta.2 → 1.11.0-beta.1

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.
Files changed (20) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/bin/req.mjs +5 -0
  3. package/contracts/state.md +1 -0
  4. package/contracts/usage-record.md +1 -1
  5. package/docs/adr/0029-requirements-from-cards.md +3 -1
  6. package/docs/adr/0030-card-intake-process.md +22 -0
  7. package/docs/adr/README.md +1 -0
  8. 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 +58 -0
  9. package/engine/src/card-cmd.ts +146 -58
  10. package/engine/src/card.ts +84 -0
  11. package/engine/src/config.ts +48 -1
  12. package/engine/src/factory.ts +406 -0
  13. package/engine/src/integrations.ts +29 -1
  14. package/engine/src/pipeline.ts +38 -2
  15. package/engine/src/records.ts +16 -0
  16. package/engine/src/state.ts +5 -0
  17. package/engine/src/stats.ts +23 -0
  18. package/package.json +1 -1
  19. package/paseo-plugin/package.json +1 -1
  20. package/skills/req-setup/SKILL.md +4 -0
package/paseo-plugin/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "req-kit-paseo-plugin",
3
- "version": "1.10.0-beta.2",
3
+ "version": "1.11.0-beta.1",
4
4
  "private": true,
5
5
  "description": "The req-kit plugin for Paseo. Ships inside the paseo-req-kit package; installed with req plugin install.",
6
6
  "type": "module",
package/skills/req-setup/SKILL.md CHANGED
@@ -60,6 +60,7 @@ metadata:
60
60
  - 有没有相关的其他仓库（例如这是前端，接口在另一个后端仓库）：在这台机器上的位置、它提供什么。登记后流水线的步骤可以只读参考它，不会改动它
61
61
  - 多模块的仓库（例如 `web/` 和 `server/` 各有自己的测试）：确认各模块的检查命令，第 5 步按模块写进 `checks`
62
62
  - 项目已经有 `paseo.json` 时，要不要由你补充；没有时，要不要生成（推荐生成，见第 5 步）
63
+ - **从卡片接需求**（团队对接了需求管理系统时）：先执行 `node "{{REQ_KIT_ROOT}}/bin/req.mjs" card route`。输出"没有配置可以读取卡片的外部系统"或团队不用卡片开始需求时跳过；否则问：这个仓库属于需求管理系统中的哪个空间（项目编号，如 ALM 的 projectId）、接哪些子系统的卡片（卡片上显示的子系统名称，可以多个）；同一个子系统还有别的仓库时（例如前端和后端各一个），卡片标题中用什么词区分（例如服务名"message-service"、"后端"）。第 5 步写进 `cardSource`
63
64
 
64
65
  ## 4. 实际运行验证命令
65
66
 
@@ -106,6 +107,7 @@ metadata:
106
107
  }
107
108
  ```
108
109
  - `relatedRepos`（有关联仓库时）：`[{ "name": "后端", "path": "../backend", "role": "提供登录和订单接口" }]`。`path` 写相对项目目录的路径（团队约定把相关仓库放在同一个上级目录最方便），也可以写 `~/` 开头的路径。平时流水线的步骤只读不改；需求说明写了"联合开发"时，流水线会为这个需求在它那里新建工作区，一起开发。关联仓库最好也运行过 `/req-setup`，它自己的检查命令、验证方法和项目说明会用在它的步骤里。
110
+ - `cardSource`（第 3 步确认了从卡片接需求时）：`{ "system": "ALM", "projectId": "186149", "subsystems": ["CSP-CMASTER_云匠"], "titleKeywords": ["message-service"] }`。`system` 是团队对接配置中的系统名称；`titleKeywords` 只在同一子系统有几个仓库时写。之后 `req start --from` 不写仓库时，按卡片的子系统和标题选到这个仓库
109
111
  - 其他设置只在需要和本机配置不同时才写，例如 `"defaultProfile": "quick"`。不要写 `daemonUrl`、`daemonPasswordEnv`、`teamConfig`，写了也会被忽略。
110
112
  - `.gitignore`：确认包含 `docs/features/*/.pipeline/`（流水线的运行状态），没有就建议加上。
111
113
 
@@ -115,4 +117,6 @@ metadata:
115
117
 
116
118
  用户确认后，只提交这几个文件（以及 `GLOSSARY.md`、`scripts/paseo/` 和 `.gitignore` 的改动）。`paseo.json` 必须提交：Paseo 新建 worktree 时读取的是基准分支上已提交的版本，提交信息例如 `chore(req-kit): 项目接入说明与验证方法`。不 push。
117
119
 
120
+ 写了 `cardSource` 的，提交后执行 `node "{{REQ_KIT_ROOT}}/bin/req.mjs" card route --add .`，在这台机器上登记这个仓库接收卡片（每台接单的机器各登记一次）。
121
+
118
122
  最后告诉用户：之后项目的构建、测试或启动方式有变化时，再运行一次 `/req-setup`；也可以直接编辑这些文件。可以运行 `/req-doctor` 确认项目检查全部正常。