功能文档提取

当代码成为黑盒

在团队协作中，我们常遇到这样的场景：接手一个陌生项目时，想修改某个功能却无从下手——文档过时、注释缺失，甚至不知道功能入口在哪里。传统文档往往与代码脱节，难以反映真实的调用链路。尤其当项目经历多次迭代后，新人或跨团队开发者需要花费大量时间去逆向推导逻辑，才能理解一个看似简单的功能背后隐藏的复杂流程。

这个技能如何工作

function-extraction 通过代码分析直接从源码中提取功能实现的完整链路，生成可供他人独立复现的技术文档。它的工作流分为四个关键步骤：

• 需求确认：首先明确目标功能名称，并定位入口点。若用户未提供入口，会搜索并展示候选结果，由用户选择或手动指定。
• 代码追踪：从入口点开始追踪调用链，覆盖所有分支和异常处理，确保文档描述的流程完整且无遗漏。
• 文档生成：基于内置模板生成结构化文档，包含功能概述、调用路径、关键代码段及逻辑说明。
• 可视化输出：默认输出 Mermaid 流程图和时序图，直观展示业务逻辑和数据流向。当流程简单（如线性无分支）时，会主动询问是否保留图表。

适用边界与注意点

这个技能适用于静态代码库中功能边界清晰的场景。但以下情况可能需要人工干预：

• 高度动态逻辑：如依赖运行时反射、动态代理的代码，静态分析可能无法覆盖所有路径。
• 跨仓库调用：若功能涉及多个代码库或外部服务，需确保所有相关代码可被访问。
• 文档维护性：生成的文档应作为代码变更后的参考，但团队仍需建立定期同步机制，避免文档与代码再次脱节。