add README guidance to skill workflow

2026-07-29 21:08:04 +08:00
parent 262c138bee
commit e667f58bf1
9 changed files with 380 additions and 7 deletions
@@ -38,15 +38,16 @@ skiff add <name> -a cursor -a claude -a codex -y
 skiff create <name> --idea "<用户原始想法>" --from-project .
 ```

-4. 编辑 `~/.skills/.drafts/<name>/SKILL.md`，完善触发条件、不适用场景、步骤、边界与验证方法。仅在确有必要时增加 `references/`、`scripts/` 或 `assets/`。
-5. 不要把项目专属路径、私有业务规则、一次性命令或密钥复制到通用 skill。
-6. 运行校验并修复所有问题：
+4. 编辑 `~/.skills/.drafts/<name>/SKILL.md`，完善触发条件、不适用场景、步骤、边界与验证方法。
+5. 编辑同目录的 `README.md`，用面向人类的语言说明用途、准备事项、可直接复制的请求示例、Agent 会做什么以及如何判断完成。README 不应复述 Agent 内部指令。
+6. 仅在确有必要时增加 `references/`、`scripts/` 或 `assets/`。不要把项目专属路径、私有业务规则、一次性命令或密钥复制到通用 skill。
+7. 运行校验并修复所有问题：

 ```bash
 skiff check <name>
 ```

-7. 向用户展示名称、description、核心步骤和验证方式。获得确认后再转正：
+8. 向用户展示名称、description、README 的人类使用方式、核心步骤和验证方式。获得确认后再转正：

 ```bash
 skiff finalize <name>