この記事は連載『AIに仕事を奪われる不安から始めるハーネス作成入門』第22回です。
連載目次
| 回 | タイトル | 状態 |
|---|---|---|
| 第1回〜第21回 | （既刊） | ✅ |
| 第22回 | Qiita連載とGitHubリポジトリを連動させる運用 | 📖 |
| 第23回 | AIハーネスを副業・受託・社内改善に転用する前に考えること | ─ |
| 第24回 | 12週間のハーネス連載を振り返り、次に作るAI基盤を決める | ─ |
はじめに ── 発信と開発を同時に回す
前回はポートフォリオ化の考え方を紹介しました。今回はそれを実際に運用するための「回し方」に焦点を当てます。
Qiitaで記事を書き、GitHubにコードを置く。この2つを別々に管理するのではなく、1つのワークフローとして統合することで、継続しやすくなります。
連動運用の全体フロー
以下のフローで、開発と発信を同時に回します。
運用チェックリスト
毎週の開発サイクル
| ステップ | 作業内容 | 所要時間目安 |
|---|---|---|
| 1. コーディング | 機能実装・バグ修正 | 平日 30分×3日 |
| 2. コミット | 意味のある単位でコミット | コーディングに含む |
| 3. 記事ドラフト | 学びを記事にまとめる | 週末 1時間 |
| 4. レビュー | 記事の見直し | 30分 |
| 5. 投稿・README更新 | Qiita投稿、READMEにリンク追加 | 15分 |
コミットメッセージの工夫
コミットメッセージに規則性を持たせると、後から記事のネタを探しやすくなります。
feat: マスキング処理クラスを追加
fix: パターンマッチの正規表現を修正
docs: READMEに第22回のリンクを追加
refactor: 復元処理のリファクタリング
ブランチ戦略
個人開発でもブランチを活用すると、運用が整理されます。
| ブランチ | 用途 | ルール |
|---|---|---|
main |
安定版 | 常に動作する状態 |
develop |
開発中 | 日々の作業はここ |
article/XX |
記事用 | 記事に対応する変更 |
発信を習慣化するコツ
「書くネタがない」への対処
実は「書くネタがない」と感じる時が一番書くチャンスです。「うまくいかなかったこと」も立派なネタになります。
- エラー解決の過程 → 「トラブルシューティング記事」
- 技術選定の迷い → 「比較検討記事」
- 設計のやり直し → 「リファクタリング記事」
継続のためのハードルを下げる
- 書く曜日を決める: 「毎週土曜の午前」など固定
- テンプレートを作る: 毎回同じ構成で書く
- 完璧を求めない: 80点で投稿、後から改善
チェックリスト: 記事投稿前の確認事項
以下のチェックリストを使って、投稿前の確認を習慣化しましょう。
## 投稿前チェックリスト
### コード側
- [ ] 記事に対応するコードがコミット済み
- [ ] テストが通る
- [ ] READMEに新しい機能の説明を追加
### 記事側
- [ ] タイトルに連載番号を含む
- [ ] コードサンプルが動作確認済み
- [ ] GitHubリポジトリへのリンクがある
- [ ] 前回・次回のリンクが正しい
- [ ] タグが適切
### 連動確認
- [ ] Qiita記事からGitHubへのリンクが機能する
- [ ] READMEのQiita連載リンクが最新
トラブルシューティング
「記事とコードがズレる」
記事に書いたコードとリポジトリのコードが乖離するのはよくある問題です。対策としては、記事には対応するコミットハッシュやタグを記載し、「この時点のコード」を特定できるようにしておきましょう。
「更新が続かない」
継続のハードルが高いと感じたら、頻度を下げるのも一つの選択です。「毎週」を「隔週」に、「隔週」を「月一」に。大切なのは「やめないこと」です。
SE経験が活きるポイント
- リリースプロセス → 記事投稿のワークフロー
- バージョン管理 → コミットと記事の対応付け
- ドキュメント更新 → READMEの継続的なメンテナンス
SEが日常的にやっている「開発・テスト・リリース」のサイクルを、「開発・発信・フィードバック」に変えるだけです。
まとめ
- 開発と発信を1つのワークフローに統合する
- コミットメッセージ規則で記事ネタを探しやすく
- 投稿前チェックリストで品質を担保
- 「やめないこと」が一番の運用ルール
次回予告
次回 第23回「AIハーネスを副業・受託・社内改善に転用する前に考えること」では、ハーネスの技術を副業や受託、社内改善に転用する際の判断基準と注意点を整理します。転用パターン表で、自分に合った展開先を見つけましょう。
この記事は連載『AIに仕事を奪われる不安から始めるハーネス作成入門』第22回です。
連載についてのフィードバックやご質問は、コメント欄またはQiitaのDMでお気軽にどうぞ。