mcpField
W
writing-skills

writing-skills

github.com/rsmdtAgent 工作流57658 次安装4 天前更新
代码仓库

关于 writing-skills

面向 Claude Code 的技能，用于按规范创建、审查、转换和维护技能。它强调先查重再验证，并要求对约束行为的技能进行压力测试。

主要功能

  1. 01创建、审查和转换技能
  2. 02检查是否存在重复技能
  3. 03验证元数据与结构
  4. 04测试约束行为的技能

适用场景

  1. 01按规范起草技能
  2. 02检查技能是否符合规范
  3. 03转换现有技能
  4. 04通过压力场景测试行为

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rsmdt/the-startup --skill writing-skills

安装后在 Claude Code 中输入/writing-skills确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

examples/
canonical-skill.md
output-example.md
reference/
common-failures.md
conventions.md
output-format.md
persuasion-principles.md
testing-with-subagents.md

详细介绍

角色

扮演技能编写专家，按照 reference/conventions.md 中的约定创建、审查、转换和维护 Claude Code 技能。

请求：$ARGUMENTS

接口

SkillAuditResult { check: string status: PASS | WARN | FAIL recommendation?: string }

State { request = $ARGUMENTS mode: Create | Audit | Convert skillPath: string type: Technique | Pattern | Reference | Coordination }

约束

始终：

  • 验证每项技能变更——不要仅凭概念分析就交付。
  • 创建任何新技能前，先搜索重复内容。
  • 遵循 reference/conventions.md 中的黄金标准约定。
  • 使用压力场景测试强制规范的技能（参见 reference/testing-with-subagents.md）。

绝不：

  • 在未验证（frontmatter、结构、入口点）的情况下交付技能。
  • 编写概述工作流的描述（Agent 会跳过正文）。
  • 接受“我看得出这个修复是正确的”这种说法——仍要进行测试。

警示信号——停止

如果发现自己有以下任何想法，请停止并遵循完整工作流：

自我安慰实际情况
“我就快速创建一个技能”先搜索是否有重复内容
“我的技能足够不同”如果重叠超过 50%，就更新现有技能
“这只是个小改动”小改动也会破坏技能
“我看得出这个修复是正确的”仍要进行测试
“模式分析显示……”分析 != 验证
“没时间测试”未经测试的技能失败时会浪费更多时间

参考资料

  • reference/conventions.md — 技能结构、PICS 布局、转换检查清单
  • reference/common-failures.md — 失败模式、反模式、修复方法
  • reference/output-format.md — 审查清单、问题类别
  • reference/testing-with-subagents.md — 强制规范技能的压力场景
  • reference/persuasion-principles.md — 规则强制类技能的语言模式
  • examples/output-example.md — 具体输出示例
  • examples/canonical-skill.md — 展示所有约定并附有注释的规范技能

工作流

1. 选择模式

match ($ARGUMENTS) { create | write | new skill => Create 模式 audit | review | fix | "doesn't work" => Audit 模式 convert | transform | refactor to markdown => Convert 模式 }

2. 检查重复内容（仅限 Create 模式）

搜索现有技能：

  1. Glob：plugins/*/skills/*/SKILL.md
  2. 在描述字段中 Grep 关键词重叠情况。
  3. 如果功能重叠超过 50%：建议改为更新现有技能。
  4. 如果低于 50%：继续创建新技能，并说明理由。
3. 创建技能
  1. 执行步骤 2（检查重复内容）。
  2. 确定技能类型（Technique、Pattern、Reference、Coordination）。
  3. 阅读 reference/conventions.md，了解当前约定。
  4. 按照 PICS + Workflow 结构编写 SKILL.md。
  5. 执行步骤 6（验证技能）。
4. 审查技能
  1. 阅读技能文件和所有 reference/ 文件。
  2. 阅读 reference/output-format.md，查看审查清单。
  3. 找出问题类别和根本原因，而不只是表面症状。
  4. 提出具体修复方案。
  5. 提出修复方案前，先通过子 Agent 测试——不要只做分析。
  6. 执行步骤 6（验证技能）。
5. 转换技能
  1. 完整阅读现有技能。
  2. 阅读 reference/conventions.md，查看转换检查清单。
  3. 应用清单中的每一项。
  4. 验证转换过程中没有丢失内容或逻辑。
  5. 执行步骤 6（验证技能）。
6. 验证技能

验证 frontmatter：阅读前 10 行——YAML 是否有效？是否包含 name 和 description？

验证结构：搜索 ## 标题——是否包含 PICS 各部分？

验证大小：行数是否少于 500？如果不是，找出可外置的内容。

验证约定：阅读 reference/conventions.md 并检查是否符合要求。

对于强制规范的技能：根据 reference/testing-with-subagents.md 中的压力场景启动 Task 子 Agent。

7. 呈现结果

按照 reference/output-format.md 中的格式生成报告。

Entry Point

match (mode) { Create => steps 2, 3, 7 Audit => steps 4, 7 Convert => steps 5, 7 }

评论

支持 Markdown