跳到正文
cccskills
免费在 GitHub 公开

issue

Write clear Toasty issues by choosing the right template for a bug report or feature proposal and filling in its required fields. It helps describe observed behavior, reproduction steps, proposed APIs, and alternatives in concise, factual language.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Always use this skill before opening an issue in the Toasty repository

tokio-rs/toasty星标 3,269(GitHub 3,269 + cccskills 0)

实测评分 未实测

查看安装方法

适用场景

  • Reporting a bug with steps and a reproducer
  • Proposing a feature or public API change
  • Choosing and completing an issue template

包含的文件(1)

  • SKILL.md3.0 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Opening Issues

Load this skill before filing any issue in this project.

Writing style

An issue is project documentation. Follow the conventions from the prose skill: be fact-focused, direct, and concrete. No buzzwords, no fluff, no dramatic terms. State what happened or what is being proposed, not how important it is.

Be succinct

Maintainers reading the issue already know Toasty and Rust. Keep the prose high-signal: lead with the bug or proposal, then the reproducer or API sketch, then the alternatives. Skip restated background and throat-clearing. A maintainer should grasp the problem in seconds, not paragraphs.

Pick the right template

Issue templates live in .github/ISSUE_TEMPLATE/:

  • bug_report.yml — incorrect or unexpected behavior. Asks what you did, what you expected, and what happened instead; the affected driver(s); the Toasty version; and a reproducer.
  • feature_proposal.yml — new features, public-API changes, or anything that affects driver implementations. Requires the problem, proposed solution, alternatives considered, and a scope estimate.

Read the template before writing. Fill in every field it asks for; don't drop sections or leave placeholders. If a field does not apply, say so explicitly rather than leaving it blank.

Bug reports

Report what you observed, not why you think it happened. A bug report has five parts:

  • What you did — the query or operation you ran.
  • What you expected — the result you expected.
  • What actually happened — the error, wrong result, or panic. Quote the exact message, generated SQL, or backtrace.
  • Additional context — affected driver, Toasty version, related issues.
  • A minimal reproducer — a failing test in crates/toasty-driver-integration-suite/src/tests/ is ideal; a small standalone snippet works too. This is the single most useful thing in the report.

Leave out root-cause analysis. Diagnosing the bug is the maintainer's job, and a guess at the cause sends triage down the wrong path. Describe the behavior; the reproducer shows the rest.

Feature proposals

Describe the problem before the solution. Name who is affected — Toasty users, driver implementors, or both. Sketch the user-facing API concretely; vague proposals are hard to discuss. List the alternatives you considered and why you discarded them.

Non-trivial features follow the path in CONTRIBUTING.md: discuss in an issue, land a roadmap entry and design doc, then land the implementation.

Labels

Do not apply labels when creating the issue. The templates set the initial C-* label; maintainers triage and add the rest. See docs/dev/labels.md.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

commit

免费

Prepare concise Git commit messages for the Toasty project by first checking its authoritative commit guide. The skill focuses on describing what changed and why, using the project's required format, types, scopes, and breaking-change notation.

中文简介正在准备中。当前显示英语简介。

  • Writing a commit subject and body
  • Checking allowed commit types and scopes
  • Marking a breaking change correctly
tokio-rs/toasty32692026年10月26日 更新

design

免费

Prepare Toasty design documents under `docs/dev/design/` using the required template, audience, and concise writing conventions. The skill guides document structure and illustrative Rust examples, and outlines the proposal and roadmap steps for non-trivial features.

中文简介正在准备中。当前显示英语简介。

  • Drafting a Toasty feature design document
  • Editing an existing design proposal
  • Explaining a feature to users and driver implementors
tokio-rs/toasty32692026年10月26日 更新

pr

免费

Prepare a Toasty pull request by reviewing the full change against its base branch and drafting a concise title and body from the net diff. It also covers the required template, rendered links for major Markdown changes, and label handling.

中文简介正在准备中。当前显示英语简介。

  • Drafting a pull request title and body
  • Summarizing changes across several commits
  • Preparing a pull request for a Markdown document
tokio-rs/toasty32692026年10月26日 更新

prose

免费

Write or edit Toasty documentation, design notes, READMEs, pull request descriptions, issues, and commit bodies using the project's prose conventions. It favors direct, factual language, concrete examples, active voice, and descriptions of current behavior.

中文简介正在准备中。当前显示英语简介。

  • Editing a README or project documentation
  • Writing an issue or pull request description
  • Making design notes more direct and concrete
tokio-rs/toasty32692026年10月26日 更新

查看 tokio-rs 的全部技能

报告此技能的问题