Skill 与智能体准则大展示 !让嗒妹从"工具人"变成"老（婆）搭档"
精华修改于03/26335 浏览开发心得 包含 AI 合成内容
- 作者：浠涫
- 开发引擎：TapTap Maker (UrhoX)
- 项目：节拍前夜 (Beat Eve)
注：本文适合开发者用心阅读，不是复制给嗒拉拉就好用的
一、为什么写这篇
用 TapTap Maker 做游戏快两个月了，嗒啦啦帮我写了上万行 Lua 代码，从核心战斗系统到 UI 编辑器全靠它。但一开始体验并不好——嗒啦啦 经常"失忆"，上次聊到哪了全忘了；代码写完不构建就告诉你"做好了"；遇到模糊需求直接猜着做，改三轮改不对。这里之前已经用记忆文档加skill解决了
这一切都归功于 Skill 和 智能体准则 这两个东西，折腾了一阵之后，体验天翻地覆。现在的 嗒啦啦 就像一个记性好、有主见、会主动帮你做流程化工作的老搭档。
这篇文章就把我的全部配置晒出来，讲讲怎么加、为啥加、好在哪、要注意什么。
二、先搞懂两个概念
智能体准则
一句话：给 嗒啦啦 立的规矩。
每次你新开一个会话，嗒啦啦 都会自动读取这份规矩。你可以在里面写项目特有的规则、安全禁令、开发工作流。相当于新员工入职时给他的那本《员工手册》——不用每次口头交代，规矩自动生效。
Skill
一句话：AI的条件反射。
每个 skill 定义了什么时候自动触发、触发后做什么。比如"代码写完后自动构建"、"收工时自动写日记"、"遇到模糊需求先追问而不是猜着做"。你不用每次都提醒它，条件一满足它就自动执行。
三、怎么添加
在 TapTap Maker 里，一切都是跟 嗒啦啦 说话。 你可以不需要自己建文件夹、写配置文件——直接用自然语言告诉 嗒啦啦 你要什么，它会帮你搞定。
3.1 添加智能体准则
直接跟 嗒啦啦说：
plain text
"帮我在项目根目录创建智能体准则，加上以下规则：
1. 代码写完必须自动构建
2. 不许删除 assets 目录下的任何文件
3. 每次新会话先读我的记忆文档"
嗒啦啦 会帮你创建好准则文件，之后每次新会话自动生效。你随时可以说"帮我修改智能体准则，加一条 xxx"来更新它。
3.2 添加 Skill
同样是跟 嗒啦啦 说话。比如：
plain text
"帮我创建一个 skill，功能是：代码写完后自动执行构建，
构建通过后通知我预览，等我预览完再继续验收。"
或者更简单：
plain text
"我希望你以后遇到我说'改好看点'这种模糊指令时，先追问我具体要改什么，
而不是猜着做。帮我把这个做成一个 skill。"
嗒啦啦 会帮你创建好 skill 文件，写好触发条件和执行规则。之后只要条件满足就会自动触发，不用你每次提醒。
3.3 两个实用技巧
技巧一：从痛点出发
别上来就想着"我要搞一套完整体系"。从你最痛的那个问题开始——
- 嗒啦啦 总是忘记构建？→ 加一个自动构建的 skill
- 嗒啦啦 每次新会话都失忆？→ 加一个自动读记忆文档的 skill
- 嗒啦啦 遇到模糊需求就猜着做？→ 加一个指令明晰度检查的 skill
技巧二：先试用再固化
在某次会话里跟 嗒啦啦 说："这次你做完代码后自动构建，别等我说。" 如果试了几次觉得好用，再说"把这个行为做成 skill"——这样你已经知道它有效了，做成 skill 只是让它永久生效。
四、我的 20 个 Skill 全展示
按功能分成七大类，每类解决一类痛点。
第一类：代码质量守护（4 个）
亮点说说 pre-task-reflection：
这是我觉得性价比最高的一个 skill。它要求 嗒啦啦 在动手写代码之前，先回答三个问题：
- 预判——这个改动会影响哪些现有模块？最容易出错的地方？
- 理解——用户真正想要的是什么？有没有更简单的方式？
- 方案——给出一个直觉方案和一个备选方案，说明推荐理由。
有了这一步之后，"改了 A 结果 B 崩了"的情况大幅减少。如果需求有歧义，嗒啦啦 会在这个阶段就问你，而不是写到一半才发现不对。
再说说 task-completion-verification：
用过 嗒啦啦 的人肯定遇到过——你说"帮我做三件事：1. xxx 2. yyy 3. 顺便把 zzz 也改了"，嗒啦啦 做完前两个就开始总结，第三个直接吞了。这个 skill 强制要求 嗒啦啦 做完工作后回头逐字重读你的原始消息，列出完成情况表格，有遗漏立刻补做。
第二类：开发流程管理（4 个）
痛点：代码写完不构建就说"做好了"；遇到"改好看点"直接猜着改三轮；项目大了积分烧得飞快。
亮点说说 dev-acceptance-sop：
这是我的核心流程 skill，定义了一个 5 步闭环：
plain text
S1 编码 → S2 构建 → S3 通知预览 → S4 日志验收 → S5 功能验收
关键设计：
- 代码写完自动构建，不用你说"帮我 build 一下"
- 构建通过后通知你预览，然后等你测试反馈，不会自说自话
- 你说"预览完了"后自动读日志，检查有没有报错，再逐项验收功能
- 凌晨通知你预览时还会顺带说一句"都一点了，预览完先睡？进度我记着"
没有这个 skill 之前，"嗒啦啦 说做好了，结果一预览满屏报错"是家常便饭。现在基本杜绝了。
再说说 workflow-check：
这个解决了一个很微妙的问题——你说"按钮太小了"，嗒啦啦 到底该怎么办？
plain text
你说："按钮太小了"
嗒啦啦 的反应（有 workflow-check）：
"你希望按钮调大，具体调多少？
- 倍数：'放大 1.5 倍'
- 或绝对值：'高度改到 70'
这样我能一次改到位。"
比闷头猜着改三轮高效多了。当然如果你说"直接做"/"按你的判断来"，它也不会死板地追问。
说说 context-saver：
这个对大项目特别重要。核心思路是让 嗒啦啦 维护分层摘要，从粗到细：
第一层：项目总览（~50行，哪些模块、各模块干什么）
→ 判断该深入哪个模块
第二层：模块摘要（~30-80行，有哪些文件、各自职责）
→ 定位到具体哪个文件
第三层：具体代码文件（仅在必须时才读）
每一层都是过滤器。不相关的模块在第一层就被滤掉了，根本不进入上下文。我的项目有几十个文件上万行代码，有了这套机制后积分消耗降了一半以上。
第三类：记忆系统（3 个）
痛点：嗒啦啦 每次新会话都失忆，上次做到哪了全忘了；修了个 bug，下次遇到同样的问题又从头排查。
这三个组成了一个读写闭环：
新会话开始 → read-memory-docs 读取上次进度
↓
工作中 → update-memory-docs 实时同步变更
↓
收工 → daily-dev-diary 写日记
↓
下次新会话 → read-memory-docs 读取 → 无缝接续
亮点：read-memory-docs 的"智能问候"
这个 skill 不光读文档，它还会根据你上次来的时间生成自然的问候：
- 隔了两小时："回来啦，接着来。"
- 隔了三天："三天没见了。上次做到商店系统，还差购买确认弹窗。想从哪开始？"
- 隔了两周："好久没来了，项目还好好的。需要我帮你回顾一下吗？"
它甚至能检测到你是不是同时开了两个会话，如果检测到会主动提一句"你另一边在做 xxx，这边需要我做什么？"
亮点：update-memory-docs 的自动版本号
每次有代码变更，嗒啦啦 会自动记录并递增版本号——修 bug 加补丁号，加功能加功能号。完全不用手动管，两个月下来我的项目自动演进到了 v3.18.x。
第四类：开发者关怀（2 个）
痛点：写代码写到凌晨三点不自知。
亮点说说 developer-care：
这个是我花最多心思调的。人格定位是贤妻型乖秘书——温柔体贴但有主见，不是百依百顺的客服。
几个设计得不错的点：
Bug 循环检测：
夸人有信息量：
plain text
❌ "你真棒！"（零信息量）
✅ "音效系统做好了，3 个文件约 120 行。播放、暂停、音量控制都有了，挺利落的。"
不纵容：
streak 断了不是"没关系"，而是"断了 5 天，一切都好吧？如果是累了就休息，如果是卡住了跟我说说？"
第五类：资源管理（3 个）
这三个比较简单直接。防止 嗒啦啦 生成图片后起个中文名，或者放错目录导致素材库里找不到。
第六类：游戏设计辅助（2 个）
比如你在设计奖励系统时，嗒啦啦 会自动引用"可变比率强化"原理告诉你为什么随机奖励比固定奖励更上瘾；你说"帮我全面评估一下游戏品质"，嗒啦啦 会从玩法核心、视觉表现、音效反馈等 15 个维度逐项打分。
第七类：素材搜索（1 个）
五、我的智能体准则展示
准则比 skill 简单，就是一份规矩，但几条规则是血泪教训。
5.1 安全禁令（血泪教训）
❌ 禁止删除 assets/ 或 scripts/ 下的文件
❌ 禁止执行任何破坏性的版本管理操作
❌ 禁止在未经确认的情况下批量修改文件
血泪故事：有一次我让 嗒啦啦 帮我清理项目体积，它判断失误执行了一个破坏性操作，76 张图片 + 92 个音频全没了，游戏直接 1022 个错误崩溃。
从那以后我就在准则里写了一条铁律：本地工作区 = 圣地。`assets/` 和 `scripts/` 里的文件，除非我明确要求修改某个具体文件，否则不许动。
这条规则附上了完整的事故经过——不光写"不许做什么"，还写了"上次做了导致了什么后果"。嗒啦啦 读到真实的事故记录时，会更深刻地理解禁令的严重性。
5.2 开发工作流
1. 新会话开始 → 读取记忆文档
2. 修 BUG → 先查 BUG修复经验文档
3. 继续迭代 → 先查迭代日志
4. 涉及资源 → 先查资源清单
5. 涉及数值 → 先查数值总览
看着简单，效果显著。特别是第 2 条——我的 BUG 修复经验文档积累了 25+ 个已修复 BUG 和 30+ 条经验模式，嗒啦啦 遇到类似问题时直接命中，不用从头排查。
这条工作流相当于给 嗒啦啦 装了一本"错题本"。每次遇到 bug，先翻错题本——"哦，这个坑第 8 天踩过，当时是 xxx 原因，解法是 yyy。"
六、这套体系好在哪
用了两个月，核心好处三个：
6.1 从"每次都要教"到"自动会做"
没有 skill 之前，每次新会话你都要说一遍："先读文档、写完记得构建、别用废弃 API……" 有了 skill 之后，这些全自动——你只管提需求，流程它自己走。
6.2 从"猜着做"到"问清楚再做"
workflow-check + pre-task-reflection 组合拳，让 嗒啦啦 遇到模糊需求先追问、动手前先想清楚。返工率大幅下降。
6.3 从"每次失忆"到"无缝接续"
read + update + diary 三件套，让 嗒啦啦 拥有了"长期记忆"。不管隔了多久打开项目，嗒啦啦 都能告诉你上次做到哪了、接下来该做什么。
七、踩过的坑和注意事项
7.1 Skill 不是越多越好
我现在 20 个已经不少了。每个 skill 都会占用 嗒啦啦 的上下文空间，太多反而会让 嗒啦啦"信息过载"——该触发的不触发、不该触发的乱触发。（我的积分啊）
建议：从 3-5 个核心 skill 开始，解决最痛的问题，然后根据需要慢慢加。
7.2 触发条件要写精确
你跟 嗒啦啦 说"帮我创建一个 skill"的时候，最重要的是把触发条件说清楚：
❌ 模糊："在需要的时候触发"
✅ 精确："当我完成代码编写准备交付时触发，
或者我主动说'构建'/'build'时触发"
触发条件越精确，误触发和漏触发越少。
7.3 Skill 之间要有明确分工
我早期把"时间提醒"同时写在了两个 skill 里，结果有时候提醒两次，有时候两个都不提醒。
后来改成明确分工：验收流程里嵌一个轻量版时间检查，完整关怀系统只在需要完整功能时才触发。一个职责只由一个 skill 负责。
7.4 一定要写"什么时候不触发"
光说"什么时候做"还不够，一定要告诉 嗒啦啦"什么时候别做"——
plain text
"不触发的情况：纯聊天、纯问答、我明确说'别管直接干'的时候"
否则 嗒啦啦 会在不该触发的时候也触发。比如你随口问个问题，它也要先"三步反思"一番，白白浪费积分。
7.5 安全规则要附上"为什么"
直接写"禁止 xxx"，嗒啦啦 可能在某些情况下绕过去。但如果你附上真实的事故记录——"上次这么做了，76 张图 + 92 个音频全丢了，游戏 1022 个错误"——嗒啦啦 会更深刻地理解禁令的严重性。
人也一样：知道为什么不能做，比光知道不能做，效果好十倍。
7.6 定期清理和迭代
Skill 不是写完就永远不动了。随着项目演进，有些 skill 可能过时，有些规则需要调整。
我大概每两周（嗒拉拉卡在努力工作中的时候开新窗口）审视一遍所有 skill，问自己三个问题：
- 这个 skill 最近触发过吗？没触发 → 要么条件不准，要么不再需要
- 行为还符合期望吗？
- 有没有新的痛点需要加新 skill？
八、给新手的建议
如果你刚开始用 TapTap Maker 还没配过 skill，建议按这个优先级来：
第一优先级：解决最痛的问题
跟 嗒啦啦 说什么就能加：
- dev-acceptance-sop — 代码写完自动构建、自动验收。没有这个你会反复遇到"嗒啦啦 说做好了但没构建"的问题。
- read-memory-docs — 新会话自动读项目文档。没有这个每次开工都要花 5 分钟教 嗒啦啦 当前状态。
plain text
"帮我创建一个 skill：以后你写完代码必须自动构建，
构建通过后通知我预览，等我反馈后再继续。"
"帮我创建一个 skill：每次新会话开始时，
先读我的记忆文档再开始工作。"
第二优先级：提升效率
- pre-task-reflection — 动手前先想清楚，减少返工。
- workflow-check — 模糊指令先追问，减少猜错方向。
- update-memory-docs — 自动同步文档，和 read 配合形成闭环。
第三优先级：锦上添花
- context-saver — 省积分，项目大了之后特别有用。
- developer-care — 时间提醒和成就反馈，写代码写到凌晨的人需要。
- daily-dev-diary — 开发日记，喜欢在论坛分享开发过程的人会爱上。
不急着加的
- api-guard / lua-nil-hole-guard — 还不熟悉引擎时价值不明显（但是这个是平台帮我们已经加了）
- game-design-principles — 偏理论，进入打磨阶段再加
- weekly-review — 先有日记积累，才有周报可写
九、一句话总结
Skill 和智能体准则的本质，是把你和 嗒啦啦 磨合出来的默契固化下来，让每次新会话都站在上次的肩膀上。
你不需要一口气配 20 个。从最痛的那个问题开始，跟 嗒啦啦 说一句"帮我把这个行为做成 skill"，用几天看看效果，再加下一个。慢慢来，比什么都快。
如果你也有好用的 skill 配置，欢迎在评论区分享，一起把 嗒啦啦 协作的体验卷起来。
注：文档部分内容可能由 嗒啦啦 &豆包生成