Skip to content

feat: skills の一律強制を縮小し内容を現行世代に更新(#116、v0.66.0)#131

Merged
okash1n merged 1 commit into
mainfrom
issue/116-skills-update
Jun 12, 2026
Merged

feat: skills の一律強制を縮小し内容を現行世代に更新(#116、v0.66.0)#131
okash1n merged 1 commit into
mainfrom
issue/116-skills-update

Conversation

@okash1n

@okash1n okash1n commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

概要

LLM 性能監査計画 #121 の P3-10(#116)。8 findings 対応。

変更内容

  • tdd-workflow: 「全作業(バグ修正・リファクタ含む)に TDD + 80% 一律強制」→「明示要求時 or カバレッジ要件のある新機能」に限定。絶対表現を緩和し 80% は「プロジェクト基準の目安」に。npm 固定をスタック別例示化。agents/tdd-guide.md の description もスキルの新スコープに整合(レビュー指摘反映)
  • verification-loop: 6 観点・レポート様式は維持。固定コマンドと | tail -20 指定を例示に降格。grep "sk-" 式 secret 検査を gitleaks/trufflehog → security-review skill → diff 追加行確認に置換。実行不能な「15 分ごと検証」Continuous Mode を削除
  • eval-harness: pass@k / pass^k の手書き記録・1-5 自己採点を削除(PASS (attempts: N) に改名、Model Grader は YES/NO チェックリスト化)。「本当に測るなら headless 自動実行で」と注記
  • prompt-patterns: ultrathink キーワード詠唱の機構説明を Deep Reasoning(Plan Mode / harness の thinking・effort 制御 / 自然言語)に置換。「Estimated context usage」→「Rollback plan」
  • frontend-patterns: メモ化を React Compiler 未採用条件付きに(SKILL.md + references/state-performance.md の両方に注記)。手書き useQuery を TanStack Query v5(isPending)/ SWR の最小例に置換。framer-motion → motion('motion/react')
  • project-guidelines-example: claude-sonnet-4-5-20250514(実在しない疑いのある ID)→ claude-opus-4-8 + 「公式 docs で最新確認」コメント

レビュー指摘の判断

内部レビュー(code-reviewer agent)4 件のうち:

  • 採用: tdd-guide description の整合、state-performance.md への Compiler 注記、TanStack/SWR のバージョンコメント
  • 不採用(誤検知): 「/loop コマンドは存在しない」→ /loop は Claude Code 本体のスラッシュコマンドで実在。「claude-opus-4-8 は実在しない」→ 現行の実在モデル ID(レビュアーの知識カットオフ起因)

検証

  • unit 342/342 / scenarios 44 Pass + 1 Skip

Closes #116

- tdd-workflow: 全作業一律 TDD+80% を明示要求時/カバレッジ要件時に限定(tdd-guide agent の description も整合)
- verification-loop: 固定コマンド・出力打ち切り指定を例示化、grep secret 検査を専用ツール委譲に、Continuous Mode 削除
- eval-harness: 測定不能な pass@k 手書き記録と 1-5 自己採点を削除(attempts: N に改名)
- prompt-patterns: ultrathink 詠唱説明を Deep Reasoning(Plan Mode / harness 制御)に置換
- frontend-patterns: React Compiler 条件付きメモ化、手書き useQuery → TanStack Query/SWR、motion 改称
- project-guidelines-example: モデル ID を claude-opus-4-8 + 確認コメントに修正

Closes #116
Copilot AI review requested due to automatic review settings June 12, 2026 03:08
@okash1n okash1n merged commit d5e5f9f into main Jun 12, 2026
11 checks passed
@okash1n okash1n deleted the issue/116-skills-update branch June 12, 2026 03:10

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

skills の記述を「現行世代の Claude Code 前提」に合わせて更新し、旧世代向けの過剰な一律強制・儀式・陳腐化した前提を削減する PR(#116 / v0.66.0)です。監査計画 #121(P3)で見つかった指摘に沿って、スキルの適用条件や例示コマンド、評価/検証の方法をより成果指向に整理しています。

Changes:

  • tdd-workflow / tdd-guide の適用条件を「明示要求時 or カバレッジ要件のある新機能」に限定し、絶対表現・固定コマンドを緩和
  • verification-loop の固定コマンド/出力打ち切りや単純 grep を撤廃し、security-review skill や diff 追加行レビュー中心に更新(Continuous Mode 削除)
  • eval-harness / prompt-patterns / frontend-patterns の陳腐化前提(pass@k 手書き、ultrathink 呪文、手書き fetch hook、Framer Motion 表記など)を現行の説明へ刷新し、CHANGELOG に 0.66.0 を追加

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
skills/verification-loop/SKILL.md 検証フェーズを成果指向にし、固定コマンド/grep 検査/Continuous Mode を整理
skills/tdd-workflow/SKILL.md TDD の適用範囲を明示要求・要件あり新機能に限定し、例示コマンドを一般化
agents/tdd-guide.md guide の description を新しい適用スコープに整合
skills/eval-harness/SKILL.md pass@k/pass^k の手書き・数値自己採点を削除し、試行回数/チェックリスト方式へ
skills/prompt-patterns/SKILL.md ultrathink 機構説明を Deep Reasoning(Plan Mode/effort 制御/自然言語)へ置換
skills/frontend-patterns/SKILL.md React Compiler 前提のメモ化注記、server state ライブラリ推奨、motion への更新
skills/frontend-patterns/references/state-performance.md React Compiler 利用時のメモ化不要注記を追記
skills/frontend-patterns/references/hooks-patterns.md 手書き fetch hook を TanStack Query/SWR の最小例へ置換
skills/frontend-patterns/references/forms-errors-a11y.md Framer Motion 表記を motion(motion/react)へ更新
skills/project-guidelines-example/references/code-patterns.md 例示モデル ID を更新し、公式 docs 参照注記を追加
CHANGELOG.md v0.66.0 の変更点を追記

Comment on lines +33 to 38
```typescript
// SWR (2.x: isLoading)
import useSWR from 'swr'

return { data, error, loading, refetch }
}
const { data, error, isLoading } = useSWR(`/api/users/${userId}`, fetcher)
```
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.

[P3-10] skills の一律強制の縮小と内容の鮮度更新

2 participants