Skip to content

feat(skills): 人間が合意できる issue を作る create-issue スキルを追加 - #552

Merged
rito528 merged 1 commit into
mainfrom
feat/create-issue-skill
Aug 15, 2026
Merged

feat(skills): 人間が合意できる issue を作る create-issue スキルを追加#552
rito528 merged 1 commit into
mainfrom
feat/create-issue-skill

Conversation

@rito528

@rito528 rito528 commented Aug 15, 2026

Copy link
Copy Markdown
Owner

概要

  • AI が作る issue は情報量が多く断定調になりやすい一方、コード構造の分析・実装手順・agent の推論といった短寿命かつ未検証の記述が混ざりやすく、人間が全文を読んで合意する対象ではなくなりつつある
  • issue-agreement が実装前の乖離検出を担う一方、混入源である issue 作成時点を放置すると対症療法にとどまるため、issue 本文に残せる情報を人間が決めた要求・制約・前提・未決定事項に限定し、agent の推論を要求へ昇格させない create-issue スキルを config/agents/skills/ に追加した
  • home-manager 配備対象のディレクトリ配下に追加したのみで、modules/claude.nix / modules/agents.nix の配備定義は変更していない(ディレクトリごと配備される既存の仕組みに乗る)

確認事項

  • SKILL.md 追加のみで nix / shell の変更はないため nixfmt / shellcheck / home-manager build は対象外と判断した
  • コミット時の gitleaks フックと markdown lint(pre-commit)を通過済み

補足

  • スキルの内容は、issue に残してよい情報(ユーザーの要求・決定・長寿命な確認済みの事実・合意された仮定・未決定事項)と、残さない情報(コード構造、原因分析、実装手順、agent の推論、実装者が判断できる技術的選択)を分類基準として定義している
  • 実装開始時の照合は既存の issue-agreement スキルに委ねる役割分担とした

🤖 Generated with Claude Code

AI が作る issue は情報量が多く断定調になりやすい一方、コード構造の分析や
実装手順、agent の推論といった短寿命かつ未検証の記述が混ざりやすく、人間が
全文を読んで合意する対象ではなくなりつつある。issue-agreement が実装前の
乖離検出を担う一方で、混入源である issue 作成時点を放置すると対症療法に
とどまるため、issue 本文に残せる情報を人間が決めた要求・制約・前提・
未決定事項に限定し、agent の推論を要求へ昇格させない create-issue スキルを
切り出した。

Co-authored-by: Claude <[email protected]>
@rito528
rito528 merged commit 3ce8515 into main Aug 15, 2026
9 checks passed
@rito528
rito528 deleted the feat/create-issue-skill branch August 15, 2026 14:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant