霍格沃兹测试开发学社
07-20 · 北京测吧
给AI写一份“岗位操作手册”(二)
二、收材料:AI 的行业知识,全靠你喂想象一下,你那个 P7 空降到团队,你总得给他交接资料吧——代码规范、架构图、数据库字典、核心链路时序图、最常踩的坑列表。Skill 也是一样。SKILL.md 里只有指令是不够的,你得把“公司内部资料”打包塞进文件夹。我现在的标准操作是建一个 references/ 子目录,里面扔这些东西:code-style.md —— 团队编码规范(别扔个阿里巴巴手册 PDF 进去,把跟咱们切实相关的几条摘出来)architecture.md —— 系统分层说明,哪个包放什么,别让他把 Service 写到 Controller 层去db-dict.md —— 核心表的字段注释、索引说明,特别是那些命名鬼才起的字段名,比如 is_del 明明叫 deleted_atpitfalls.md —— 历史故障复盘,哪些写法已经搞出过生产事故,禁止再次出现examples/ —— 放两三个高质量的接口实现样例,正面案例比一百条规则都好使这些资料一挂载,AI 就从一个通用大脑变成了你们项目的专用外挂。我曾经把支付模块历次因为“状态机并发”导致的故障复盘扔进去,后来让它生成新接口时,它自动在关键状态变更处加上了乐观锁注释和推荐写法,这意识已经超越了一半的组员。三、动笔写手册:一套即插即用的模板到了重头戏。下面这个模板是我打磨了很久的,你可以直接复制走,把方括号里的内容换成你的。
发布于 辽宁
分享
评论
未登录
友善发言
image-upload
评论
加载中