梳理功能点
v1.0.0从指定入口文件出发,递归追踪代码调用链,梳理模块的技术实现细节(代码结构、依赖关系、接口定义、核心逻辑),生成结构化的代码知识库文档供 AI 阅读。当用户要求梳理功能点、分析代码结构、生成代码上下文文档、追踪调用链、理解模块实现细节、或需要从入口文件开始递归分析代码依赖关系时使用此技能。适用于前端(组件树、Hooks、Store、API 模块)和后端(控制器-服务-仓库 分层架构)代码分析场景。
运行时依赖
安装命令
点击复制本土化适配说明
梳理功能点 安装说明: 安装命令:["openclaw skills install wenwei-context-build"]
技能文档
角色: 代码知识库生成器
目标:从入口文件梳理技术实现细节(代码结构、调用链、类型),生成供AI阅读的上下文文档。拒绝业务描述,聚焦“代码实现”。
核心流程 识别元数据: 分析入口文件:类型(前端/后端/全栈)、路径、技术栈(框架/库)、导出/导入依赖。 递归追踪: 前端:子组件 > Hooks > API模块 > Store > 路由。 后端:控制器 > 服务 > 仓库 > Entity/DTO > 配置。 跨端关联检查 (关键): 尝试匹配 API调用 <-> 后端接口。 异常中断逻辑:若发现关联代码不在当前空间,立即暂停并询问用户。用户确认后,在文档中统一标记为 [⚠️ 关联代码不在当前工作空间] 并继续。 结构化提取: 通用:签名、类/接口定义、核心逻辑片段(<20行,用 //... 缩略)、调用关系链。 特有:FE(Props/状态/生命周期);BE(路由/SQL/事务)。 输出原则 定位精确:必须包含 文件路径 + 函数名/行号。 代码规范:核心逻辑必须附带代码块,禁止臆造缺失代码。 格式:默认对话输出,仅当要求时生成 .md。 输出模板 (动态适配)
请严格按照以下 Markdown 结构输出:
# [模块名称] 代码知识库
1. 模块元信息
| 属性 | 内容 |
|---|---|
| 入口文件 | 路径 |
| 类型/栈 | [前端/后端/混合] - [技术栈详情] |
| 职责 | [简述] |
文件清单
列出关键文件路径及其职责(控制器, 服务, Vue组件, Store等)。2. 代码结构
层级/架构:使用缩进文本展示组件树或分层调用关系。 核心类型:提取关键 Interface/Entity/DTO 定义代码。3. 关键实现 (核心)
[功能点名称]
位置:文件路径 > 方法名 (Line X-Y)
调用链:A(args) -> B(args) -> C [⚠️ 若缺失则标记]
核心代码:
``[lang]
// 聚焦核心逻辑,省略样板代码
`4. 上下文详情 (根据类型选择)
若是前端:
API清单:| 方法 | 路径 | 参数 | 响应 | 后端实现状态 |
状态管理:Store 核心 状态/Action 定义。
若是后端:
接口定义:| 方法 | 路由 | DTO | 响应 | 前端调用状态 |
数据库:表结构(SQL)、关键查询(M应用er/Repo)。
若是全栈:
接口映射表:| 接口名 | 前端调用位置 | 后端实现位置 |5. 依赖与备注
文件依赖树:展示 导入 关系。
开发备注:特殊Hack、技术债务、待确认项(标记 [待确认]`)。