diff --git a/likei-dev-skill/SKILL.md b/likei-dev-skill/SKILL.md
index b67406b1..fcbb64ee 100644
--- a/likei-dev-skill/SKILL.md
+++ b/likei-dev-skill/SKILL.md
@@ -20,6 +20,8 @@ description: Likei Services 项目开发 Skill。接到任何功能需求、Bug
 
 **循环终止条件**：git diff review 所有文件均无逻辑漏洞、无原逻辑改动、无字段错误、无 NPE 风险。
 
+> **数据库变更规则**：设计方案中若涉及 MySQL 表结构变更（新增字段、修改索引等）或 MongoDB 索引变更，必须在方案里直接给出可执行的 SQL / MongoDB Shell 语句，不能只描述变更内容。
+
 ---
 
 ## 第一步：读文件（禁止跳过）
@@ -172,6 +174,11 @@ D:\datasource\git\bin\git.exe -C D:\workspace\likei-services push origin {branch
 & 'D:\datasource\git\bin\git.exe' -C 'D:\workspace\likei-services' commit -m 'message in english'
 ```
 
+> commit 后 PowerShell 输出不稳定，**不能直接从 commit 输出中读取 hash**。commit 完成后立即用以下命令确认：
+> ```cmd
+> D:\datasource\git\bin\git.exe -C D:\workspace\likei-services log --oneline -1
+> ```
+
 ### commit message 规范（英文，禁止中文）
 | 类型 | 格式 |
 |------|------|
@@ -255,8 +262,9 @@ D:\datasource\git\bin\git.exe -C D:\workspace\likei-services push origin {branch
 
 ## 附：常见问题处理
 
-### edit_file 遇到编码匹配失败
-改用 `Desktop Commander:write_file` 直接覆盖整个文件（rewrite 模式），超过 30 行时分块写入。
+### 新建文件 vs 编辑文件
+- **新建文件**：必须用 `Filesystem:write_file`，`edit_file` 只能操作已存在的文件，对新路径会报 ENOENT。
+- **编辑已有文件**：优先用 `Filesystem:edit_file`；遇到编码匹配失败时改用 `Desktop Commander:write_file`（rewrite 模式，超过 30 行分块写入）。
 
 ### git commit 中文 message 报错（cmd 下空格或中文被拆分为多个参数）
 必须切换到 PowerShell，用单引号包裹：