skill-laws

📁 steelan9199/wechat-publisher 📅 1 day ago
4
总安装量
4
周安装量
#50039
全站排名
安装命令
npx skills add https://github.com/steelan9199/wechat-publisher --skill skill-laws

Agent 安装分布

opencode 4
gemini-cli 4
github-copilot 4
codex 4
kimi-cli 4
amp 4

Skill 文档

Skill Laws(设计法则)

最高法则:所有 Skill 是 AI 的指令集,人类只说自然语言,AI 解析意图、调用 Skill、完成操作。


🎯 触发映射:用户说 → AI 做

用户输入触发词 AI 执行动作
“创建 skill” / “新建 skill” / “添加 skill” / “初始化 skill” 按【创建模式】执行
“优化 skill” / “skill 有问题” / “检查 skill” / “review skill” / “诊断 skill” 按【优化模式】执行
“这个 skill 怎么样” / “评估 skill” / “skill 设计得好吗” 按【评估模式】执行

创建模式

触发:用户要创建新 Skill

执行步骤

步骤 执行动作 具体命令/操作
1 确定 skill 目录名 使用格式 skill-{功能名},全小写,连字符分隔
2 创建目录结构 运行 mkdir -p .skills/{skill-name}/{references,scripts}
3 创建 SKILL.md 运行 Write 工具创建文件,路径:.skills/{skill-name}/SKILL.md
4 写入 frontmatter 复制下方模板,替换变量:{skill-name} {功能描述} {触发条件}
5 添加触发映射表 在 frontmatter 后添加“触发映射”区块
6 添加执行步骤 用表格列出步骤、动作、具体命令
7 检查核心法则 对照【核心法则检查表】逐项验证,全部通过才算完成
8 创建 references 如内容 > 500 行,将详细内容移到 references/ 目录

Frontmatter 模板

---
name: {skill-name}
description: {功能描述}。何时使用:当用户{说/需要/遇到}{触发条件}时。
metadata:
  author: "{作者名}"
  updated: "{YYYY-MM-DD HH:MM:SS}"
  version: "1.0.0"
---

核心法则检查表(创建时必须全部通过)

法则 检查标准 通过? 如果不通过
⭐⭐⭐ 人类中心 用户只需说自然语言,不需要手动操作文件或运行命令 ⬜ 添加 AI 执行步骤,删除用户手动操作
⭐⭐⭐ AI 优先 使用祈使句指令(运行/检查/调用/执行),表格展示决策逻辑 ⬜ 将”你可以…”改为”运行…”,长段落改为表格
⭐⭐⭐ 即调即用 顶部有”触发映射”区块,用户输入 → AI 动作一一对应 ⬜ 添加触发映射表
渐进披露 核心内容 < 500 行,详细内容放 references/ ⬜ 将超过 500 行的内容移到 references
错误处理 包含常见错误场景和处理方式表格 ⬜ 添加错误处理表格

错误处理

错误场景 错误表现 处理方式
目录已存在 mkdir 报错目录已存在 运行 LS 检查目录内容,如为空则继续,如有内容则询问用户是否覆盖
文件写入失败 Write 返回错误 检查路径是否正确,如路径含空格需用引号包裹,重试写入
变量未替换 SKILL.md 含 {skill-name} 等占位符 运行 SearchReplace 替换所有占位符为实际值
内容超过 500 行 SKILL.md 行数 > 500 将详细内容移到 references/ 目录,核心内容保留精简版

优化模式

触发:用户要优化现有 Skill 或指出 Skill 有问题

执行步骤

步骤 执行动作 具体命令
1 读取目标 Skill 运行 Read 工具读取 {skill-path}/SKILL.md
2 逐项检查 对照【核心法则检查表】和【文档规范检查表】逐项标记 ✅/❌
3 统计问题 统计 ❌ 项数量,按优先级排序(核心法则优先)
4 执行修复 运行 SearchReplace 或 Write 修复问题,参考【正反对照】
5 输出报告 按【优化报告模板】输出结果

文档规范检查表

检查项 符合标准 当前状态 修复命令
description 包含”何时使用:当用户说/需要/遇到…” ⬜ SearchReplace 添加触发条件
指令语气 使用祈使句(运行/检查/调用/执行) ⬜ SearchReplace “你可以”→”运行”
决策逻辑 复杂任务使用表格展示条件分支 ⬜ 将长段落改为条件表格
输出格式 明确说明执行后输出什么、如何展示 ⬜ 添加输出示例代码块
错误处理 包含错误场景和处理方式表格 ⬜ 添加错误处理表格
文件引用 使用 Markdown 链接格式 [名](路径) ⬜ SearchReplace 改为可点击链接
渐进披露 核心指令 < 500 行 ⬜ 将详细内容移到 references/
触发映射 顶部有”用户说 → AI 做”映射表 ⬜ 添加触发映射区块

正反对照(快速修复参考)

❌ 错误示例 ✅ 正确示例 修复操作
“你可以运行…” “运行…” SearchReplace 删除”你可以”
“建议检查…” “检查…” SearchReplace 删除”建议”
“如果需要可以…” “如果 X 则执行 Y” 改为条件表格
“请参考文档了解详情” “参考 文件名 执行…” SearchReplace 添加链接
长段落描述 表格/列表 + 具体命令 重构为表格格式
“确保 xxx” “运行 命令 检查 xxx” 添加具体检查命令

错误处理

错误场景 错误表现 处理方式
文件不存在 Read 报错文件不存在 检查路径是否正确,如 skill-name 拼写错误,询问用户正确名称
无问题可优化 所有检查项都是 ✅ 输出”该 Skill 已符合所有法则,无需优化”,按【评估模式】输出评估报告
修复后引入新问题 修复 A 问题导致 B 问题 回滚更改,分步修复,每步修复后重新检查
用户不认可修复 用户说”不要改这个” 记录用户反馈,跳过该项,继续优化其他项

优化报告模板

## 优化报告:{skill-name}

**评分**:{通过数}/13 项符合(核心法则 5 项 + 文档规范 8 项)

### 主要问题

1. {问题描述}
   - 修复操作:{具体操作}
   - 使用工具:{Read/SearchReplace/Write}

2. {问题描述}
   - 修复操作:{具体操作}
   - 使用工具:{Read/SearchReplace/Write}

### 已修复

- {修复内容}
- {修复内容}

### 后续建议

- {建议内容}

评估模式

触发:用户问 skill 设计得怎么样或要求评估 Skill 质量

执行步骤

步骤 执行动作 具体命令
1 读取目标 Skill 运行 Read 工具读取 {skill-path}/SKILL.md
2 核心法则评估 检查是否符合【核心法则检查表】5 条法则
3 文档规范评估 检查是否符合【文档规范检查表】8 项规范
4 计算评分 统计符合项数,确定等级
5 输出评估 按【评估报告模板】输出结果

评估标准

等级 分数 说明
🏆 完美 13/13 完全符合 Skill Laws,可直接使用
✅ 优秀 11-12/13 基本符合,少量细节可优化
⚠️ 良好 8-10/13 有明显改进空间
❌ 需优化 < 8/13 需要大幅重构

错误处理

错误场景 错误表现 处理方式
文件不存在 Read 报错文件不存在 询问用户正确的 skill 名称或路径
非 Skill 文件 文件不含 SKILL.md 结构 输出”该文件不是 Skill,无法评估”,说明 Skill 文件结构要求
评分边界 得分恰好在边界(如 10 分或 12 分) 向下取整,按较低等级评定,鼓励继续优化

评估报告模板

## Skill 质量评估:{skill-name}

### 总体评分

**符合度**:{X}/13 项 ✅

**等级**:{🏆/✅/⚠️/❌}

### 核心问题(如等级不为 🏆)

- {问题描述} → {改进建议}
- {问题描述} → {改进建议}

### 建议操作

- 如等级为 ❌ 需优化:按【优化模式】执行全面优化
- 如等级为 ⚠️ 良好:针对核心问题逐一修复
- 如等级为 ✅ 优秀:微调细节即可达到 🏆 完美