AgentSkillsCN

task-report

>

SKILL.md
--- frontmatter
name: task-report
description: >
  タスク完了時にレポートファイルを作成し、蓄積する。
  進めたタスクの報告と次のタスクの詳細解説を目的とする。
  **通し番号でナンバリングして履歴を追跡可能にする。**
inputs:
  - 完了したタスクの内容
  - 変更したファイル一覧
  - 次のタスク候補
  - 既存レポートの最大番号
outputs:
  - docs/triad/REPORT-<NNN>-<YYYYMMDD>-<slug>.md
rules:
  - タスク完了ごとに必ず作成
  - 蓄積して履歴として参照可能にする
  - 次のタスクをより詳細に解説
  - **通し番号は3桁ゼロ埋め（001, 002, ...）**

task-report

目的

タスク完了時に、進めたタスクの報告と次のタスクの詳細解説を文書化し、蓄積する。

使用タイミング

  • •各タスク完了時（TRIAD_HANDOFF と併用可）
  • •特に複雑なタスクや設計判断があった場合

ファイル命名規則

形式

code
docs/triad/REPORT-<NNN>-<YYYYMMDD>-<slug>.md
部分説明例
<NNN>3桁通し番号（ゼロ埋め）001, 002, 010
<YYYYMMDD>日付20260123
<slug>タスク概要（ハイフン区切り）c-e-separation

例

code
REPORT-001-20260123-c-e-separation.md
REPORT-002-20260123-wall-type-mapping.md
REPORT-003-20260124-implementation.md

番号の決定方法

  1. •docs/triad/REPORT-*.md を検索
  2. •最大番号を取得
  3. •+1 して新しい番号を付与

Output Template

markdown
# Task Report: <タスク名>

> **Report**: #<NNN>
> **Date**: YYYY-MM-DD HH:MM
> **Type**: {DesignDraft / Observation / Implementation / DocsOnly}
> **Status**: DONE

---

## 1. What was done

### 概要
<1-2行での要約>

### 変更ファイル一覧
| ファイル | 変更内容 |
|---------|---------|
| `path/to/file` | <変更概要> |

---

## 2. 設計検討の詳細 (REQUIRED)

### 問題の背景
<なぜこのタスクが必要だったか、何が問題だったか詳細に説明>

### 検討した選択肢
| 選択肢 | メリット | デメリット | 採否 |
|-------|---------|-----------|------|
| 案A   | ...     | ...       | ✅ 採用 |
| 案B   | ...     | ...       | ❌ 不採用 |

### 採用理由
<なぜこの案を選んだか、トレードオフの判断根拠>

---

## 3. 実装の詳細 (REQUIRED)

### アーキテクチャ / 構造
<モジュール構成、データフロー、依存関係などを図や箇条書きで説明>

例: データフロー B層 (WallRelation) ↓ マッピング C層 (WallRole) ↓ 翻訳 E層 (WallPresentationClass) ↓ F層 (DrawProfile → 図面)

code

### 主要な型 / 関数
| 型 / 関数 | 場所 | 責務 |
|----------|------|------|
| `TypeName` | `path/to/file.rs` | <一言で責務> |

### コード変更のポイント
<難しかった点、工夫した点、注意が必要な点>

---

## 4. Codex Review (if applicable)

### レビューラウンド概要
| Round | 主な指摘 | 分類 | 対応 |
|-------|---------|------|------|
| 1 | <指摘1> | 同意 ✅ | <対応内容> |

### 重要な指摘と対応詳細
<特に重要な指摘とその対応について詳細に記載>

---

## 5. テスト / 検証

### 実行したテスト
- [ ] `cargo test` - 結果: X passed
- [ ] 手動検証: <内容>

### 確認したシナリオ
<どのような状況で動作確認したか>

---

## 6. 技術的負債 / Future Work

| 項目 | 理由 | 優先度 |
|-----|------|-------|
| <負債1> | <なぜ今回対応しなかったか> | Low/Medium/High |

---

## 7. Next Task (詳細)

### 概要
<次のタスクの説明>

### 背景
<なぜこのタスクが必要か>

### 具体的なアクション
1. <Step 1>
2. <Step 2>

### 関連ファイル
- `path/to/file`: <役割>

---

## 8. Links
- 関連 TRIAD_HANDOFF: <path>
- 関連 STATUS.md セクション: <section>
- 関連設計文書: <path>

注意

  • •TRIAD_HANDOFF とは別の目的（HANDOFF は引き継ぎ、REPORT は記録）
  • •次のタスクの解説を充実させることで、セッション間の連続性を確保

次に使う Skill

  • •status-todo-loop（STATUS 更新）
  • •triad-handoff（引き継ぎ票）