@tea-agent/loop-agent 0.25.6 → 0.26.0

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。