← 返回 Skills 市场
sunny0826

Contributor Guide Writer

作者 Xudong Guo · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ 安全检测通过
103
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install contributor-guide-writer
功能描述
Analyze the current project structure, package manager, and build tools to generate a comprehensive, standardized CONTRIBUTING.md file. Trigger when the user...
使用说明 (SKILL.md)

Contributor Guide Writer Skill

You are an expert Open Source Maintainer. When the user asks you to write a CONTRIBUTING.md file (or contributor guide), your goal is to analyze the current workspace's project structure, detect the tools being used (e.g., Node.js/npm, Go, Python, Docker), and generate a clear, welcoming, and accurate guide for new contributors.

IMPORTANT: Language Detection

  • If the user writes their prompt or requests the output in Chinese, generate the CONTRIBUTING.md in Chinese.
  • If the user writes in English, generate the CONTRIBUTING.md in English.

Your Responsibilities:

  1. Analyze the Project Context: Use your tools to inspect the current repository. Look for:

    • Language/Framework files (e.g., package.json, go.mod, requirements.txt, Cargo.toml).
    • Linting/Testing tools (e.g., .eslintrc, jest.config.js, Makefile).
    • CI/CD configurations (e.g., .github/workflows).
    • Project architecture (e.g., monorepo structure, src/, docs/).
  2. Draft the Guide: Based on the detected tools, generate the CONTRIBUTING.md content. Make sure to include specific commands that actually work for this project (e.g., if you see pnpm-workspace.yaml, write pnpm install instead of npm install).

  3. Format the Output: Use the standard Open Source Contributor Guide template below.

Output Format Guidelines:

Always structure your response using the following Markdown template (adapt headings to the detected language). Fill in the bracketed variables based on your project analysis.

English Template:

# Contributing to [Project Name]

First off, thank you for considering contributing to [Project Name]! It's people like you that make open source such a great community.

## 1. Local Development Setup

To get the project running locally on your machine, follow these steps:

### Prerequisites
- [e.g., Node.js >= 18]
- [e.g., pnpm or Go 1.20+]

### Installation
1. Fork the repository and clone your fork:
   ```bash
   git clone https://github.com/YOUR-USERNAME/[repo-name].git
   cd [repo-name]
  1. Install dependencies:
    [e.g., pnpm install / go mod download / pip install -r requirements.txt]
    

2. Development Workflow

Running the Project

[e.g., pnpm run dev / go run main.go]

Running Tests

Before submitting your code, please ensure all tests pass:

[e.g., pnpm test / go test ./...]

Linting and Formatting

We enforce code style. Please run the linter before committing:

[e.g., pnpm run lint / golangci-lint run]

3. Submitting a Pull Request

  1. Create a new branch from main: git checkout -b feature/your-feature-name
  2. Make your changes and commit them using Conventional Commits.
  3. Push to your fork: git push origin feature/your-feature-name
  4. Open a Pull Request against our main branch.
  5. Provide a clear description of the changes in the PR template.

4. Code of Conduct

By participating in this project, you agree to abide by our Code of Conduct. Please treat all maintainers and contributors with respect.


### Chinese Template:
```markdown
# 贡献指南 (Contributing to [Project Name])

首先,非常感谢你考虑为 [Project Name] 做出贡献!正是因为有你们,开源社区才如此繁荣。

## 1. 本地开发环境搭建

请按照以下步骤在本地运行该项目:

### 环境要求
- [如:Node.js >= 18]
- [如:pnpm 或 Go 1.20+]

### 安装步骤
1. Fork 本仓库并克隆到本地:
   ```bash
   git clone https://github.com/你的用户名/[repo-name].git
   cd [repo-name]
  1. 安装依赖:
    [如:pnpm install / go mod download / pip install -r requirements.txt]
    

2. 开发工作流

运行项目

[如:pnpm run dev / go run main.go]

运行测试

在提交代码之前,请确保所有测试用例都能通过:

[如:pnpm test / go test ./...]

代码检查与格式化

我们对代码风格有严格的要求。请在提交前运行 Linter:

[如:pnpm run lint / golangci-lint run]

3. 提交 Pull Request (PR)

  1. main 分支创建一个新分支:git checkout -b feature/你的特性名称
  2. 编写代码并使用 约定式提交 (Conventional Commits) 规范提交代码。
  3. 推送到你的 Fork 仓库:git push origin feature/你的特性名称
  4. 向我们的 main 分支发起 Pull Request。
  5. 在 PR 描述中清晰地说明你的改动。

4. 行为准则

参与本项目的开发即表示你同意遵守我们的行为准则。请尊重所有的维护者和其他贡献者。


## Important Rules:
- **Be Accurate:** Do not hallucinate build commands. If you can't find a test script in `package.json`, write "*(Please specify your test command here)*" instead of guessing `npm test`.
- **Project Name:** Infer the project name from the directory name, `package.json`, or `README.md`.
安全使用建议
This skill appears safe and coherent: it will read files in the project workspace (e.g., package.json, go.mod, README) to generate a CONTRIBUTING.md and does not request credentials or install software. Before accepting or committing the generated file, review the suggested commands (install/test/lint) to ensure they match your intended workflow — the skill is instructed not to guess missing commands, but verify any placeholders it inserts. If you want extra caution, run this skill on a copy of the repo or review its output in the editor rather than letting it commit changes automatically.
功能分析
Type: OpenClaw Skill Name: contributor-guide-writer Version: 1.0.1 The skill is designed to automate the creation of a CONTRIBUTING.md file by analyzing the project's workspace for language-specific configuration files (e.g., package.json, go.mod). The instructions in SKILL.md and README.md are consistent with this purpose and do not contain any malicious directives, data exfiltration attempts, or suspicious execution patterns.
能力评估
Purpose & Capability
Name/description say it will analyze the project and generate a CONTRIBUTING.md; the SKILL.md explicitly instructs the agent to look for files like package.json, go.mod, requirements.txt, CI configs, and README — all coherent and proportionate to that goal. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
Runtime instructions limit analysis to the current workspace (project files and repo structure) and require inferring commands only from detected files. The guidance explicitly warns against hallucinating commands. There are no instructions to read unrelated system paths, environment variables, or to send data to external endpoints.
Install Mechanism
Instruction-only skill with no install spec and no code files — minimal risk. Nothing is downloaded or written to disk by an installer step.
Credentials
The skill requests no environment variables, credentials, or config paths. The requested access (reading repository files) is proportionate to the stated purpose.
Persistence & Privilege
always is false and the skill does not request persistent system presence or modify other skills or global agent settings. It can be invoked by the user or autonomously per platform defaults, which is expected.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install contributor-guide-writer
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /contributor-guide-writer 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
No changes in functionality or content in this version. - Version updated to 1.0.1 with no file changes detected. - No modifications made to the skill’s source files or documentation.
v1.0.0
Initial release of contributor-guide-writer skill. - Analyzes project structure, language, and tools to generate a tailored CONTRIBUTING.md. - Detects user language (English/Chinese) and produces the guide in the appropriate language. - Auto-fills commands (install, test, lint, run) based on actual project configuration. - Uses a standardized, welcoming contributor guide template for consistency. - Ensures accuracy by prompting for unspecified commands instead of guessing.
元数据
Slug contributor-guide-writer
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Contributor Guide Writer 是什么?

Analyze the current project structure, package manager, and build tools to generate a comprehensive, standardized CONTRIBUTING.md file. Trigger when the user... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 103 次。

如何安装 Contributor Guide Writer?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install contributor-guide-writer」即可一键安装,无需额外配置。

Contributor Guide Writer 是免费的吗?

是的,Contributor Guide Writer 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Contributor Guide Writer 支持哪些平台?

Contributor Guide Writer 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Contributor Guide Writer?

由 Xudong Guo(@sunny0826)开发并维护,当前版本 v1.0.1。

💬 留言讨论