• home
  • about
  • 全ての投稿
  • ソフトウェア・ハードウェアの設定のまとめ
  • 分析関連のまとめ
  • ヘルスケア関連のまとめ
  • 生涯学習関連のまとめ

プロジェクトの説明

プロジェクトの説明

  • このプロジェクトはブログのマークダウン管理します
  • エージェントの目的はブログの指定されたコンテンツの不備を修正することです

構造の説明

  • _posts/<subdir> 以下に個々のmarkdownコンテンツが配置されている
  • <subdir>はコンテンツの性質に応じて作成されている

基本的に守ってほしいこと

  • git 関連の操作(git commit, pre-commit関連のチェック 等) は必要ない
  • バレットリストと番号付きリストの一段目は先頭に空白を一つ入れる
    • 例 ` - item 1. item`
  • フロントマターのtagsは揺れを起こしており、tagsまたはtagのことがあるが原則tagを用いる(対象のマークダウンを除き積極的に修正はしない)
  • 句点(。)は使用しない
  • マークダウンの太字記法(**text**)は文中への埋め込みはNG。ただし、小セクションの見出し代わりに一行まるごと太字にする用法(例: **エージェントの定義** 単体で1行)はOK
  • ユーザへの通知は日本語を優先する
  • 記事内で他記事へリンクする場合、Jekyllのパーマリンクは /<title>/ の形式になる(例: [dbt記事](/dbt/))。/subdir/YYYY/MM/DD/title/ のようなパスは使用しない

トンマナの踏襲

  • 記事を新規作成または大きく改稿する場合は、few-shotとして既存記事を3つ以上読む
  • 参照する記事は、対象記事と内容、カテゴリ、公開時期が近いものを優先する
  • 参照記事は見出し、文体、粒度、コード例、リンクの置き方を省略せずに確認し、既存ブログのトンマナを把握したうえで編集する
  • ただし、質問への応答のみが求められている場合はファイルを編集しない

push後の確認

  • git push 後に gh run list --limit 5 でGitHub Pagesのビルド状況を確認する

遵守事項

  • git restore . を絶対行わない
  • 質問への応答のみが求められている場合、リポジトリ内のファイル(コードや記事)を編集しない