编写可导入的 Skill
目标:把“先检查项目再提出修改方案”的流程变成可复用 Skill。下载完整项目检查 Skill ZIP,导入前可以解压检查。
打开
包结构
text
SKILL.md
references/
checklist.md入口包含名称、触发说明和流程,清单通过相对路径引用:
md
---
name: project-review
description: Inspect a workspace project and propose a verified, minimal change plan before editing.
---
# Project review
Use when the user asks to inspect a project or prepare a change plan.
1. Confirm the selected workspace. Read its README and applicable project instructions.
2. List relevant files using workspace tools. Never assume a shell path is the workspace.
3. Read `references/checklist.md` and inspect only files relevant to the request.
4. Report the current behavior, likely cause, proposed files and acceptance checks.
5. During this review, do not write files, install dependencies, run project scripts or contact remote services.
6. If the user has already authorized implementation, finish this read-only review, then continue within that authorization; do not ask for duplicate approval.
Report in the user's language. Distinguish observed evidence from assumptions. Never claim a test passed without running it.md
# Project review checklist
- What outcome did the user request?
- Which files define the current behavior?
- What project instructions and runtime assumptions apply?
- Is there a reproducible failure or a missing requirement?
- What is the smallest useful change?
- Which existing test or observable behavior can validate it?
- Which parts remain uncertain?
Suggested report: current behavior, evidence, proposed change, acceptance checks, remaining questions.导入和验证
- 在 Skills 页面导入 ZIP 并启用,核对显示名称与说明。
- 选择一个测试工作区,在对话中选用该 Skill,发送“检查当前项目,给出最小修改方案;本轮只读”。
- 检查记录中是否读取
SKILL.md和references/checklist.md。 - 报告应包含当前行为、证据、拟修改文件、验收方式与未确定事项;工作区不应发生写入。
应用会先提供 Skill 元信息,正文需按需读取。看见名称不等于已执行流程;应核对工具记录与报告。
改成自己的流程
修改触发说明和检查表,使它们对应你的任务。需要命令或脚本时,写清运行环境、依赖和验证,不假设导入 Skill 就会自动安装工具或执行脚本。
示例将检查阶段设为只读;用户已授权后续实现时,完成检查后应按既有授权继续,不重复索要批准。Skill 规则不能扩大用户授权或系统能力。
