hproof/feature-analyzer

对指定功能或系统进行跨模块分析，追踪其在多个模块中的实现和交互。

定位：跨模块功能分析。 关注功能如何跨越模块边界，识别调用链、数据流和模块间依赖关系。 与 module 的区别：module 深入单个模块内部，feature 横向追踪跨模块的功能实现。

输入参数

本 Skill 接收以下参数（由 analyst agent 传递）：

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | scope | string | 是 | 功能名称或主路径（如"子弹系统"或"./src/bullet"） | | output_file | string | 是 | 输出文件路径，由调用方指定 | | key_modules | string[] | 否 | 用户指定的关键模块路径，优先分析 | | notes | string | 否 | 用户指定的重点关注事项 |

工作流程

1. 开始执行

   • 输出：[feature-analyzer] 开始执行功能分析，scope=${scope}, output=${output_file}

2. 功能边界识别

   • 从 scope 和上下文识别功能名称（如"子弹系统"、"战斗初始化"）
   • 如 scope 是路径，自动发现该路径下与功能相关的代码
   • 如 scope 是功能名称，通过 Grep 搜索功能关键词定位相关文件和模块

3. 功能入口识别

   • 搜索功能相关的公开接口、事件监听、初始化函数
   • 识别功能的主要触发点和对外暴露的 API
   • 记录入口点的模块归属

4. 跨模块调用链追踪

   • 从入口开始，使用 Grep 追踪函数调用链
   • 记录调用链跨越的模块边界，标注每个模块的职责
   • 识别核心中转点和关键交互

5. 数据流分析

   • 识别功能涉及的核心数据结构（配置、状态、事件等）
   • 追踪数据如何在模块间传递和转换
   • 标注数据的生产者、消费者和转换点

6. 模块职责归纳

   • 汇总每个参与模块在功能中的角色
   • 分析模块间的依赖方向和耦合程度

7. 汇总功能级架构健康度评估

   • 按照以下维度评估跨模块功能的健康度：职责清晰度、调用链清晰度、数据流合理性、耦合度、扩展性
   • 识别跨模块调用中的问题：循环依赖、过度耦合、职责模糊
   • 使用 🟢🟡🔴 统计问题严重程度
   • 准备架构健康度快照

8. 生成分析报告（强制执行）

   警告：必须严格遵循以下模板结构，不得自由发挥。任何偏离模板的行为都是错误的。

   要求：

   • 必须使用 Write 工具将完整文档写入 output_file
   • 必须包含完整的 frontmatter（YAML 头部）
   • 必须包含导航表格和章节间导航链接
   • 必须严格按照模板的 6 个章节顺序输出
   • 代码链接必须使用 [📄 描述](路径#L行号) 格式
   • 状态指示必须使用 🟢🟡🔴

   模板文件：${CLAUDE_PLUGIN_ROOT}/docs/templates/feature-analyzer-template.md

   • 使用 Read 读取模板文件，复制其内容，填充变量后使用 Write 工具写入 output_file