note-hashtags

note 公開用ドラフト(content/note/{slug}/article.md)の内容を解析して、note の上限である 99 個までのハッシュタグを生成し、{article_dir}/hashtags.txt に保存する Generator スキル。1 行 1 個・純粋ハッシュタグのみ・コメント無しでファイル全選択コピペで note に貼り付け可能。 Use when user asks

SKILL.md

GitHub

/note-hashtags — note ハッシュタグ 99 個生成

note.com は記事 1 本に最大 99 個までハッシュタグを設定でき、検索流入の主要導線。本スキルは記事内容を解析して上限まで活用したリストを生成し、{article_dir}/hashtags.txt に保存する。

引数

/note-hashtags {slug} [--article {suffix}] [--max N]
引数 説明
{slug} 対象記事ディレクトリ名(例: 総監択一式17年分分析)。slug の先頭一致でも解決可
--article {suffix} 対象 article ファイルのサフィックス(例: --article II1 → article-II1.md を解析して hashtags-II1.txt を出力)。省略時は article.md → hashtags.txt
--max N 上限を 99 から N 個に縮める(既定: 99)

出力ファイル

サフィックスは汎用(article-{suffix}.md → hashtags-{suffix}.txt)。技術士建設部門 BK マガジン(選択科目)の区分1ファイル方式(2026-06-10〜)では次のとおり:

対象記事ファイル 出力ハッシュタグファイル
article.md(必須科目I・概要) hashtags.txt
article-II1.md(II-1 全設問) hashtags-II1.txt
article-II2.md(II-2 全選択肢) hashtags-II2.txt
article-III.md(III 全問題) hashtags-III.txt

区分内の全選択肢テーマを横断して代表タグを選ぶ(例: II-1 は全設問のキーワードから、III は III-1・III-2 双方のテーマから)。旧設問別命名(hashtags-II1-1.txt 等)は 2026-06-10 に廃止。

--article {suffix} を省略した場合: hashtags.txt(後方互換)

フォーマット要件(ファイル全選択コピーで note に貼付できる前提):

  • 1 行 1 ハッシュタグ
  • 全行が # で始まる
  • コメント・空行・グループ区切り 禁止
  • 重複禁止(大文字小文字違いも同じタグ。note は区別しない)
  • - . / を含むタグ禁止(note のタグ欄が受け付けず、ライブと永久にずれる)。_ に置き換える(i_Construction・BIM_CIM・地方創生2_0)。check-note-hashtags が止める
  • 行数は 99 以下(既定)
  • 改行コードはプロジェクト標準(macOS は LF)

生成ロジック

Step 1: 記事内容の解析

ROOT="/Users/minamidaisuke/doboku-note"
F="$ROOT/content/note/{slug}/article.md"

# 1. frontmatter(あれば category / tags 抽出)
# 2. 本文の見出し(## 〜 ####)
# 3. 内部リンク先 slug(ハッシュタグ候補のヒント)
grep -oE '/docs/pe-comprehensive-management-[a-z0-9-]+' "$F" | sort -u
# 4. 強調された語(**...**)
grep -oE '\*\*[^*]+\*\*' "$F" | sort -u

Step 2: カテゴリ別テンプレート + 記事特有キーワード

コアカテゴリ別テンプレート(記事のジャンル判定で適用):

ジャンル判定 コアテンプレート例
技術士総監 #技術士 #技術士試験 #技術士二次試験 #総合技術監理 #総合技術監理部門 #総監 #総監受験 #総監択一 #技術士総監 #技術士受験 #択一式 #国家資格 #PE #技術士補 #二次試験
5管理分野 #経済性管理 #人的資源管理 #情報管理 #安全管理 #社会環境管理 #リスクマネジメント #品質管理 #コスト管理 #工程管理 #労働安全衛生
1級土木 #1級土木施工管理技士 #土木施工管理技士 #施工管理技士 #土木施工管理 #1級土木 #建設業
学習・勉強法 #勉強法 #資格勉強 #資格試験 #受験勉強 #過去問 #過去問分析 #過去問演習 #合格体験記 #試験対策 #独学 #社会人勉強 #社会人の学び直し #リスキリング #学び直し #効率的な勉強法
業界・職種 #土木 #建設 #土木工学 #建設業 #エンジニア #技術者 #建設コンサルタント #ゼネコン #技術職 #土木技術者 #インフラ #公務員 #DX
関連資格 #1級土木施工管理技士 #コンクリート主任技士 #コンクリート診断士 #RCCM #技術士建設部門 #建設部門 #1級建築士 #応用情報技術者
一般学習・キャリア #note #毎日note #学び #挑戦 #自己啓発 #キャリアアップ #大人の学び #社会人 #国家試験 #継続力 #毎日投稿 #note挑戦 #自己投資

記事特有キーワード: 内部リンク先 slug や本文の頻出語から導出(例: business-continuity-plan → #BCP #BCM #事業継続計画、pert-cpm → #PERT #CPM、maslow-hierarchy-of-needs → #マズロー #モチベーション理論)。

slug → ハッシュタグ変換マップ例(必要に応じて拡張):

slug ハッシュタグ候補
business-continuity-plan #BCP #BCM #事業継続計画
pert-cpm #PERT #CPM
break-even-point #損益分岐点
quality-control #QC七つ道具 #新QC七つ道具 #品質管理
pdca #PDCA
carbon-pricing #カーボンニュートラル #SDGs
labor-standards-act #労働基準法 #36協定 #働き方改革
value-engineering #VE #バリューエンジニアリング
risk-assessment #リスクアセスメント
heinrich-law #ヒューマンエラー #ハインリッヒの法則
maslow-hierarchy-of-needs #マズロー #モチベーション理論
mcgregor-xy-theory #リーダーシップ
variable-work-hours #変形労働時間制
flextime-system #フレックスタイム制
npv-net-present-value #NPV
process-capability-index #工程能力指数

Step 3: 統合 + 上限調整

  1. 該当する全テンプレートを結合
  2. 内部リンク slug から派生ハッシュタグを追加
  3. 重複削除(同一文字列)
  4. 99 個(または --max N)を超える場合は 記事特有キーワード優先 で残す(コアテンプレートより記事独自シグナルを優先)
  5. 1 行 1 個で書き出し

Step 4: 検証

F="$ROOT/content/note/{slug}/hashtags.txt"
echo "総行数: $(wc -l < "$F" | tr -d ' ')"
echo "ハッシュタグ行数: $(grep -cE '^#' "$F")"
echo "空行: $(grep -c '^$' "$F")"
echo "コメント: $(grep -cE '^#[[:space:]]' "$F")"
echo "重複: $(sort "$F" | uniq -d | wc -l | tr -d ' ')"

期待値: 総行数 == ハッシュタグ行数 ≤ 99 / 空行 0 / コメント 0 / 重複 0。

報告フォーマット

## /note-hashtags 結果

対象: content/note/{slug}/article.md
出力: content/note/{slug}/hashtags.txt

生成タグ: N 個(上限 99)
内訳:
- コアテンプレート: M 個
- 記事特有: K 個(slug から N 個抽出)

検証: 行数 N / 空行 0 / コメント 0 / 重複 0 → OK

既存スキル・エージェントとの関係

関連 役割
/social-post note ... note 本文の 生成
/note-hashtags note ハッシュタグの 生成
/note-prepublish-review 公開前統合チェック(hashtags.txt 存在を Phase 1 で検証)
note-link-injector agent 本文へのリンク注入

制約

  • 対象は content/note/ 配下のみ
  • 既存 hashtags.txt があれば上書き(バックアップは取らない、git で履歴管理)
  • 記事 1 本ずつ実行(バルク非対応)。バルクで記事を作るワークフロー(学科ライン・想定工事バンク等)は、各記事へ本スキルを必ず回す。省くと 10 個等の過少 hashtags.txt が公開に到達する(2026-07-05、civil 二次学科13本が10個・LP がライブ3個で発覚)。
  • 過少生成ガード(二段): ①check-note-3set.mjs(note-lint pre-commit)が公開状態の hashtags.txt のタグ数 < MIN_TAGS(既定 40)を BLOCK。②**check-note-hashtags.mjs(pre-commit --staged + CI 全量)が 90 個未満を BLOCK**(2026-07 新設・下限を90へ強制。有効レンジ 90〜99)。存在だけでなく個数も強制。真実源 content-principles.md §14-d
  • 公開済み記事へのタグ差分追加: scripts/note-sync-tags.mjs(本文非破壊・note上限99・不足分をlive照合で追加)。ライブが上限99で埋まり足せないときは --prune で原稿に無いタグを外してから足す。下記「公開後のライブ反映は手動」の自動化版
  • 公開後のライブ反映は手動: note は公開済み記事のハッシュタグ編集を「更新する」フローで保存しない(有料/限定記事で確認・2026-07-05)。hashtags.txt を note の編集画面で全選択コピペ → 更新するのが確実
  • slug → hashtag マップは本ファイルが真実源。新カテゴリ・新キーワードを追加するときは本 SKILL.md を編集