⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

专业 README 生成器 - 自动创建项目文档，提升开源项目质量

readme-generator by patricio0312rev/skills

79 周安装量

27 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/patricio0312rev/skills --skill readme-generator

自动化文档生成开源项目

🇨🇳中文介绍

README 生成器

为项目创建全面、专业的 README 文档。

核心工作流程

分析项目：识别类型和功能
添加标题：项目名称、徽章、描述
记录设置：安装和配置
展示用法：示例和 API
添加指南：贡献指南、许可证
包含额外内容：截图、路线图

README 模板

# 项目名称

[![npm version](https://img.shields.io/npm/v/package-name.svg)](https://www.npmjs.com/package/package-name)
[![Build Status](https://github.com/username/repo/workflows/CI/badge.svg)](https://github.com/username/repo/actions)
[![Coverage](https://codecov.io/gh/username/repo/branch/main/graph/badge.svg)](https://codecov.io/gh/username/repo)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)

简要描述这个项目是做什么的以及为谁服务。用一两句话概括项目的精髓。

## 功能特性

- ✨ 功能一及其简要描述
- 🚀 功能二及其简要描述
- 🔒 功能三及其简要描述
- 📦 功能四及其简要描述

## 演示

![演示 GIF](https://example.com/demo.gif)

[在线演示](https://demo.example.com) | [文档](https://docs.example.com)

## 快速开始

```bash
npx create-project-name my-app
cd my-app
npm run dev
```

## 安装

### 先决条件

- Node.js 18.0 或更高版本
- npm 9.0 或更高版本（或 pnpm/yarn）

### 包管理器

```bash
# npm
npm install package-name

# pnpm
pnpm add package-name

# yarn
yarn add package-name
```

### 从源代码安装

```bash
git clone https://github.com/username/repo.git
cd repo
npm install
npm run build
```

## 用法

### 基本用法

```typescript
import { something } from 'package-name';

const result = something({
  option1: 'value',
  option2: true,
});

console.log(result);
```

### 高级用法

```typescript
import { createClient, type Config } from 'package-name';

const config: Config = {
  apiKey: process.env.API_KEY,
  timeout: 5000,
  retries: 3,
};

const client = createClient(config);

// 异步操作
const data = await client.fetch('/endpoint');
```

### 与 React 一起使用

```tsx
import { Provider, useData } from 'package-name/react';

function App() {
  return (
    <Provider apiKey={process.env.API_KEY}>
      <MyComponent />
    </Provider>
  );
}

function MyComponent() {
  const { data, loading, error } = useData('key');

  if (loading) return <Spinner />;
  if (error) return <Error message={error.message} />;

  return <div>{data.value}</div>;
}
```

## API 参考

### `createClient(config)`

创建一个新的客户端实例。

| 参数 | 类型 | 默认值 | 描述 |
|-----------|------|---------|-------------|
| `apiKey` | `string` | 必需 | 您的 API 密钥 |
| `baseUrl` | `string` | `'https://api.example.com'` | API 基础 URL |
| `timeout` | `number` | `30000` | 请求超时时间（毫秒） |
| `retries` | `number` | `3` | 重试尝试次数 |

**返回：** `Client`

### `client.fetch(endpoint, options?)`

从指定端点获取数据。

```typescript
const data = await client.fetch('/users', {
  method: 'GET',
  headers: { 'X-Custom': 'value' },
});
```

### `client.create(endpoint, data)`

创建新资源。

```typescript
const user = await client.create('/users', {
  name: 'John Doe',
  email: 'john@example.com',
});
```

## 配置

### 环境变量

| 变量 | 描述 | 必需 |
|----------|-------------|----------|
| `API_KEY` | 您的 API 密钥 | 是 |
| `API_URL` | 自定义 API URL | 否 |
| `DEBUG` | 启用调试模式 | 否 |

### 配置文件

在项目根目录创建 `config.json`：

```json
{
  "apiKey": "your-api-key",
  "environment": "production",
  "features": {
    "caching": true,
    "logging": false
  }
}
```

## 示例

### 示例 1：基本 CRUD 操作

```typescript
// 创建
const user = await client.create('/users', { name: 'John' });

// 读取
const users = await client.fetch('/users');

// 更新
await client.update(`/users/${user.id}`, { name: 'Jane' });

// 删除
await client.delete(`/users/${user.id}`);
```

### 示例 2：错误处理

```typescript
try {
  const data = await client.fetch('/protected');
} catch (error) {
  if (error instanceof AuthError) {
    console.error('身份验证失败');
  } else if (error instanceof NetworkError) {
    console.error('网络错误：', error.message);
  } else {
    throw error;
  }
}
```

更多示例请查看 [examples 目录](./examples)。

## 架构

```
src/
├── client/          # 客户端实现
├── hooks/           # React 钩子
├── utils/           # 工具函数
├── types/           # TypeScript 类型
└── index.ts         # 主导出
```

## 贡献

我们欢迎贡献！详情请参阅我们的 [贡献指南](CONTRIBUTING.md)。

### 开发设置

```bash
# 克隆仓库
git clone https://github.com/username/repo.git

# 安装依赖
npm install

# 运行测试
npm test

# 开始开发
npm run dev
```

### 提交约定

我们使用 [Conventional Commits](https://www.conventionalcommits.org/)：

- `feat:` 新功能
- `fix:` 错误修复
- `docs:` 文档
- `test:` 测试
- `chore:` 维护

## 路线图

- [x] 初始版本
- [x] TypeScript 支持
- [ ] React Native 支持
- [ ] 离线模式
- [ ] 插件系统

查看 [开放问题](https://github.com/username/repo/issues) 获取完整的功能建议列表。

## 常见问题解答

<details>
<summary><strong>如何获取 API 密钥？</strong></summary>

访问 [我们的控制面板](https://dashboard.example.com) 创建账户并生成 API 密钥。
</details>

<details>
<summary><strong>有速率限制吗？</strong></summary>

是的，免费层允许每小时 1000 次请求。查看我们的 [定价页面](https://example.com/pricing) 了解更高的限制。
</details>

<details>
<summary><strong>它适用于 Next.js 吗？</strong></summary>

是的！我们完全支持 Next.js，包括 App Router 和 Server Components。
</details>

## 故障排除

### 常见问题

**错误：API 密钥无效**

确保您的 API 密钥在环境变量中正确设置且未过期。

**错误：网络超时**

增加配置中的超时值或检查您的网络连接。

## 更新日志

查看 [CHANGELOG.md](CHANGELOG.md) 了解变更历史。

## 许可证

本项目根据 MIT 许可证授权 - 详情请参阅 [LICENSE](LICENSE) 文件。

## 致谢

- [库 1](https://example.com) - 感谢其出色的功能
- [库 2](https://example.com) - 感谢其带来的灵感
- 所有我们的 [贡献者](https://github.com/username/repo/graphs/contributors)

## 支持

- 📧 邮箱：support@example.com
- 💬 Discord：[加入我们的社区](https://discord.gg/example)
- 🐦 Twitter：[@username](https://twitter.com/username)
- 📖 文档：[docs.example.com](https://docs.example.com)

---

由 [您的名字](https://github.com/username) ❤️ 制作

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

🇺🇸English

README Generator

Create comprehensive, professional README documentation for projects.

Core Workflow

Analyze project : Identify type and features
Add header : Title, badges, description
Document setup : Installation and configuration
Show usage : Examples and API
Add guides : Contributing, license
Include extras : Screenshots, roadmap

README Template

# Project Name

[![npm version](https://img.shields.io/npm/v/package-name.svg)](https://www.npmjs.com/package/package-name)
[![Build Status](https://github.com/username/repo/workflows/CI/badge.svg)](https://github.com/username/repo/actions)
[![Coverage](https://codecov.io/gh/username/repo/branch/main/graph/badge.svg)](https://codecov.io/gh/username/repo)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)

Brief description of what this project does and who it's for. One to two sentences that capture the essence of the project.

## Features

- ✨ Feature one with brief description
- 🚀 Feature two with brief description
- 🔒 Feature three with brief description
- 📦 Feature four with brief description

## Demo

![Demo GIF](https://example.com/demo.gif)

[Live Demo](https://demo.example.com) | [Documentation](https://docs.example.com)

## Quick Start

\`\`\`bash
npx create-project-name my-app
cd my-app
npm run dev
\`\`\`

## Installation

### Prerequisites

- Node.js 18.0 or higher
- npm 9.0 or higher (or pnpm/yarn)

### Package Manager

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

# pnpm
pnpm add package-name

# yarn
yarn add package-name
\`\`\`

### From Source

\`\`\`bash
git clone https://github.com/username/repo.git
cd repo
npm install
npm run build
\`\`\`

## Usage

### Basic Usage

\`\`\`typescript
import { something } from 'package-name';

const result = something({
  option1: 'value',
  option2: true,
});

console.log(result);
\`\`\`

### Advanced Usage

\`\`\`typescript
import { createClient, type Config } from 'package-name';

const config: Config = {
  apiKey: process.env.API_KEY,
  timeout: 5000,
  retries: 3,
};

const client = createClient(config);

// Async operation
const data = await client.fetch('/endpoint');
\`\`\`

### With React

\`\`\`tsx
import { Provider, useData } from 'package-name/react';

function App() {
  return (
    <Provider apiKey={process.env.API_KEY}>
      <MyComponent />
    </Provider>
  );
}

function MyComponent() {
  const { data, loading, error } = useData('key');

  if (loading) return <Spinner />;
  if (error) return <Error message={error.message} />;

  return <div>{data.value}</div>;
}
\`\`\`

## API Reference

### `createClient(config)`

Creates a new client instance.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `apiKey` | `string` | required | Your API key |
| `baseUrl` | `string` | `'https://api.example.com'` | API base URL |
| `timeout` | `number` | `30000` | Request timeout in ms |
| `retries` | `number` | `3` | Number of retry attempts |

**Returns:** `Client`

### `client.fetch(endpoint, options?)`

Fetches data from the specified endpoint.

\`\`\`typescript
const data = await client.fetch('/users', {
  method: 'GET',
  headers: { 'X-Custom': 'value' },
});
\`\`\`

### `client.create(endpoint, data)`

Creates a new resource.

\`\`\`typescript
const user = await client.create('/users', {
  name: 'John Doe',
  email: 'john@example.com',
});
\`\`\`

## Configuration

### Environment Variables

| Variable | Description | Required |
|----------|-------------|----------|
| `API_KEY` | Your API key | Yes |
| `API_URL` | Custom API URL | No |
| `DEBUG` | Enable debug mode | No |

### Configuration File

Create a `config.json` in your project root:

\`\`\`json
{
  "apiKey": "your-api-key",
  "environment": "production",
  "features": {
    "caching": true,
    "logging": false
  }
}
\`\`\`

## Examples

### Example 1: Basic CRUD

\`\`\`typescript
// Create
const user = await client.create('/users', { name: 'John' });

// Read
const users = await client.fetch('/users');

// Update
await client.update(\`/users/\${user.id}\`, { name: 'Jane' });

// Delete
await client.delete(\`/users/\${user.id}\`);
\`\`\`

### Example 2: Error Handling

\`\`\`typescript
try {
  const data = await client.fetch('/protected');
} catch (error) {
  if (error instanceof AuthError) {
    console.error('Authentication failed');
  } else if (error instanceof NetworkError) {
    console.error('Network error:', error.message);
  } else {
    throw error;
  }
}
\`\`\`

More examples in the [examples directory](./examples).

## Architecture

\`\`\`
src/
├── client/          # Client implementation
├── hooks/           # React hooks
├── utils/           # Utility functions
├── types/           # TypeScript types
└── index.ts         # Main export
\`\`\`

## Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

### Development Setup

\`\`\`bash
# Clone the repository
git clone https://github.com/username/repo.git

# Install dependencies
npm install

# Run tests
npm test

# Start development
npm run dev
\`\`\`

### Commit Convention

We use [Conventional Commits](https://www.conventionalcommits.org/):

- `feat:` New feature
- `fix:` Bug fix
- `docs:` Documentation
- `test:` Tests
- `chore:` Maintenance

## Roadmap

- [x] Initial release
- [x] TypeScript support
- [ ] React Native support
- [ ] Offline mode
- [ ] Plugin system

See the [open issues](https://github.com/username/repo/issues) for a full list of proposed features.

## FAQ

<details>
<summary><strong>How do I get an API key?</strong></summary>

Visit [our dashboard](https://dashboard.example.com) to create an account and generate an API key.
</details>

<details>
<summary><strong>Is there a rate limit?</strong></summary>

Yes, the free tier allows 1000 requests per hour. See our [pricing page](https://example.com/pricing) for higher limits.
</details>

<details>
<summary><strong>Does it work with Next.js?</strong></summary>

Yes! We have full support for Next.js including App Router and Server Components.
</details>

## Troubleshooting

### Common Issues

**Error: API key is invalid**

Make sure your API key is correctly set in the environment variables and hasn't expired.

**Error: Network timeout**

Increase the timeout value in your configuration or check your network connection.

## Changelog

See [CHANGELOG.md](CHANGELOG.md) for a history of changes.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Acknowledgments

- [Library 1](https://example.com) - For the amazing feature
- [Library 2](https://example.com) - For inspiration
- All our [contributors](https://github.com/username/repo/graphs/contributors)

## Support

- 📧 Email: support@example.com
- 💬 Discord: [Join our community](https://discord.gg/example)
- 🐦 Twitter: [@username](https://twitter.com/username)
- 📖 Documentation: [docs.example.com](https://docs.example.com)

---

Made with ❤️ by [Your Name](https://github.com/username)

Badge Examples

<!-- Build Status -->
[![CI](https://github.com/user/repo/actions/workflows/ci.yml/badge.svg)](https://github.com/user/repo/actions/workflows/ci.yml)

<!-- npm -->
[![npm](https://img.shields.io/npm/v/package.svg)](https://www.npmjs.com/package/package)
[![npm downloads](https://img.shields.io/npm/dm/package.svg)](https://www.npmjs.com/package/package)

<!-- Coverage -->
[![codecov](https://codecov.io/gh/user/repo/branch/main/graph/badge.svg)](https://codecov.io/gh/user/repo)

<!-- License -->
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

<!-- Language -->
[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
[![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&logoColor=black)](https://developer.mozilla.org/en-US/docs/Web/JavaScript)

<!-- Framework -->
[![React](https://img.shields.io/badge/React-20232A?logo=react&logoColor=61DAFB)](https://reactjs.org/)
[![Next.js](https://img.shields.io/badge/Next.js-000000?logo=next.js&logoColor=white)](https://nextjs.org/)
[![Node.js](https://img.shields.io/badge/Node.js-339933?logo=node.js&logoColor=white)](https://nodejs.org/)

<!-- Package Manager -->
[![pnpm](https://img.shields.io/badge/pnpm-F69220?logo=pnpm&logoColor=white)](https://pnpm.io/)

<!-- PRs Welcome -->
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)

<!-- Maintenance -->
[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/user/repo/graphs/commit-activity)

<!-- Custom Shields.io -->
[![Custom Badge](https://img.shields.io/badge/custom-badge-blue)](https://example.com)

CONTRIBUTING.md Template

# Contributing to Project Name

Thank you for your interest in contributing! This document provides guidelines and steps for contributing.

## Code of Conduct

Please read and follow our [Code of Conduct](CODE_OF_CONDUCT.md).

## How Can I Contribute?

### Reporting Bugs

- Check existing issues first
- Use the bug report template
- Include reproduction steps
- Provide environment details

### Suggesting Features

- Check existing feature requests
- Use the feature request template
- Explain the use case
- Consider implementation approach

### Pull Requests

1. Fork the repository
2. Create a feature branch: `git checkout -b feature/my-feature`
3. Make your changes
4. Write/update tests
5. Run the test suite: `npm test`
6. Commit with conventional commits: `git commit -m 'feat: add new feature'`
7. Push to your fork: `git push origin feature/my-feature`
8. Open a Pull Request

## Development Setup

\`\`\`bash
# Clone your fork
git clone https://github.com/your-username/repo.git

# Add upstream remote
git remote add upstream https://github.com/original-owner/repo.git

# Install dependencies
npm install

# Create a branch
git checkout -b feature/my-feature
\`\`\`

## Coding Standards

- Follow existing code style
- Use TypeScript strict mode
- Write meaningful commit messages
- Add tests for new features
- Update documentation as needed

## Testing

\`\`\`bash
# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run specific test file
npm test -- path/to/test.ts
\`\`\`

## Questions?

Feel free to open an issue or reach out on Discord.

CHANGELOG.md Template

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added
- New feature description

### Changed
- Change description

### Fixed
- Bug fix description

## [1.2.0] - 2024-01-15

### Added
- Add new authentication method
- Add TypeScript support for config files

### Changed
- Improve error messages
- Update dependencies

### Fixed
- Fix memory leak in connection pool
- Fix race condition in cache invalidation

## [1.1.0] - 2024-01-01

### Added
- Add retry mechanism for failed requests
- Add timeout configuration option

### Deprecated
- Deprecate `oldMethod()` in favor of `newMethod()`

## [1.0.0] - 2023-12-15

### Added
- Initial release
- Core API functionality
- React hooks
- TypeScript types

[Unreleased]: https://github.com/user/repo/compare/v1.2.0...HEAD
[1.2.0]: https://github.com/user/repo/compare/v1.1.0...v1.2.0
[1.1.0]: https://github.com/user/repo/compare/v1.0.0...v1.1.0
[1.0.0]: https://github.com/user/repo/releases/tag/v1.0.0

Best Practices

Start with value : Lead with what the project does
Quick start first : Get users running quickly
Show, don't tell : Include code examples
Keep updated : Sync with code changes
Use badges : Show project health
Add visuals : Screenshots and diagrams
Link related : Connect to other docs
Be consistent : Follow established patterns

Output Checklist

Every README should include:

Project title and description
Badges (build, version, license)
Features list
Quick start / Installation
Usage examples
API documentation
Configuration options
Contributing guidelines
License information
Support/contact info

Weekly Installs

Repository

patricio0312rev/skills

GitHub Stars

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode47

codex45

gemini-cli44

claude-code42

github-copilot40

cursor39

专业 README 生成器 - 自动创建项目文档，提升开源项目质量

🇨🇳中文介绍

README 生成器

核心工作流程

README 模板

相关 Skills

徽章示例

CONTRIBUTING.md 模板

CHANGELOG.md 模板

最佳实践

输出清单