本文へ移動
cccskills
無料GitHub で公開

gentle-ai-comment-writer

Write warm, direct collaboration comments. Trigger: PR feedback, issue replies, reviews, Slack messages, or GitHub comments.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md2.4 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

When to Use

Load this skill whenever you write a comment that another human will read.

Use it for:

  • GitHub PR or issue comments.
  • Review feedback and requested changes.
  • Maintainer replies.
  • Slack, Discord, or async project updates.

Voice Rules

RuleRequirement
Be useful fastStart with the actionable point. Do not recap the whole PR before feedback.
Be warm and directSound like a thoughtful teammate, not a corporate bot.
Keep it shortPrefer 1 to 3 short paragraphs or a tight bullet list.
Explain whyGive the technical reason when asking for a change.
Avoid pile-onsComment on the highest-value issue, not every tiny preference.
Match target context languageWrite in the target context language by default: Spanish issue/thread -> Spanish comment, English issue/thread -> English comment, mixed context -> target message language. If the user explicitly requests a language or tone, follow that request. Do not use the active persona as the source of truth for public comments. For Spanish comments, use neutral/professional Spanish by default unless the user or target context clearly calls for regional tone.
No em dashesUse commas, periods, or parentheses instead.

Comment Formula

<Direct observation or request>

<Why it matters, only if needed>

<Concrete next action>

Examples

Request change

Good approach overall. I'd split this into a separate commit because it mixes validation logic with UI wiring.

That keeps the reviewer's focus narrower and makes rollback cleaner if the integration fails.

Approve with a note

Approved. The scope is clear and the change is well-contained.

For the next PR, add links to the previous and following PRs so the chain stays navigable.

Ask for split

This PR exceeds the 400-line budget, so we need to split it or justify `size:exception`.

Suggested order: foundation + tests first, then integration, then docs. That gives each review a clear start and end.

Commands

# Inspect a PR before writing review feedback
gh pr view <PR_NUMBER> --json title,body,additions,deletions,changedFiles

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

gentle-ai

無料

Use Gentle AI harness discipline for Pi work: clarify first, track ODD work, use applicable test-first development by default, delegate when useful, and protect review workload.

日本語の概要は準備中です。原文の説明を表示しています。

Gentleman-Programming/gentle-shell1,2832026年10月12日 更新

Create Gentle AI pull requests with issue-first checks. Trigger: creating, opening, or preparing PRs for review.

日本語の概要は準備中です。原文の説明を表示しています。

Gentleman-Programming/gentle-shell1,2832026年10月12日 更新

Trigger: PRs over 400 lines, stacked PRs, review slices. Split oversized changes into chained PRs that protect review focus.

日本語の概要は準備中です。原文の説明を表示しています。

Gentleman-Programming/gentle-shell1,2832026年10月12日 更新

Design docs that reduce cognitive load. Trigger: writing guides, READMEs, RFCs, onboarding, architecture, or review-facing docs.

日本語の概要は準備中です。原文の説明を表示しています。

Gentleman-Programming/gentle-shell1,2832026年10月12日 更新

Create and triage GitHub issues from repository evidence. Trigger: issue creation, bug reports, feature requests, or issue approval.

日本語の概要は準備中です。原文の説明を表示しています。

Gentleman-Programming/gentle-shell1,2832026年10月12日 更新

Trigger: judgment day, judgement day, dual review, adversarial review, juzgar. Run explicit blind dual review with at most two scoped fix/re-judgment rounds.

日本語の概要は準備中です。原文の説明を表示しています。

Gentleman-Programming/gentle-shell1,2832026年10月12日 更新

Gentleman-Programming のスキルをすべて見る

このスキルの問題を報告する