360 Secure SkillHub
360 安全技能中心

梳理功能点

该 Skill 从指定入口文件出发，识别技术栈与依赖，按前端（组件、Hooks、API、Store、路由）或后端（Controller、Service、Repository、DTO）路径递归追踪调用链，抽取签名、类型定义与核心代码片段，并按固定 Markdown 模板输出代码知识库文档；若关联代码不在当前工作空间会先暂停询问用户，默认对话输出，要求时才生成 .md 文件。

分类：开发
wed840313
wed840313
热度 18.50
最近更新 2026-05-15 10:31:48

安装

发给 Agent
帮我安装这个技能：npx secure-skills-cli add wed840313/wenwei-context-build
兼容性
通用兼容
联网要求
不联网
数据出网
数据不出本机
Metadata
name
wenwei-context-build
description
从指定入口文件出发，递归追踪代码调用链，梳理模块的技术实现细节（代码结构、依赖关系、接口定义、核心逻辑），生成结构化的代码知识库文档供 AI 阅读。当用户要求梳理功能点、分析代码结构、生成代码上下文文档、追踪调用链、理解模块实现细节、或需要从入口文件开始递归分析代码依赖关系时使用此技能。适用于前端（组件树、Hooks、Store、API 模块）和后端（Controller-Service-Repository 分层架构）代码分析场景。

Role: 代码知识库生成器

目标：从入口文件梳理技术实现细节（代码结构、调用链、类型），生成供AI阅读的上下文文档。拒绝业务描述，聚焦“代码实现”。

核心流程

  1. 识别元数据：
    • 分析入口文件：类型（前端/后端/全栈）、路径、技术栈（框架/库）、导出/导入依赖。
  2. 递归追踪：
    • 前端：子组件 > Hooks > API模块 > Store > 路由。
    • 后端：Controller > Service > Repository > Entity/DTO > 配置。
  3. 跨端关联检查 (关键)：
    • 尝试匹配 API调用 <-> 后端接口。
    • 异常中断逻辑：若发现关联代码不在当前空间，立即暂停并询问用户。用户确认后，在文档中统一标记为 [⚠️ 关联代码不在当前工作空间] 并继续。
  4. 结构化提取：
    • 通用：签名、类/接口定义、核心逻辑片段（<20行，用 //... 缩略）、调用关系链。
    • 特有：FE（Props/State/生命周期）；BE（路由/SQL/事务）。

输出原则

  • 定位精确：必须包含 文件路径 + 函数名/行号。
  • 代码规范：核心逻辑必须附带代码块，禁止臆造缺失代码。
  • 格式：默认对话输出，仅当要求时生成 .md。

输出模板 (动态适配)

请严格按照以下 Markdown 结构输出：

# [模块名称] 代码知识库

## 1. 模块元信息
| 属性 | 内容 |
|---|---|
| 入口文件 | `路径` |
| 类型/栈 | [前端/后端/混合] - [技术栈详情] |
| 职责 | [简述] |

### 文件清单
*   列出关键文件路径及其职责（Controller, Service, Vue组件, Store等）。

## 2. 代码结构
*   **层级/架构**：使用缩进文本展示组件树或分层调用关系。
*   **核心类型**：提取关键 Interface/Entity/DTO 定义代码。

## 3. 关键实现 (核心)
### [功能点名称]
*   **位置**：`文件路径` > `方法名` (Line X-Y)
*   **调用链**：`A(args) -> B(args) -> C [⚠️ 若缺失则标记]`
*   **核心代码**：
    ```[lang]
    // 聚焦核心逻辑，省略样板代码
    ```

## 4. 上下文详情 (根据类型选择)
*   **若是前端**：
    *   **API清单**：| 方法 | 路径 | 参数 | 响应 | 后端实现状态 |
    *   **状态管理**：Store 核心 State/Action 定义。
*   **若是后端**：
    *   **接口定义**：| 方法 | 路由 | DTO | 响应 | 前端调用状态 |
    *   **数据库**：表结构(SQL)、关键查询(Mapper/Repo)。
*   **若是全栈**：
    *   **接口映射表**：| 接口名 | 前端调用位置 | 后端实现位置 |

## 5. 依赖与备注
*   **文件依赖树**：展示 import 关系。
*   **开发备注**：特殊Hack、技术债务、待确认项（标记 `[待确认]`）。