给AI写一份“岗位操作手册”——Skill编写的完整流程与模板

很多团队在引入AI辅助开发后，发现实际效果远不及预期——AI要么泛泛而谈、要么答非所问。深入分析会发现，问题的根源往往不在于模型能力不足，而在于我们没有给AI一份清晰的“岗位操作手册”。Skill作为AI技能的核心载体，其编写质量直接决定了AI输出的可靠程度。

明确职责边界：画出清晰的能力圈

Skill本质上是为AI配置的项目专用手册。与其期待AI能“善解人意”，不如把它当作一位刚入职的资深工程师，作为技术主管，你需要明确告诉他：什么时候该干什么、怎么干、用什么工具、底线在哪里。

构建参考资料库：让AI拥有领域知识

大多数Skill效果不佳的根源在于职责边界模糊。当你说“帮我写代码”时，AI可能会在周报、SQL、前端组件之间“精神分裂”。正确的做法是画一个极其明确的圈：Skill负责什么具体场景、输入输出格式是什么、绝对不能触碰的边界在哪里。建议列出三张清单——“必须做、可以做、严禁做”，这将成为Skill的宪法大纲。

标准化模板设计：即插即用的编写框架

仅有指令是不够的，还需要把“公司内部资料”打包进去。建立一个references/子目录，包含：团队编码规范、系统架构说明、数据库字典、历史故障复盘案例以及高质量代码样例。这些资料能让AI从通用大脑转变为项目专用外挂。当支付模块的历史故障案例被纳入后，AI在生成新接口时自动在关键状态变更处添加乐观锁——这种“意识”已经超越了不少初级工程师。

测试与版本管理：确保Skill持续可用

一个结构清晰的Skill模板应包含以下核心要素：角色定义、工作守则（用“必须”“严禁”等绝对性词汇）、上下文知识库引用、输出规范以及交互规则。模板中应避免“建议”“尽量”等模糊表述，所有规则都要细到可以无脑执行。同时，YAML头部的description字段必须精准描述激活场景，否则可能导致调度器在不该激活时调用该Skill。

如有侵权，请联系删除。