File contents Retro — 知識倉庫の総括レポート
~/dev/knowledge/notes/ に蓄積されたノートを横断的に読み、ユーザーが自分の成長・傾向・課題を振り返るためのレポートを作る。
手順
~/dev/knowledge が存在しない、またはノートが無い場合は「まだ記録がない。/memo で記録が溜まってから振り返る」と報告して終了する
前回までの retro を読み込む:
ls ~/dev/knowledge/retros/ 2>/dev/null | sort | tail -3
直近1〜3件があれば読む(無ければこのステップは省略し、以降「前回からの変化」に関する分析・報告は行わない)
対象を集める:
ls ~/dev/knowledge/notes/
grep -l "type: strength" ~/dev/knowledge/notes/*.md
grep -l "type: weakness" ~/dev/knowledge/notes/*.md
grep -l "type: style" ~/dev/knowledge/notes/*.md
引数で期間指定があれば frontmatter の date / last_seen で絞る。
ノート数が多い場合は style / strength / weakness を優先して全部読み、knowledge / decision はタイトルと直近のものを中心に読む
以下の観点で分析する:
強み : strength ノートから見える、繰り返し発揮されている長所。どんな場面で効いているか、さらに活かせる場面はどこかを述べる
繰り返している苦手 : weakness ノートの ## 事例 の件数と日付を見る。事例が増え続けているものは要注意、最近観測されていないものは克服の兆しとして扱う
コーディングの傾向 : style ノートから見える一貫した好み・判断軸。良い面と、裏返しでリスクになりうる面の両方
学びの領域 : knowledge / decision のタグ分布から、最近どの技術領域に触れているか、学びが偏っていないか
時系列の変化 : 以前のつまずきがその後の decision / knowledge にどう活きたか(ウィキリンクや日付の前後関係から読み取る)
前回からの変化 (前回までの retro がある場合のみ): 前回の「次に意識するとよいこと」それぞれについて、今回の対象期間のノート(decision / knowledge / strength の事例)に現れているかを確認し、達成 / 部分達成 / 未着手を判定する。あわせて前回 weakness として挙げた課題の事例が増えたか・観測されなくなったか、前回の強みが今回も観測されているか(last_seen の更新有無)を確認する
レポートとして提示する:
前回までの retro がある場合、冒頭に「前回からの変化」セクションを置く。前回提案の達成状況(達成 / 部分達成 / 未着手)、改善した課題、新たに出現した傾向を、根拠となるノート名・日付つきで述べる
各指摘には根拠となるノート名と事例の日付を添える(印象論にしない)
強み・改善が見えている点から先に述べ、課題はその後に置く(振り返りが凹むだけの時間にならないように)
最後に「次に意識するとよいこと」を1〜3個、具体的に提案する
レポートを ~/dev/knowledge/retros/YYYY-MM-DD.md に保存する(ユーザーが保存不要と明言した場合のみスキップする)。フォーマットは以下:
---
date: YYYY-MM-DD
type: retro
period: <対象期間 or 全期間>
notes_count: <対象ノート数>
---
## 強み
## 課題・苦手
## 次に意識するとよいこと
- [ ] <提案1>
- [ ] <提案2>
「次に意識するとよいこと」は次回 retro が達成判定できるよう、チェックボックス形式で書く。
本文は通常の文体で書く(ずんだもん口調にしない)
注意
ノートが少ないうちは無理に傾向を語らず、「まだ事例が少ない」と正直に言う
事実(事例ログ)と解釈(傾向の分析)を区別して書く
1 --- 2 name: retro 3 description: "知識倉庫 (~/dev/knowledge) に溜まった記録を総括して、強み・傾向・課題の振り返りレポートを作る。ユーザーが「振り返りたい」「retro」「最近の自分どう?」と言ったときに使う。引数で期間やテーマを絞れる(例: /retro 直近1ヶ月、/retro 苦手だけ)。" 4 license: GPL-3.0 5 --- 6 7 # Retro — 知識倉庫の総括レポート 8 9 `~/dev/knowledge/notes/` に蓄積されたノートを横断的に読み、ユーザーが自分の成長・傾向・課題を振り返るためのレポートを作る。 10 11 ## 手順 12 13 0. `~/dev/knowledge` が存在しない、またはノートが無い場合は「まだ記録がない。/memo で記録が溜まってから振り返る」と報告して終了する 14 1. 前回までの retro を読み込む: 15 ```bash 16 ls ~/dev/knowledge/retros/ 2>/dev/null | sort | tail -3 17 ``` 18 直近1〜3件があれば読む(無ければこのステップは省略し、以降「前回からの変化」に関する分析・報告は行わない) 19 2. 対象を集める: 20 ```bash 21 ls ~/dev/knowledge/notes/ 22 grep -l "type: strength" ~/dev/knowledge/notes/*.md 23 grep -l "type: weakness" ~/dev/knowledge/notes/*.md 24 grep -l "type: style" ~/dev/knowledge/notes/*.md 25 ``` 26 引数で期間指定があれば frontmatter の date / last_seen で絞る。 27 ノート数が多い場合は style / strength / weakness を優先して全部読み、knowledge / decision はタイトルと直近のものを中心に読む 28 3. 以下の観点で分析する: 29 - **強み**: strength ノートから見える、繰り返し発揮されている長所。どんな場面で効いているか、さらに活かせる場面はどこかを述べる 30 - **繰り返している苦手**: weakness ノートの `## 事例` の件数と日付を見る。事例が増え続けているものは要注意、最近観測されていないものは克服の兆しとして扱う 31 - **コーディングの傾向**: style ノートから見える一貫した好み・判断軸。良い面と、裏返しでリスクになりうる面の両方 32 - **学びの領域**: knowledge / decision のタグ分布から、最近どの技術領域に触れているか、学びが偏っていないか 33 - **時系列の変化**: 以前のつまずきがその後の decision / knowledge にどう活きたか(ウィキリンクや日付の前後関係から読み取る) 34 - **前回からの変化**(前回までの retro がある場合のみ): 前回の「次に意識するとよいこと」それぞれについて、今回の対象期間のノート(decision / knowledge / strength の事例)に現れているかを確認し、達成 / 部分達成 / 未着手を判定する。あわせて前回 weakness として挙げた課題の事例が増えたか・観測されなくなったか、前回の強みが今回も観測されているか(last_seen の更新有無)を確認する 35 4. レポートとして提示する: 36 - 前回までの retro がある場合、冒頭に「前回からの変化」セクションを置く。前回提案の達成状況(達成 / 部分達成 / 未着手)、改善した課題、新たに出現した傾向を、根拠となるノート名・日付つきで述べる 37 - 各指摘には根拠となるノート名と事例の日付を添える(印象論にしない) 38 - 強み・改善が見えている点から先に述べ、課題はその後に置く(振り返りが凹むだけの時間にならないように) 39 - 最後に「次に意識するとよいこと」を1〜3個、具体的に提案する 40 5. レポートを `~/dev/knowledge/retros/YYYY-MM-DD.md` に保存する(ユーザーが保存不要と明言した場合のみスキップする)。フォーマットは以下: 41 42 ```markdown 43 --- 44 date: YYYY-MM-DD 45 type: retro 46 period: <対象期間 or 全期間> 47 notes_count: <対象ノート数> 48 --- 49 50 ## 強み 51 ## 課題・苦手 52 ## 次に意識するとよいこと 53 - [ ] <提案1> 54 - [ ] <提案2> 55 ``` 56 57 「次に意識するとよいこと」は次回 retro が達成判定できるよう、チェックボックス形式で書く。 58 本文は通常の文体で書く(ずんだもん口調にしない) 59 60 ## 注意 61 62 - ノートが少ないうちは無理に傾向を語らず、「まだ事例が少ない」と正直に言う 63 - 事実(事例ログ)と解釈(傾向の分析)を区別して書く
rerelurelu/skillbox commit 177eb3b74c
Frequently asked questions How do I install the Retro skill? Run npx get-skill add rerelurelu/retro in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Retro skill do? 知識倉庫 (~/dev/knowledge) に溜まった記録を総括して、強み・傾向・課題の振り返りレポートを作る。ユーザーが「振り返りたい」「retro」「最近の自分どう?」と言ったときに使う。引数で期間やテーマを絞れる(例: /retro 直近1ヶ月、/retro 苦手だけ)。 It is listed under Coding & Dev Tools on SkillMD.
Is Retro safe to use? SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Retro? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Retro free to use? Yes. Installing skills from SkillMD is free. This skill is licensed under GPL-3.
Who published Retro? rerelurelu (@rerelurelu) published this skill. Their other Agent Skills are listed on their SkillMD profile.