跳到正文
cccskills
免费在 GitHub 公开

docs-check

Verify documentation keeps up with a code change in dynamic-neural-field-composer - Doxygen on public API, the matching wiki page, and stale references elsewhere. Use before opening a PR, or when asked whether docs need updating.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md2.6 KB

SKILL.md(原文)

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

Docs check

Three passes over git diff origin/main...HEAD. Report findings; do not silently rewrite prose that is merely different from how you would put it.

Pass 1 - Doxygen

Scope: new or changed public entities under dynamic-neural-field-composer/include/.

Each needs:

  • @brief - one line, what it does
  • one @param per parameter, names matching the signature exactly
  • @return unless the return type is void

Flag three failure modes:

  • Missing - new public function/class/struct with no block.
  • Stale - a parameter was renamed, added or removed and the block still describes the old signature. This is the most common and the easiest to miss.
  • Wrong - the description contradicts what the code now does.

Private helpers in src/ do not need Doxygen.

Pass 2 - Wiki

dynamic-neural-field-composer/wiki/ has 15 pages. Map the change to its page:

ChangedPage
Element behaviour, new element typeElements.md, Element Reference.md
Element parameters, tuning defaultsElement Reference.md, Parameter Tuning Guide.md
GUI, windows, node editorApplication and UI.md
Simulation loop, timing, recorderSimulation.md
Plots, heatmaps, visualizationVisualization.md
Build, dependencies, setupGetting Started.md, Troubleshooting.md
Public API shape, architectureArchitecture.md, How to Add New Elements.md
New example executableExamples.md, How to Create and Run Your Own Example Executable.md
Test infrastructureTesting.md

Rule of thumb: if a user could notice the change without reading the source, a wiki page owes them an explanation. Pure internal refactors do not.

Pass 3 - Stale references

Grep the repo for references the change invalidated:

grep -rn "<old_symbol>" README.md CONTRIBUTING.md CHANGELOG.md dynamic-neural-field-composer/wiki/ .claude/

Look for renamed or removed symbols, moved file paths, changed build commands or flags, and example snippets that no longer compile. Check README.md and CONTRIBUTING.md specifically when the build process or directory layout moved.

Output

For each pass: either "clean" or a concrete list of file + line + what is wrong. If nothing in the diff touches public API or user-visible behaviour, say so and stop - a refactor with no API change legitimately needs no doc update.

评价

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

评论

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

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

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

0 / 1000 字

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

同一仓库的技能

autopilot

免费

Orchestrate unattended resolution of open GitHub issues - triage by complexity, dispatch parallel worker agents into isolated worktrees, review their diffs, open PRs, and monitor CI and CodeRabbit until green. Use when asked to work through open issues autonomously or put Claude on auto-pilot.

中文简介正在准备中。当前显示原文说明。

Jgocunha/dynamic-neural-field-composer192026年10月9日 更新

Configure, build and test dynamic-neural-field-composer. Use whenever you need to compile the library, run the GoogleTest suite, verify a change builds, or reproduce a test failure.

中文简介正在准备中。当前显示原文说明。

Jgocunha/dynamic-neural-field-composer192026年10月9日 更新

commit

免费

Read the uncommitted diff in dynamic-neural-field-composer and print conventional commit message(s) for it, grouped by logical change. Use when asked to write, suggest or draft a commit message, or "what should I commit this as".

中文简介正在准备中。当前显示原文说明。

Jgocunha/dynamic-neural-field-composer192026年10月9日 更新

Check a change for performance regression against this machine's recorded baseline - decide whether the diff needs checking, run the deck benchmark under the hygiene wrapper, and attribute any regression to an element. Use before opening a PR that touches the simulation hot path.

中文简介正在准备中。当前显示原文说明。

Jgocunha/dynamic-neural-field-composer192026年10月9日 更新

pr

免费

Read the branch diff in dynamic-neural-field-composer and print a PR title and description in chat, filling the repo's pull request template. Use when asked to write, draft or suggest a PR title/description, or "what should the PR say".

中文简介正在准备中。当前显示原文说明。

Jgocunha/dynamic-neural-field-composer192026年10月9日 更新

Review a diff against dynamic-neural-field-composer's own standards - backwards compatibility, Clean Code, tools/ helper reuse, C++20 idiom, hot-path performance, and test coverage. Use before opening a PR or when asked to review a branch or change.

中文简介正在准备中。当前显示原文说明。

Jgocunha/dynamic-neural-field-composer192026年10月9日 更新

查看 Jgocunha 的全部技能

报告此技能的问题