Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions issues/ndf-development-skills/01-overview.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -37,9 +37,9 @@
1. **既存 Skill の棚卸** — 49 個ある Skill の重複統合、利用実績の乏しい Skill の整理、frontmatter の見直し
2. **開発方法論レイヤーの追加** — 8 個の Skill を新設し、要求定義から検証までの工程を埋める
3. **既存 Skill の改修** — 新レイヤーへの接続
4. **一気通貫実行の整備** — ランタイム組み込みの `/goal` ループを土台に、設計確定後からリリース直前までを自動で進める `execute-plan` を新設する
4. **一気通貫実行の整備** — ランタイム組み込みの `/goal` ループを土台に、設計確定後からリリース直前までを自動で進める `execute-goal` を新設する

新設する Skill は、項目 2 の開発方法論レイヤー 8 個と項目 4 の `execute-plan` 1 個をあわせた計 9 個である。段階ごとの Skill 総数は [02-skill-inventory.md](02-skill-inventory.md)「Skill 総数の推移」を唯一の基準とし、本文書では数値を書き下さない。
新設する Skill は、項目 2 の開発方法論レイヤー 8 個と項目 4 の `execute-goal` 1 個をあわせた計 9 個である。段階ごとの Skill 総数は [02-skill-inventory.md](02-skill-inventory.md)「Skill 総数の推移」を唯一の基準とし、本文書では数値を書き下さない。

外部リポジトリは submodule やコピーで取り込まず、独自の Skill として再執筆し、参照元は `upstream-skills.lock.yaml` で固定する。

Expand Down
12 changes: 8 additions & 4 deletions issues/ndf-development-skills/02-skill-inventory.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -65,10 +65,14 @@ review-pr-comments, skill-stats

### 測定ツールの不具合

`skill-stats` は次の 2 点でこの測定に使えず、集計は個別に実装した。Task 0-1 の前提となるため、修正するか置き換えるかの判断が要る
`skill-stats` は次の 2 点でこの測定に使えず、上表の集計は個別に実装した。置き換えではなく `skill-stats` 自体を修正し、以降の計測はこのツールへ一本化する(Task 0-1

- 49 個中 48 個で `when_to_use` からのトリガ抽出に失敗し、ヒット率が算出されない
- 利用者のスラッシュコマンドを数えず、エージェントの自動起動しか数えない。`cross-review` を 14 と報告するが実際は 285
| 不具合 | 原因 |
| --- | --- |
| 49 個中 48 個でトリガ抽出に失敗し、ヒット率が算出されない | 抽出対象が `description` に限られ、トリガ語を列挙している `when_to_use` を読まない。トリガ語が `description` にあるのは 1 個だけで、34 個は `when_to_use` に置かれている(残る 14 個は `when_to_use` 自体がない)。加えて抽出パターンが `Triggers:` 表記に限られるため、`明示トリガ:` と書いている `cross-review` は `when_to_use` を読んでも拾えない |
| 利用者の明示起動を数えず、`cross-review` を 14 と報告する(実測は 285) | 明示起動は会話ログに `<command-name>/ndf:cross-review</command-name>` を含む利用者メッセージとして残るが、これをシステム由来の記述として除外している。数えているのはエージェントによる `Skill` ツール呼び出しだけである |

トリガ語の所在は `grep -l '^description:.*[Tt]riggers\?:' */SKILL.md`(1 件)と `grep '^when_to_use:' */SKILL.md | grep -ci 'triggers\?:'`(34 件)で確認した。明示起動の形式は会話ログ 1,938 セッションから `<command-name>` を集計して確認しており、`/ndf:cross-review` 273 件、`/ndf:merged` 249 件が現れる。

## 整理の判断基準

Expand DownExpand Up@@ -146,7 +150,7 @@ review-pr-comments, skill-stats
| 区分 | 個数 | 定義場所 |
| --- | --- | --- |
| 開発方法論レイヤー | 8 | [04-development-skills.md](04-development-skills.md) |
| 一気通貫実行(`execute-plan`) | 1 | [05-goal-workflow.md](05-goal-workflow.md) |
| 一気通貫実行(`execute-goal`) | 1 | [05-goal-workflow.md](05-goal-workflow.md) |

## 発動改善

Expand Down
6 changes: 3 additions & 3 deletions issues/ndf-development-skills/04-development-skills.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -2,7 +2,7 @@

用語は [01-overview.md](01-overview.md) を参照。

本文書が扱うのは開発方法論レイヤーの 8 個である。新設する Skill はこれに一気通貫実行の `execute-plan`([05-goal-workflow.md](05-goal-workflow.md))1 個を加えた計 9 個であり、段階ごとの Skill 総数は [02-skill-inventory.md](02-skill-inventory.md)「Skill 総数の推移」を参照する。
本文書が扱うのは開発方法論レイヤーの 8 個である。新設する Skill はこれに一気通貫実行の `execute-goal`([05-goal-workflow.md](05-goal-workflow.md))1 個を加えた計 9 個であり、段階ごとの Skill 総数は [02-skill-inventory.md](02-skill-inventory.md)「Skill 総数の推移」を参照する。

## 新設する Skill

Expand DownExpand Up@@ -130,9 +130,9 @@ ramziddin/solid-skills の「メソッド 10 行未満」「インスタンス
| `skills/pr-tests/SKILL.md` | 限定的な検証と全体テストを区別。実行コマンド・終了コード・実行時刻を証跡として残す | 1-7 |
| `skills/plan-to-spec/SKILL.md` | ドメイン用語集、不変条件、公開インタフェース、設計判断記録の結論を確定仕様へ引き継ぐ | 1-7 |
| `skills/investigation-rules/SKILL.md` | トリガ `'調査'` を具体化し、`problem-solving` との境界を明記 | 1-7 |
| `skills/cross-review/SKILL.md` | 起動対象を `architecture` モード相当の高リスク変更に限定。同じ基準で `execute-plan` のレビュー段階も分岐する([05-goal-workflow.md](05-goal-workflow.md)) | 2-4 |
| `skills/cross-review/SKILL.md` | 起動対象を `architecture` モード相当の高リスク変更に限定。同じ基準で `execute-goal` のレビュー段階も分岐する([05-goal-workflow.md](05-goal-workflow.md)) | 2-4 |
| `plugins/ndf-claude/agents/director.md` | モード判定は自前で持たず、`development-workflow` を呼んで判定させる。返ったモードに対応する Skill を起動する手順だけを書く | 2-4 |
| `skills/issue-plan-strategy/SKILL.md` | `execute-plan` から呼ばれる手順として整理し、責務の境界を明記。組み込みの `/goal` ループから直接駆動される実績(8 回)があるため、ターンをまたいで再開できる記述にする | 3-1 |
| `skills/issue-plan-strategy/SKILL.md` | `execute-goal` から呼ばれる手順として整理し、責務の境界を明記。組み込みの `/goal` ループから直接駆動される実績(8 回)があるため、ターンをまたいで再開できる記述にする | 3-1 |

`review` の二段構成:

Expand Down
Loading
Loading