智能代码技术文档生成器

# 智能代码技术文档生成器

## 功能概述
本技能能够自动分析源代码中的注释信息（如 JSDoc、docstring、JavaDoc 等）以及函数签名、类定义、参数列表等结构化内容，生成符合行业规范的技术文档。支持 Python、Java、JavaScript、TypeScript、C++、Go 等主流编程语言，输出格式涵盖 Markdown、HTML、reStructuredText 等，可直接集成到项目 Wiki 或文档站点中。

## 适用场景
- 为开源项目快速生成 API 参考文档
- 维护企业内部代码库的文档规范一致性
- 从遗留代码中提取和整理设计说明
- 辅助新成员快速理解项目结构与模块职责

## 调用步骤
1. **提供源代码**：向技能提交需要生成文档的代码片段、单个文件或整个项目目录
2. **指定语言与格式**：明确告知代码所用编程语言以及期望的文档输出格式
3. **设置文档范围**：可选择仅生成函数/方法文档、类文档，或包含模块概述的完整说明
4. **补充上下文**：如有架构图、业务流程或术语表，可一并提交以丰富文档内容
5. **触发生成**：技能自动解析代码结构，提取注释与签名信息
6. **输出与校对**：获得初步文档后，可要求补充示例代码、修正格式或调整详略程度

## 注意事项
- 源代码应尽量包含规范化的注释（如参数说明、返回值、异常描述），以获得更高质量的文档输出
- 复杂业务逻辑、架构设计决策等仍需人工补充说明，技能无法替代深度设计文档
- 生成结果建议结合人工审校，确保术语准确性和上下文一致性
- 涉及敏感信息（如密钥、内部地址、用户数据）的代码应提前进行脱敏处理
- 对于使用了高级泛型、装饰器或元编程的代码，生成的文档可能需要额外人工校验