一键在 Manus 中运行任何 Skill

docs-guidelines

星标29

分支3

更新时间2026年3月11日 12:11

Guidelines for writing Rust documentation. Refer to this when you need to write doc comments on functions, types or modules.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

LukeMathWalker

LukeMathWalker/cheadergen

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

Docs Guidelines

Standards to follow when writing code-level documentation.

Guidelines

Key concepts should be explained only once. All other documentation should use an intra-documentation link to the first explanation.
Always use an intra-documentation link when mentioning a Rust symbol (type, function, constant, etc.).
Avoid referring to specific lines or line ranges, as they may change over time. Use line comments if the documentation needs to be attached to a specific code section inside a function/method body.
Focus on why, not how. In particular, avoid explaining trivial implementation details in line comments.
Refer to constants using intra-documentation links. Don't hard-code their values in the documentation of other items.
Intra-documentation links to private items are allowed. Don't duplicate.

同仓库更多 Skills

同仓库

ui-tests

LukeMathWalker/cheadergen

Reference for the ui-tests infrastructure: test suites, directory layout, test.toml format, snapshot workflow, and common commands. Use when working with ui-tests cases, debugging test failures, or scaffolding new tests.

2026-04-0329

verify

LukeMathWalker/cheadergen

Runs the cheadergen verification workflow in stages - lint, format, generation tests, and full test suite. Use when user says "verify", "run checks", "run tests", or wants to validate changes before committing.

2026-03-2729

rustdoc

LukeMathWalker/cheadergen

Look up Rust dependency API docs locally. Use when the user or task requires information about a dependency's API, types, traits, functions, or modules — e.g. "look up guppy's PackageGraph", "what methods does rustdoc_types::Item have", "show me clap's derive API".

2026-03-1029

write-test

LukeMathWalker/cheadergen

Write a test to improve code coverage. Uses `cargo llvm-cov` to identify uncovered lines, then writes a focused test to cover them. Use when user says "write test", "improve coverage", "cover lines", or "write-test".

2026-03-0729

name	docs-guidelines
description	Guidelines for writing Rust documentation. Refer to this when you need to write doc comments on functions, types or modules.

Docs Guidelines

Standards to follow when writing code-level documentation.

Guidelines

Key concepts should be explained only once. All other documentation should use an intra-documentation link to the first explanation.
Always use an intra-documentation link when mentioning a Rust symbol (type, function, constant, etc.).
Avoid referring to specific lines or line ranges, as they may change over time. Use line comments if the documentation needs to be attached to a specific code section inside a function/method body.
Focus on why, not how. In particular, avoid explaining trivial implementation details in line comments.
Refer to constants using intra-documentation links. Don't hard-code their values in the documentation of other items.
Intra-documentation links to private items are allowed. Don't duplicate.