dev-history-guide
开发历史面试文档生成——基于 git 时间线 + opencode/DSH 开发会话,生成结构化面试文档(时间线/关键决策/技术拷打点/八股/踩坑)。用户说"生成开发历史面试文档"、"这个项目开发过程有什么坑"、"开发选型为什么这么定"时使用
- License 许可
- MIT
- 最近更新
- 2026-09-21
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- dev-history-guide
- description
- 开发历史面试文档生成——基于 git 时间线 + opencode/DSH 开发会话,生成结构化面试文档(时间线/关键决策/技术拷打点/八股/踩坑)。用户说"生成开发历史面试文档"、"这个项目开发过程有什么坑"、"开发选型为什么这么定"时使用
02 资源文件 1
- 参考文档guide-template.md1.8 KB
03 SKILL.md 正文
dev-history-guide:开发历史面试文档(可移植 skill 包)
纯提示词零依赖——任何 agent(Claude Code / Codex / DSH / OpenCode)加载后用自己的能力执行。 数据源:git 历史(时间线)+ opencode 会话库(开发过程记录)+ DSH 会话(补充)。
何时使用
- "生成开发历史面试文档"
- "这个项目开发过程有什么坑 / 关键决策是什么"
- "为什么选这个技术 / 当时怎么定的"
使用流程
- git 时间线:
git log --oneline --format='%h %ad %s' --date=short(或等价只读命令)——还原开发阶段/里程碑 - opencode 会话:读
~/.local/share/opencode/opencode.db(SQLite,readOnly)——session/message/part 表,提炼开发过程的问题/决策/选型 - DSH 会话:读
~/.dsh/sessions/(如为压缩格式,解压后读元数据;消息不在文件内时诚实标注"元数据级") - 生成文档:按下方模板生成 → 存档
output/dev-history-guides/开发历史面试文档.md - 多轮反馈:用户指定阶段/主题 → 读对应历史 → 补充
三条红线(必须遵守)
- 只读:opencode.db 用 readOnly 打开;git 只用 log/status 类只读命令;不写任何历史数据(只写文档到 output/)
- 不读凭据:opencode 只查 session/message/part 表(credential/account 表不碰);DSH 不读
.credentials.yaml/ auth.json - 截断诚实:大会话/大结果返回 truncated 标记;文档末尾标注覆盖范围(完整/部分/未覆盖)
文档模板(5 段)
见 guide-template.md——时间线 / 关键决策(含"为什么")/ 技术拷打点(含文件:行号)/ 相关八股(含"本项目怎么用")/ 踩坑清单。
04 同仓库更多 Skills
md-only-skill
纯声明式技能(只有 SKILL.md,无 skill.mjs)——验证声明技能注入
good-skill
测试用正常插件(SKILL.md 与 skill.mjs 合并验证)
tech-compare
技术选型对比讲解(React vs Vue、Vite vs Webpack、微前端方案等),用统一对比框架防止讲偏。用户问"XX 和 XX 哪个好/区别"时使用
resume-coach
简历优化建议(亮点/风险/量化改进/面试预设问题)。用户贴出简历或问"我的简历怎么样/怎么改"时调用 skill__resume-coach__review_resume
project-guide
项目面试讲解指南生成——基于真实源码生成 7 段结构化讲解指南(定位/选型/架构/亮点/问题清单/防御/简历 bullet)。用户说"生成 XX 项目的面试讲解指南"、"我的项目怎么讲"、"帮我准备项目介绍"时使用
project-eval
项目全面评估报告生成——基于真实源码生成全面评估报告(8 维度评估 + 问题清单 + Top 5 改进——强化:分步评估 + 打磨循环)。用户说"评估 XX 项目 / 全面评估一下项目"时使用。