Agent skill

issue-size-estimation

Issue粒度判定とコード行数見積もりの基準、サイズラベル、分割判定ロジックを定義

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/issue-size-estimation

SKILL.md

Issue粒度判定 & コード行数見積もり

参照元: 実装ワークフローの粒度判定ロジック

概要

実装タスクは200行以下のIssueを対象とすることを推奨する。 大きなIssueは事前に /decompose-issue で分解してから実行すること。

粒度判定基準

粒度 対応
200行以下 直接実装可能
200行超 /decompose-issue で分割してから実装
新規設計 /detailed-design-workflow で設計時に適切な粒度でIssue作成

粒度ルール

項目 基準
コード量 200行以下
ファイル数 1-3ファイル
責務 単一責務（1つの機能・1つの目的）
テスト可能性 独立してテスト可能
所要時間目安 10-15分で実装完了

サイズラベル

プロジェクトで以下のラベルを使用することを推奨:

ラベル 目安行数 対応
size/xs ~50行 直接実装
size/s ~100行 直接実装
size/m ~200行 直接実装（境界）
size/l ~400行 要分割
size/xl ~800行以上 要分割

行数見積もり方法

優先順位:

  1. Issue labelsから推定（size/* ラベル）
  2. 設計書のコードブロックから推定
  3. Issueタイトル・本文のキーワードから推定

キーワードベース推定:

キーワード 推定行数
fix ~50行
update ~80行
add ~100行
refactor ~150行
create ~150行
implement ~200行

分割判定

python
def should_decompose(issue_id: int) -> bool:
    """分割が必要かどうか判定"""
    estimated = estimate_code_lines(issue_id)
    return estimated > 200

大きなIssueを見つけた場合

bash
# 1. まず分解コマンドを実行
/decompose-issue 8

# 2. 作成されたSubtaskを実装
# (各Subtaskを順次実装)

リトライポリシー

条件 アクション
Issue失敗（1-2回目） リトライ
Issue失敗（3回目） Draft PRを作成、ユーザーに報告
複数Issue並列時 失敗したIssueのみ報告、他は継続

Didn't find tool you were looking for?

Be as detailed as possible for better results