用途
tech-analysis-reporter 是一个供 Agent 使用的技术报告生成 Skill，用于通过多轮对话收集用户需求，分析项目，生成专业的技术分析报告。当用户说出“自媒体软件分析报告”“生成技术报告”“分析这个项目”“帮我写个技术分析”“了解一下这个开源项目”等语句时启动本 Skill。
主要能力
该 Skill 的核心能力包括：获取项目（GitHub 链接或本地绝对路径）、自动检测并确认项目类型、配置报告参数、多 Agent 协作生成章节、生成配图、执行 QA 质量验证、合并内容并转换输出格式。
项目类型检测依据：package.json + src/pages 或 routes 判定为 Web 应用；package.json + bin 字段判定为 CLI 工具；Python/Rust + 算法相关目录判定为算法库；大量配置 + 插件系统判定为框架/平台；Android/iOS 目录判定为移动端 App；data/db/query 相关判定为数据工具；无法识别则归为通用项目。
报告模板分为：A. 精简概览（3 章，约 3000 字，章节为概述 + 架构 + 亮点）；B. 标准分析（5 章，约 8000 字，章节为概述 + 架构 + 机制 + 生态 + 技术栈）；C. 深度剖析（7 章，约 12000 字，标准 5 章 + 性能 + 安全 + 未来展望）；D. 自定义（用户指定章节数量和主题）。
写作风格分为学术风、技术风、科普风、商业风。分析深度分为概述（30%，概念级讲解，无代码）、标准（60%，适度深入，少量伪代码）、专家（100%，深度剖析，真实代码 + 详细解释）。输出格式支持 Markdown、Word 文档（.docx）、PDF，可多选，多格式时打包为 zip。
使用方式
Skill 执行流程分为五个阶段。
Phase 1 项目获取：Agent 询问项目来源（GitHub 链接或本地项目路径），如为 GitHub 私有仓库则询问是否需要 Token，并通过 git clone --depth 1 <url> /tmp/analysis-repo 或 ls -la <path> 验证可用性。若遇私有仓库权限问题，提示用户提供 Personal Access Token 或将项目打包发送。
Phase 2 项目识别与确认：读取项目关键文件自动检测项目类型，并告知用户检测结果（项目类型、主要语言、核心模块、技术栈），等待用户确认或修正。
Phase 3 报告配置：询问报告模板、写作风格、分析深度与输出格式。
Phase 4 个性化配置：询问配图需求（每章 0-3 张）、特殊关注点（可选）、Word 字体偏好（仅 Word 输出时需要，标题字体可选黑体/微软雅黑/宋体，正文字体可选仿宋/宋体/微软雅黑）。配置完成后汇总确认，用户回复“开始”或“修改”。
Phase 5 执行生成：包括 Step 1 项目获取（git clone 或 cp -r 到 /tmp/analysis-repo）；Step 2 项目分析（读取 README.md、package.json / Cargo.toml / pyproject.toml、src/ 目录结构、docs/ 并提取关键信息）；Step 3 多 Agent 协作生成章节（PM 负责任务分配、进度监控、结果汇总，Writer-1 至 Writer-4 分别撰写各章，QA 负责质量验证，并通过共享白板 /tmp/analysis-shared-board.json 协调状态）；Step 4 生成配图（配置大于 0 张时，各 Writer Agent 使用 nano-banana-pro 生成 2K 配图，命令为 cd ~/clawd/skills/nano-banana-pro 后执行 uv run scripts/generate_image.py --prompt "..." --filename "/tmp/analysis/images/XX-topic.png" --resolution 2K）；Step 5 QA 质量验证（逐章验证内容准确性、完整性、风格符合度、流畅度、配图质量，标记 pass / need_fix，最多 3 轮迭代，仍不通过则标记为 warning 继续）；Step 6 合并与转换（合并 Markdown，使用 pandoc 转换 Word 或 PDF，多格式打包 zip）。
依赖检查包括 pandoc、python-docx、nano-banana-pro 脚本与 Git 是否可用，如有缺失告知用户安装方法。
输出文件结构为 /tmp/analysis-output/ 下的各章节 md 文件、images/ 目录、complete.md，以及可选的技术报告.docx 与技术报告.pdf。
适用场景
适合快速了解项目、常规技术评审、深度技术审计，以及需要多风格、多深度、多格式技术分析报告的场景。
限制
报告中关于收费、价格、平台、效果等具体信息暂未提供。项目类型识别可能失败，此时需用户手动说明项目类型与主要功能。项目克隆可能因私有仓库需要 Token、网络问题或仓库不存在而失败。共享白板访问冲突时，推荐通过 PM 中转所有写操作。QA 验证最多 3 轮迭代，仍不通过则标记为 warning 继续。