memo-reference
/memo-reference
MEMO の既存メモを参照・検索・部分修正するときに使う。「前に〜のメモ書いたよね」「MEMO に〜ってある?」「〜のメモを踏まえて説明して」「〜のメモのこの部分を直して」など。HTML ではなく Markdown 版(dist/md/。build で作る)を読み、直すときは HTML の該当箇所だけを読んで編集する。
- Author
- taka1156 ↗
- Repository
- memo-kit ↗
- Licence
- MIT
- Last repository change
- 12.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
MEMO の既存メモを参照・検索・部分修正するときに使う。「前に〜のメモ書いたよね」「MEMO に〜ってある?」「〜のメモを踏まえて説明して」「〜のメモのこの部分を直して」など。HTML ではなく Markdown 版(dist/md/。build で作る)を読み、直すときは HTML の該当箇所だけを読んで編集する。
Original author description
MEMO の既存メモを参照・検索・部分修正するときに使う。「前に〜のメモ書いたよね」「MEMO に〜ってある?」「〜のメモを踏まえて説明して」「〜のメモのこの部分を直して」など。HTML ではなく Markdown 版(dist/md/。build で作る)を読み、直すときは HTML の該当箇所だけを読んで編集する。
How it works
- 前提: Markdown 版とは
- 1. 探す
- 2. 読む
- 3. 答える・案内する
- 4. 部分修正
SKILL.md preview
---
name: memo-reference
description: MEMO の既存メモを参照・検索・部分修正するときに使う。「前に〜のメモ書いたよね」「MEMO に〜ってある?」「〜のメモを踏まえて説明して」「〜のメモのこの部分を直して」など。HTML ではなく Markdown 版(dist/md/。build で作る)を読み、直すときは HTML の該当箇所だけを読んで編集する。
---
# memo-reference
既存のメモを読むときは **Markdown 版** を使う。HTML は CSS・SVG・JS 込みで本文の 3〜4 倍の重さがあるので、読むためだけに開かない。
直すときは HTML が元データなので HTML を編集するが、ファイル全体ではなく**該当箇所だけ**を読む。
## 前提: Markdown 版とは
`python3 scripts/memo.py build` が HTML から `dist/` に自動生成する(手で編集しない。次の build で上書きされる)。`dist/` はコミットされないので、**clone した直後は無い。最初に必ず build する**(数秒)。
| ファイル | 中身 |
| --- | --- |
| `dist/llms.txt` | 全メモの目次。タイトル・説明・タグ・日付と、各 Markdown 版へのリンク |
| `dist/md/NAME.md` | 1 本のメモ。冒頭にタイトル・説明・元ページの URL・タグ・日付、続けて本文 |
本文の読み方:
- `(図: A / B / C → URL#id)` … SVG の図。ラベルと、図がある節へのリンク
- `(元のページで操作できます → URL#id)` … ボタンやチェックボックスなど、触って動くパーツがある節
- `## ページ内のデータ(JavaScript で描画される部分)` … 本文を JS で描画するページは、スクリプトをそのまま載せている
- **入っていないもの**: JS の中にだけある文章(タップで出る説明文など)。必要なときだけ HTML の `<script>` を見る
## 1. 探す
```bash
cd "$(git rev-parse --show-toplevel)"
python3 scripts/memo.py build # dist/ に Markdown 版を作る(src/ は書き換えない)
```
- まず `dist/llms.txt` を読む(全体で十数 KB)。タイトル・説明・タグで当たりをつける。
- 言葉で探すなら `dist/md/` を Grep する(`-n` で行番号つき)。言い回しが違いそうなら、同義語・英語表記でも探す。
- 見つからなければ「MEMO にはない」と伝える。似たメモがあればそれを挙げる。
## 2. 読む
- `python3 scripts/memo.py path NAME --md` のファイルを読む。HTML は開かない。
- 長いメモで一部だけ必要なら、Grep で見出し(`^## `)の行番号を出し、その節だけ読む。
- Markdown 版が古い疑いがあるとき(HTML を手元で編集した直後など)は、先に `python3 scripts/memo.py build` を実行する。`build --check` で最新か確かめられる。
HTML を読むのは次のときだけ:
- JS の中にだけある文章が必要なとき
- 見た目・レイアウト・動きについて聞かれたとき
- 修正するとき(下の 4.)
## 3. 答える・案内する
- メモの内容を自分の言葉でまとめて答え、どのメモに基づくかを示す。Markdown 版をそのまま貼らない。
- 図が説明の助けになる箇所では、Markdown 版の `→ URL#id` のリンクを添えて「図はここ」と案内する。MEMO の売りは図解なので、文章で説明しきろうとせず元ページに誘導してよい。
- メモの記述が古そう・怪しいと気づいたら、答えとは別にそう伝える(直すかどうかはユーザーに聞く)。
## 4. 部分修正
1. **場所を特定する**: Markdown 版で直す箇所と、その節の見出しを見つける。
2. **HTML の該当箇所だけ読む**: `python3 scripts/memo.py path NAME` の HTML を、見出しの id(`id="overlayfs"` など。Markdown 版のリンクの `#` 以降)か、直したい文言そのもので Grep(`-n`)する。ヒットした行の前後だけを Read の offset / limit で読む(目安 50〜100 行)。
3. **該当部分だけ書き換える**: Edit で文字列を置き換える。ファイル全体を書き直さない。構成・デザイン・クラス名は変えない。
4. 次の場合は HTML 全体を読んでよい: デザインやレイアウトの崩れを直す、構成を組み替える、JS で動く部分を直す、複数の節にまたがって直す。
5. **ファクトチェックする**: 本文の記述を変えたときは、push の前に memo-factcheck の「push の前」の手順で、変えた箇所をチェックする(見た目・崩れだけの修正や、タイトル・タグだけの変更は不要)。指摘があれば確認してから直す。
6. **反映する**:
```bash
python3 scripts/memo.py lint NAME # OK になること
python3 scripts/memo.py build # dist/ を作り直す(Markdown 版を読み直すため。コミットはしない)
BRANCH="$(python3 scripts/memo.py config branch)" # push 先(memo.config.json)
[ "$(git branch --show-current)" = "$BRANCH" ] || { echo "今いるブランチが $BRANCH ではないので止める(commit も push もせずにユーザーに確認する)"; exit 1; }
git fetch origin "$BRANCH" # 遅れていれば rebase
git add "$(python3 scripts/memo.py path NAME)" # このメモの原本だけ(複数なら 1 本ずつ)。dist/ はコミットしない
git status --short # 対象以外の変更(下書きなど)がステージされていないか確かめる
git commit -m "Update memo: <タイトル>"
git push origin "$BRANCH"
```
- `memo:date` は更新しない(作成日のまま)。タイトルや説明が変わる修正なら `memo.py meta` で直す。
- 報告は短く: 何を直したか、ファクトチェックの結果、公開 URL(`python3 scripts/memo.py url NAME`)。
Versions
The database has no other skills named memo-reference.
Database snapshot: 13.11.2026 · package version 3f29f32c2a53 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90markdown-to-html
Create, implement, or review markdown to html work with format, accessibility, performance, and visual-verification controls. Use when the requested deliverable depends on markdown to html. - 100md-document
Convert authored markdown into a polished self-contained HTML document with a table of contents, numbered figures and tables, cross-references, footnotes, and print-ready CSS. Use when publishing a report, whitepaper, or memo. - 100memo
Route `/memo` requests to the local memo MCP memory server. Use for searching, asking, saving, listing, getting, updating, deleting, reindexing, stats, and doctor commands. Prefer `mcp__memo__memo_*` tools; use the `memo` CLI only for maintenance commands not exposed over MCP. - 96amemo-find-memo
当用户说「查看/查找/搜索 + 我的 + 笔记/备忘」时调用,按关键词模糊搜索并返回匹配的笔记列表。 - 100document-conversion
Use when converting between document formats. Covers HTML to Markdown, document to Markdown, PDF generation from HTML, and preserving structure through a conversion rather than losing it. Trigger on "convert this html to markdown", "turn this docx into markdown", "make a pdf… - 100executive-decision-memo
Draft, review, and format official executive memorandums, decision records, policy directives, and formal letters using strict Bottom Line Up Front (BLUF) and structured hierarchy rules. Use whenever the user asks to write an executive memo, decision record, policy directive, or…