改善トラッキング

プロジェクトの改善提案、実装済み改善、効果測定を管理するスキルです。

When to Use

• コード品質の改善を提案・記録したいとき
• リファクタリングの進捗を追跡したいとき
• 技術的負債を管理・解消したいとき
• パフォーマンス最適化の結果を記録したいとき
• 定期的な改善レビューを行うとき

Instructions

1. 改善記録の確認

改善は 1 改善 1 ファイルで references/improvements/ に保存されています。

まず references/improvements/README.md（索引）を読み、関連しそうな記録だけを個別に開いてください。索引が存在しない場合や移行中のプロジェクトでは、レガシーな references/IMPROVEMENTS_TEMPLATE.md にも記録が残っている可能性があります。

2. 改善の記録テンプレート

新しい改善は references/improvements/YYYY-MM-DD-スラッグ.md として作成します。

---
title: "改善タイトル"
description: "" # 1 行サマリを記入
tags: [improvement]
status: 提案
updated: YYYY-MM-DD
---

# 背景

# 改善内容

# 効果

- **Before**:
- **After**:
- **改善率**:

# ステータス

提案 / 実装中 / 完了 / 保留

ステータスが変わったら frontmatter の status と updated を更新します。ファイル名は変えません。

3. 改善の追加

ひな形の生成と索引の更新は scripts/add-improvement.sh が行います:

bash .agents/skills/improvement-tracking/scripts/add-improvement.sh "改善タイトル"
# （.claude/skills / .cursor/skills も検出対象）

4. 定期レビュー

以下のサイクルで改善活動をレビューしてください:

• 週次: 新たな改善提案の確認
• 月次: 実装済み改善の効果測定
• 四半期: 技術的負債の棚卸し

定期レビューには /review-knowledge の利用を案内してください。

5. アクションスキルとの連携

改善の記録には /log-improvement の利用を案内してください。