AgentSkillsCN

musubix-technical-writing

技术文档编写指南,可用于撰写 README、用户指南以及 API 参考文档。

SKILL.md
--- frontmatter
name: musubix-technical-writing
description: 技術ドキュメント作成ガイド。README、ユーザーガイド、API参照に使用。
license: MIT

Technical Writing Skill

高品質な技術ドキュメントを一貫した構造で作成。

Document Types

種類目的ファイル
READMEプロジェクト概要README.md
Install Guideセットアップ手順INSTALL-GUIDE.md
User Guide使用方法詳細USER-GUIDE.md
API ReferenceAPI完全ドキュメントAPI-REFERENCE.md
Changelogバージョン履歴CHANGELOG.md

WHEN → DO

WHENDO
新規プロジェクトREADMEテンプレート適用
機能追加User GuideとAPI Reference更新
リリースChangelog更新
セットアップ手順変更Install Guide更新

README Template

markdown
# Project Name

> One-line description

## 🎯 Features
- Feature 1
- Feature 2

## 📦 Installation
\`\`\`bash
npm install package-name
\`\`\`

## 🚀 Quick Start
\`\`\`typescript
import { MainClass } from 'package-name';
const instance = new MainClass();
\`\`\`

## 📖 Documentation
- [Installation](docs/INSTALL-GUIDE.md)
- [User Guide](docs/USER-GUIDE.md)
- [API Reference](docs/API-REFERENCE.md)

API Reference Template

markdown
### `methodName(param1, param2)`

Description.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `param1` | `string` | Yes | First param |
| `param2` | `number` | No | Optional |

**Returns**: `Promise<Result>`

**Example**:
\`\`\`typescript
const result = await instance.methodName('value', 42);
\`\`\`

Changelog Format

Keep a Changelog準拠:

markdown
## [1.2.0] - 2026-01-15

### Added
- New feature description

### Changed
- Modified behavior

### Fixed
- Bug fix description

出力例

code
┌─────────────────────────────────────────┐
│ Documentation Generated                 │
├─────────────────────────────────────────┤
│ README.md:        Updated              │
│ INSTALL-GUIDE.md: Created              │
│ USER-GUIDE.md:    Updated              │
│ API-REFERENCE.md: Updated              │
│ CHANGELOG.md:     Updated              │
│ Total Sections:   15                   │
└─────────────────────────────────────────┘