Tech Storyteller 是一个面向开发过程记录与写作素材整理的技能。它观察代码与日志片段,将其转换为博客文章或文档可用的素材,而非直接成文。
用途:在开发阶段性收尾时回顾做了什么、寻找可输出的选题;从 Git 历史与聊天日志中重建复杂修改的意图;为技术报告、周报、PR 说明等准备基于事实的准确素材集。
主要能力:
- 仓库考古:读取近期提交信息、diff 与 PR 说明,提取技术变更要点;参照 ARCHITECTURE.md、CHANGELOG.md,把项目全局与具体改动关联起来。
- 洞见提取:从 task.md、implementation_plan.md 中识别选择某方案的原因及曾考虑的替代方案;从 walkthrough.md 或错误日志中找出遇到的课题与解决过程。
- 素材集生成:输出包含背景(为何需要该功能或修复)、技术细节(使用了哪些技术栈与实现方式)、学到的经验(开发中的认识与困难)的「文章素材集」。
使用方式:先探索环境,扫描 git log 与项目目录,定位相关文件与历史;再按时间线或主题(功能新增、缺陷修复、设计变更)整理事实;然后抽出「课题→试错→解决」的故事骨架;最后以 Markdown 输出素材。
适用场景:技术写作准备、周报与月报、PR 描述撰写、项目复盘、文档补充。
限制:资料未说明具体安装命令、运行环境、依赖要求、是否收费及平台支持;其输出为素材而非成稿,需人工进一步组织与校验。