agentleFS
shimo4228shimo4228/claude-harness/skills/public-comment/SKILL.md

public-comment

Skill4 starsChanged 33 days agoMITView on GitHub

Write, revise or post a reply in a public technical thread (GitHub issues, discussions and PR comments, Hugging Face discussions, forums) read by engineers you do not know. Use when replying to such a thread (コメントに返信).

The file

Files
SKILL.md

public-comment — 公開技術スレッドへの返信規約

公開の技術ピア議論(GitHub discussions / issues / PR コメント、HF discussions、フォーラム)に返信するときの規約。genre を定義するのはプラットフォームではなく読者との関係: 初対面の技術者が、slop 検知器を作動させながら読む公開スレッド。

前提: 2026 年の読者環境

読み手が検知しようとするのは AI ではなく「未レビュー・非所有の生ダンプ」で、tell はその代理指標。tell を 1 つ出すだけで、内容が読まれる前に discount される。除去の目的は人間の判断が通ったことをテキスト自体で示すこと。

Content Ownership(最上位規約)

他のすべての規約に優先する:

  • 自分が検証していない主張を書かない
  • 自分のものでない経験を書かない
  • 確認していない実装の詳細を書かない
  • コメントの実質は必ずユーザー自身のもの。AI は起草を補助するが、全ての claim にユーザーの実感・実装・検証が対応していること

切実さを装わない。自分の運用で当たらない問題には「私の運用では当たらない」と書く(scope 付き同意は、全面同意より議論への貢献が大きい)。

Disclosure

場の規範に従う:

  1. 投稿前に相手コミュニティの AI ポリシーを確認する(CONTRIBUTING.md / community guidelines / discussion のピン留め)
  2. 開示要求があれば従う
  3. なければ開示しない(content ownership が満たされている限り、道具の開示義務はない)

文体規約

語彙・構造の tell リストの正本は ~/MyAI_Lab/zenn-content/.claude/skills/writing-ecosystem/references/style-diagnostics.md、原則は執筆の背骨 ~/MyAI_Lab/zenn-content/.claude/rules/writing-principles.md の 2 — ここに複製しない。コメント genre 固有の追加分のみ:

  • スレッドの register に合わせる: 既存コメントの長さ・フォーマット水準を上限とする。自分の過去コメントがあるスレッドでは、その声との連続性も保つ(急な文体変化自体が不自然さの signal)
  • concede-first / net-giver の 3 拍: ①相手の nuance ある論点を具体的に認める → ②根拠ある価値を 1 つ足す(実例・反直感の史実・視覚的類推)→ ③鋭い一文で終える。リンク勧誘・「続きは私の記事で」をしない
  • 空の褒めを書かない: 「Great post!」だけのコメントは会話ノイズ。足す価値がないなら書かない
  • 1 コメント 1 コア主張: 網羅性は slop の匂い。論点が複数あるなら一番強いものに絞る
  • スレッド固有名詞への接地: 実在のコメント・実在の争点・実在の発言を引用して書く。判定: 「このコメントは別のスレッドに貼っても通じるか?」→ Yes なら接地不足(slop 判定原則のコメント版)
  • 宣伝をしない: 自作物への言及は議論に必要な場合のみ。リンクは求められてから
  • 句読点置換の禁止: 正本の「記号を置換せず文を再構成する」をそのまま適用する。コロンはリスト・定義・例示の前のみ
  • nuance 制御困難な口語を避ける: "steal" のような、ネイティブには友好イディオムでも文脈次第で刺々しく読まれうる語は、非ネイティブとして制御しきれないので使わない

投稿前チェック

3 層:

  1. 機械チェック(binary、fail = 修正):
    • em-dash(—): 0 件
    • 絵文字: 0 件
    • bold 見出しリード: スレッド register の範囲内(目安 ≤ 2)
    • 文中コロン(リスト・例示前を除く): 0 件
  2. 意味チェック:
    • style-diagnostics の Structural tells を 1 本ずつ当てる(構文の列挙はあちらが正本。 ここに写すと片方だけ更新されて分岐する)
    • 別スレッドに貼っても通じるコメントになっていないか(接地不足)
    • 全 claim にユーザーの実感・検証が対応しているか(content ownership)
  3. 人間 gate(外部書き込み、承認必須):
    • EN コメントは必ず日本語訳を併記して提示する(非英語話者のユーザーがニュアンスを確認できる形で)
    • ユーザーが全文を読んで承認してから投稿する。承認前に投稿コマンドを実行しない。 ここで判断するのは文章の巧拙ではなくこれを自分の声として出すか(コメント本文は 公開・不可逆で、テキストが意図そのもの)

投稿手段

  • GitHub discussion: gh api graphql の addDiscussionComment mutation。返信は同じ mutation に replyToId を渡す(addDiscussionCommentReply という mutation は存在しない)
  • GitHub issue / PR: gh issue comment / gh pr comment
  • HF discussions / フォーラム: ブラウザ経由(ユーザー手動 or Claude in Chrome、いずれも承認後)

Related

  • 語彙・構造 tell の正本: ~/MyAI_Lab/zenn-content/.claude/skills/writing-ecosystem/references/style-diagnostics.md(原則は背骨 ~/MyAI_Lab/zenn-content/.claude/rules/writing-principles.md)
  • 記事・エッセイ: writing-ecosystem / AI 向け doc: llms-txt-writer
  • EN 起草時の翻訳品質: prose-translation(長文の場合のみ。コメントは本 skill の日本語訳併記で足りる)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.