@tea-agent/loop-agent 0.13.0 → 0.14.0

package/skills/analyze-product-dependencies/references/example.md

@@ -1,76 +1,76 @@
-# V3 输出示例
-
-## API 索引与详情
-
-````md
-## 2. API 索引
-| API | Method + Path | Operation ID | 用户故事 | AC | 变更 |
-|---|---|---|---|---|---|
-| API-001 | GET /api/v1/orders/{orderId}/refund-status | getRefundStatus | BE-US-001 | AC-BE-001 | 新增 |
-
-## 3. API 详情
-### API-001 查询退款状态
-> `GET /api/v1/orders/{orderId}/refund-status`
-
-#### 基本信息
-| 字段 | 值 |
-|---|---|
-| Operation ID | getRefundStatus |
-| 变更类型 | 新增 |
-| 幂等性 | 只读请求天然幂等 |
-
-#### Path 参数
-| 参数 | 类型 | 必填 | 语义 |
-|---|---|---|---|
-| orderId | string | 是 | 订单标识 |
-
-#### 成功响应
-- HTTP：200
-```json
-{"data":{"refundStatus":"processing"}}
-```
-
-#### 错误响应
-| 状态码 | 错误码 | 条件 |
-|---|---|---|
-| 403 | FORBIDDEN | 资源访问被拒绝 |
-```json
-{"code":"FORBIDDEN","message":"forbidden"}
-```
-
-````
-
-无 Path、Query、Body 或专属 Header 时省略对应章节。
-
-分页接口在 Query 参数中定义可选的每页条数：
-
-```md
-#### Query 参数
-| 参数 | 类型 | 必填 | 允许值 | 语义 |
-|---|---|---|---|---|
-| pageSize | integer | 否 | 10 \| 20 \| 50 \| 100 | 每页条数 |
-| cursor | string | 否 | - | 下一页游标 |
-```
-
-字段与 code 定义前先在内部搜索仓库共享定义，命中时直接复用；API 文档不生成“复用检查”或搜索证据。
-
-## Dependency 影响文件与 API 映射
-
-```md
-### BE-US-001 查询退款状态
-- 验收标准：AC-BE-001
-- API 文档引用：API-001
-- 影响文件：
-  - F1 modify `src/refund/refund.controller.ts`：增加查询入口
-  - F2 modify `src/refund/refund.service.ts`：组合退款状态
-- 路由/入口：F1 注册退款状态路由
-- Controller/Handler：F1 校验身份和订单 ID
-- Service/领域逻辑：F2 组合状态
-
-## API 实现映射
-| API | Operation ID | 方法与路径 | 代码入口 |
-|---|---|---|---|
-| API-001 | getRefundStatus | GET /api/v1/orders/{orderId}/refund-status | F1 |
-```
-
-`影响文件` 是完整路径清单；其余字段使用 F 编号引用。非 API 后端故事不生成 API 文档。
+# V3 输出示例
+
+## API 索引与详情
+
+````md
+## 2. API 索引
+| API | Method + Path | Operation ID | 用户故事 | AC | 变更 |
+|---|---|---|---|---|---|
+| API-001 | GET /api/v1/orders/{orderId}/refund-status | getRefundStatus | BE-US-001 | AC-BE-001 | 新增 |
+
+## 3. API 详情
+### API-001 查询退款状态
+> `GET /api/v1/orders/{orderId}/refund-status`
+
+#### 基本信息
+| 字段 | 值 |
+|---|---|
+| Operation ID | getRefundStatus |
+| 变更类型 | 新增 |
+| 幂等性 | 只读请求天然幂等 |
+
+#### Path 参数
+| 参数 | 类型 | 必填 | 语义 |
+|---|---|---|---|
+| orderId | string | 是 | 订单标识 |
+
+#### 成功响应
+- HTTP：200
+```json
+{"data":{"refundStatus":"processing"}}
+```
+
+#### 错误响应
+| 状态码 | 错误码 | 条件 |
+|---|---|---|
+| 403 | FORBIDDEN | 资源访问被拒绝 |
+```json
+{"code":"FORBIDDEN","message":"forbidden"}
+```
+
+````
+
+无 Path、Query、Body 或专属 Header 时省略对应章节。
+
+分页接口在 Query 参数中定义可选的每页条数：
+
+```md
+#### Query 参数
+| 参数 | 类型 | 必填 | 允许值 | 语义 |
+|---|---|---|---|---|
+| pageSize | integer | 否 | 10 \| 20 \| 50 \| 100 | 每页条数 |
+| cursor | string | 否 | - | 下一页游标 |
+```
+
+字段与 code 定义前先在内部搜索仓库共享定义，命中时直接复用；API 文档不生成“复用检查”或搜索证据。
+
+## Dependency 影响文件与 API 映射
+
+```md
+### BE-US-001 查询退款状态
+- 验收标准：AC-BE-001
+- API 文档引用：API-001
+- 影响文件：
+  - F1 modify `src/refund/refund.controller.ts`：增加查询入口
+  - F2 modify `src/refund/refund.service.ts`：组合退款状态
+- 路由/入口：F1 注册退款状态路由
+- Controller/Handler：F1 校验身份和订单 ID
+- Service/领域逻辑：F2 组合状态
+
+## API 实现映射
+| API | Operation ID | 方法与路径 | 代码入口 |
+|---|---|---|---|
+| API-001 | getRefundStatus | GET /api/v1/orders/{orderId}/refund-status | F1 |
+```
+
+`影响文件` 是完整路径清单；其余字段使用 F 编号引用。非 API 后端故事不生成 API 文档。

package/skills/analyze-product-dependencies/references/forward-test-cases.md

@@ -1,35 +1,35 @@
-# Forward-Test Cases
-
-## Case 1：缩小为 frontend
-
-使用 complete、scope 为 both 的 Product Requirement 和真实仓库，指定 `--target frontend`。核对：只生成 `dependency-analysis.md`；`analysis_scope` 为 `frontend`；不生成空 API 文档；没有后端依赖章节、`BE-US-*` 或 API 实现映射；每个 FE 故事有文件证据和状态边界落点。
-
-## Case 2：backend API
-
-```text
-Use $analyze-product-dependencies with a complete backend Product Requirement whose BE-US-001 trigger is API, plus a repository.
-```
-
-核对：两个文件写入 Product Requirement 的同一需求目录；API 索引覆盖 API ID、Operation ID、方法路径、故事和 AC；Dependency 的 API 映射只保留 API ID、Operation ID、方法路径和代码入口；影响文件使用唯一 F 编号。
-
-同时核对：API 文档不含认证方式、权限要求、业务规则、业务逻辑或实现逻辑及其相关内容；字段与 code 在生成前内部搜索共享定义，但 API 文档不输出“复用检查”或搜索证据。若接口分页，每页条数参数必须可选，允许值完整包含 `10/20/50/100`。
-
-## Case 3：backend 定时任务
-
-使用触发方式为定时任务的归档需求。核对：只生成 Dependency；`source_api_documentation: none`；API 映射写不适用；重点定位 scheduler、job、幂等、批次、数据库和恢复测试。
-
-## Case 4：业务契约缺失
-
-使用缺少权限范围或输出语义的 API 型 Product Requirement。核对：不得发明产品决策；生成 blocked 依赖产物并返回上游补充。
-
-## Case 5：不存在的目标能力
-
-代码库中没有对应实现。核对：允许结论为新增，但证据必须展示已搜索范围和邻近模式；不得虚构文件已经存在。
-
-## Case 6：缩小分析范围
-
-使用 scope 为 both 的 Product Requirement，并指定 `target=backend`。核对：输入门禁通过；只要求 BE 故事覆盖；Dependency 和适用的 API 文档使用 `analysis_scope: backend`，不强制生成前端详情。
-
-## Case 7：缺少输入
-
-分别缺少 Product Requirement 和代码仓库。核对：只生成四个固定章节的 blocked Dependency；前者使用 `source_product_requirement: none`，后者允许 `repository_root: none`；不得生成 API 文档或确定性代码位置。
+# Forward-Test Cases
+
+## Case 1：缩小为 frontend
+
+使用 complete、scope 为 both 的 Product Requirement 和真实仓库，指定 `--target frontend`。核对：只生成 `dependency-analysis.md`；`analysis_scope` 为 `frontend`；不生成空 API 文档；没有后端依赖章节、`BE-US-*` 或 API 实现映射；每个 FE 故事有文件证据和状态边界落点。
+
+## Case 2：backend API
+
+```text
+Use $analyze-product-dependencies with a complete backend Product Requirement whose BE-US-001 trigger is API, plus a repository.
+```
+
+核对：两个文件写入 Product Requirement 的同一需求目录；API 索引覆盖 API ID、Operation ID、方法路径、故事和 AC；Dependency 的 API 映射只保留 API ID、Operation ID、方法路径和代码入口；影响文件使用唯一 F 编号。
+
+同时核对：API 文档不含认证方式、权限要求、业务规则、业务逻辑或实现逻辑及其相关内容；字段与 code 在生成前内部搜索共享定义，但 API 文档不输出“复用检查”或搜索证据。若接口分页，每页条数参数必须可选，允许值完整包含 `10/20/50/100`。
+
+## Case 3：backend 定时任务
+
+使用触发方式为定时任务的归档需求。核对：只生成 Dependency；`source_api_documentation: none`；API 映射写不适用；重点定位 scheduler、job、幂等、批次、数据库和恢复测试。
+
+## Case 4：业务契约缺失
+
+使用缺少权限范围或输出语义的 API 型 Product Requirement。核对：不得发明产品决策；生成 blocked 依赖产物并返回上游补充。
+
+## Case 5：不存在的目标能力
+
+代码库中没有对应实现。核对：允许结论为新增，但证据必须展示已搜索范围和邻近模式；不得虚构文件已经存在。
+
+## Case 6：缩小分析范围
+
+使用 scope 为 both 的 Product Requirement，并指定 `target=backend`。核对：输入门禁通过；只要求 BE 故事覆盖；Dependency 和适用的 API 文档使用 `analysis_scope: backend`，不强制生成前端详情。
+
+## Case 7：缺少输入
+
+分别缺少 Product Requirement 和代码仓库。核对：只生成四个固定章节的 blocked Dependency；前者使用 `source_product_requirement: none`，后者允许 `repository_root: none`；不得生成 API 文档或确定性代码位置。

package/skills/analyze-product-dependencies/references/input-contract.md

@@ -1,11 +1,11 @@
-# Product Requirement 输入契约
-
-首选输入为 complete V3 `product-requirement.md`。迁移期允许读取 complete V2，但不修改上游产物；新产物始终使用 V3。
-
-V3 必须包含精简用户故事、同 ID 输出规范和嵌入规范的 AC。故事与规范一一对应，故事 AC 引用与规范内 AC 完全一致。V2 继续按其原有嵌入故事的 AC 读取。
-
-必须提供存在、可读的代码仓库。Product Requirement 位于 `<project-root>/docs/product-analysis/<requirement-id>/`；新增产物写回同目录并继承 ID。显式 target 必须是上游 scope 的子集。
-
-任一选中后端故事的触发方式为 API 时生成 `api-documentation.md`；非 HTTP 触发不得生成空 API 文档。业务输入输出、权限、核心规则或安全边界缺失时阻断。
-
-门禁失败时 Dependency Analysis 只包含分析范围、输入与代码基线、阻断原因、恢复条件。`blocked_on` 使用 requirement-missing、requirement-invalid、requirement-not-complete、repository-missing、repository-unreadable、scope-mismatch、missing-stories、missing-acceptance、api-business-contract-incomplete。
+# Product Requirement 输入契约
+
+首选输入为 complete V3 `product-requirement.md`。迁移期允许读取 complete V2，但不修改上游产物；新产物始终使用 V3。
+
+V3 必须包含精简用户故事、同 ID 输出规范和嵌入规范的 AC。故事与规范一一对应，故事 AC 引用与规范内 AC 完全一致。V2 继续按其原有嵌入故事的 AC 读取。
+
+必须提供存在、可读的代码仓库。Product Requirement 位于 `<project-root>/docs/product-analysis/<requirement-id>/`；新增产物写回同目录并继承 ID。显式 target 必须是上游 scope 的子集。
+
+任一选中后端故事的触发方式为 API 时生成 `api-documentation.md`；非 HTTP 触发不得生成空 API 文档。业务输入输出、权限、核心规则或安全边界缺失时阻断。
+
+门禁失败时 Dependency Analysis 只包含分析范围、输入与代码基线、阻断原因、恢复条件。`blocked_on` 使用 requirement-missing、requirement-invalid、requirement-not-complete、repository-missing、repository-unreadable、scope-mismatch、missing-stories、missing-acceptance、api-business-contract-incomplete。

package/skills/analyze-product-dependencies/references/scouting-rules.md

@@ -1,61 +1,61 @@
-# 代码侦察与证据规则
-
-## 目录
-
-- 搜索顺序
-- 事实与推断
-- 前端必查项
-- 后端必查项
-- 未定位项
-
-## 搜索顺序
-
-1. 阅读仓库级指令、README、技术栈配置和相关架构文档。
-2. 可用时优先使用 CodeGraph 定位符号、引用和调用关系。
-3. 使用 `rg --files` 建立文件范围，使用 `rg` 搜索路由、组件、接口、字段、状态和领域术语。
-4. 阅读入口文件、直接依赖、邻近实现和共享 helper。
-5. 只沿与用户故事相关的引用继续扩展，避免无边界扫描。
-
-## 事实与推断
-
-- `confirmed`：文件存在，并有 import、调用、路由、注册、类型或配置证据。
-- `inferred`：根据命名和邻近模式推断，但没有完整引用证据；置信度只能为 medium 或 low，证据必须分别写明已观察事实和推断链，不得使用“已确认”措辞。
-- `unknown`：搜索后仍无法定位。
-
-每项记录证据，例如：路由注册、组件 import、service 调用、repository 注入、类型引用或配置项。不要只凭文件名断言依赖。
-
-## 前端必查项
-
-- 页面入口、路由和布局。
-- 已使用或受影响的组件及其真实文件路径。
-- hooks、状态管理、缓存和请求层。
-- API client、类型定义、权限控制和错误展示。
-- normal、loading、empty、error、disabled 及输出规范中的边界处理落点。
-
-每个 `FE-US-*` 都必须单独输出，不能只给一份页面级汇总。
-
-## 后端必查项
-
-- API 路由、controller/handler 和请求校验。
-- application service、domain service 和业务规则。
-- repository、数据模型、查询与写入路径。
-- 鉴权、权限范围、幂等、并发和错误映射。
-- 事件、任务、外部服务、配置、日志和审计。
-- API 场景额外检查路由前缀、版本策略、HTTP 方法惯例、统一响应外壳、分页、时间和标识符格式，以及相似接口的 Swagger/OpenAPI 注释模式。
-- 字段定义前搜索共享 DTO/Schema、OpenAPI components、基础响应类与分页类；命中时复用而不复制定义。搜索与复用判断只用于内部建模，不输出到 API 文档。
-- 返回 code 定义前搜索全局错误枚举、异常到 code 的映射、错误响应外壳与相似接口；命中时复用，未命中才允许局部新定义。搜索与复用判断只用于内部建模，不输出到 API 文档。
-- 分页接口确认仓库既有参数名和默认值；每页条数参数必须为可选，允许值为 `10 | 20 | 50 | 100`。
-
-每个 `BE-US-*` 都必须单独输出，不能只给一份服务级汇总。
-
-API 技术设计优先级为：Product Requirement 已确认业务契约 > 代码库现有 API 规范 > 相似 API 模式 > 通用 REST 规则。现有实现不得覆盖已确认需求；业务语义缺失时阻断。
-
-## 未定位项
-
-不能用猜测路径填补空白。输出：
-
-- 影响文件路径：未定位。
-- 已搜索范围：实际搜索过的目录、符号或关键词。
-- 原因：例如功能尚不存在、命名不一致或缺少目标仓库。
-- 下一步：需要的文档、仓库或人工确认。
-- 置信度：low。
+# 代码侦察与证据规则
+
+## 目录
+
+- 搜索顺序
+- 事实与推断
+- 前端必查项
+- 后端必查项
+- 未定位项
+
+## 搜索顺序
+
+1. 阅读仓库级指令、README、技术栈配置和相关架构文档。
+2. 可用时优先使用 CodeGraph 定位符号、引用和调用关系。
+3. 使用 `rg --files` 建立文件范围，使用 `rg` 搜索路由、组件、接口、字段、状态和领域术语。
+4. 阅读入口文件、直接依赖、邻近实现和共享 helper。
+5. 只沿与用户故事相关的引用继续扩展，避免无边界扫描。
+
+## 事实与推断
+
+- `confirmed`：文件存在，并有 import、调用、路由、注册、类型或配置证据。
+- `inferred`：根据命名和邻近模式推断，但没有完整引用证据；置信度只能为 medium 或 low，证据必须分别写明已观察事实和推断链，不得使用“已确认”措辞。
+- `unknown`：搜索后仍无法定位。
+
+每项记录证据，例如：路由注册、组件 import、service 调用、repository 注入、类型引用或配置项。不要只凭文件名断言依赖。
+
+## 前端必查项
+
+- 页面入口、路由和布局。
+- 已使用或受影响的组件及其真实文件路径。
+- hooks、状态管理、缓存和请求层。
+- API client、类型定义、权限控制和错误展示。
+- normal、loading、empty、error、disabled 及输出规范中的边界处理落点。
+
+每个 `FE-US-*` 都必须单独输出，不能只给一份页面级汇总。
+
+## 后端必查项
+
+- API 路由、controller/handler 和请求校验。
+- application service、domain service 和业务规则。
+- repository、数据模型、查询与写入路径。
+- 鉴权、权限范围、幂等、并发和错误映射。
+- 事件、任务、外部服务、配置、日志和审计。
+- API 场景额外检查路由前缀、版本策略、HTTP 方法惯例、统一响应外壳、分页、时间和标识符格式，以及相似接口的 Swagger/OpenAPI 注释模式。
+- 字段定义前搜索共享 DTO/Schema、OpenAPI components、基础响应类与分页类；命中时复用而不复制定义。搜索与复用判断只用于内部建模，不输出到 API 文档。
+- 返回 code 定义前搜索全局错误枚举、异常到 code 的映射、错误响应外壳与相似接口；命中时复用，未命中才允许局部新定义。搜索与复用判断只用于内部建模，不输出到 API 文档。
+- 分页接口确认仓库既有参数名和默认值；每页条数参数必须为可选，允许值为 `10 | 20 | 50 | 100`。
+
+每个 `BE-US-*` 都必须单独输出，不能只给一份服务级汇总。
+
+API 技术设计优先级为：Product Requirement 已确认业务契约 > 代码库现有 API 规范 > 相似 API 模式 > 通用 REST 规则。现有实现不得覆盖已确认需求；业务语义缺失时阻断。
+
+## 未定位项
+
+不能用猜测路径填补空白。输出：
+
+- 影响文件路径：未定位。
+- 已搜索范围：实际搜索过的目录、符号或关键词。
+- 原因：例如功能尚不存在、命名不一致或缺少目标仓库。
+- 下一步：需要的文档、仓库或人工确认。
+- 置信度：low。