mcpField
W
writing-skills

writing-skills

github.com/yinhunfeixueエージェントワークフロー436 回インストール22 週間前に更新
リポジトリ

writing-skills について

writing-skillsは、エージェントスキルを作成・保守する人向けの文書作成規約です。ディレクトリ構成、命名、SKILL.mdの形式、依存関係の参照、手順の構成を定めています。

主な機能

  1. 01スキルの構成と入口ファイルの定義
  2. 02名前とfrontmatter形式の指定
  3. 03依存ファイルの参照方法
  4. 04手順の出力と引き継ぎの構成

活用シーン

  1. 01エージェントスキル文書の新規作成
  2. 02依存関係の記載漏れの確認
  3. 03複数スキルの形式統一

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/yinhunfeixue/software_development_skills --skill writing-skills

インストール後、Claude Code で/writing-skillsを入力して読み込まれたか確認します。

詳細

プロジェクトの README より

文档编写技能

注意事项

  • 内容具有普适性，除非明确说明，否则不应依赖具体业务
  • 文档应能脱离特定项目上下文独立理解
  • 示例应简洁有力，不要废话连篇

目录结构

skills/
  <skill-name>/
    SKILL.md       ← 必须，skill 入口文件

命名规范

  • 文件夹名：小写字母 + 连字符，例如 code-review、task-breakdown
  • name 字段：必须和文件夹名一致
  • 风格：用名词或动词短语，简洁明确

SKILL.md 格式

---
name: <skill-name>
description: <一句话说明用途和触发时机>
---

# <标题>

## 依赖规范
#[[file:../rules/<规则文件>.md]]
#[[file:../<其他skill>/SKILL.md]]

## 目的
<一句话说明目标>

## 输入
- <输入项>

## 步骤

> 每个步骤先输出标题，再输出结果

- <步骤 1>
- <步骤 2>

## 输出
- <输出项>

## Review 检查清单
- <检查项>

编写规则

  • description：说清楚"什么时候用"，Kiro 靠它决定是否激活 skill
  • 依赖规范：列出所有引用的 rules 和其他 skill，确保单独使用时能加载完整上下文
  • 步骤：加上"每个步骤先输出标题，再输出结果"，防止 AI 跳步
  • 引用一致：文字里提到的规范名称，必须在依赖规范里有对应的 #[[file:]]
  • 写入文档：如果步骤涉及写文档，加上"路径遵守 project-structure 文档存放规范"
  • 阶段结束：如果是流程阶段 skill，末尾加"下一阶段"和 stage-gate 引用

规则文件

通用规则放在 skills/rules/ 目录，不是独立 skill，被其他 skill 通过 #[[file:]] 引用：

skills/rules/
  <rule-name>.md

规则文件同样需要 frontmatter（name + description），但不需要步骤和输出。

コメント

Markdown 対応