リンクチェックの導入（定期・毎月）

.github/workflows/link-check.yml

@@ -0,0 +1,49 @@
+name: リンクチェック
+
+# 毎月1日の午前9時（JST）に実行（UTC 0時）
+on:
+  schedule:
+    - cron: '0 0 1 * *'
+  # 手動実行も可能
+  workflow_dispatch:
+
+jobs:
+  link-check:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      issues: write
+
+    steps:
+      # リポジトリをチェックアウト
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      # リンクチェックを実行
+      - name: Link Checker
+        uses: lycheeverse/lychee-action@v1
+        with:
+          # public/ディレクトリ内のMarkdownファイルをチェック
+          args: --verbose --no-progress 'public/**/*.md'
+          # 壊れたリンクが見つかった場合は失敗とする（Issueで通知）
+          fail: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      # リンクチェック結果をアーティファクトとして保存
+      - name: Upload link check results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: link-check-results
+          path: lychee/out.md
+          retention-days: 30
+
+      # 壊れたリンクが見つかった場合にIssueを作成
+      - name: Create Issue From File
+        if: failure()
+        uses: peter-evans/create-issue-from-file@v5
+        with:
+          title: リンクチェックで壊れたリンクが検出されました
+          content-filepath: ./lychee/out.md
+          labels: bug

.github/workflows/publish-articles.yml

@@ -37,3 +37,14 @@ jobs:
         run: npx qiita publish --all
         env:
           QIITA_TOKEN: ${{ secrets.QIITA_TOKEN }}
+
+      # ID
+      - name: Commit and push diff # Not executed recursively even if `push` is triggered. See https://docs.github.com/en/actions/using-workflows/triggering-a-workflow#triggering-a-workflow-from-a-workflow
+        run: |
+          git add ./public/*
+          if ! git diff --staged --exit-code --quiet; then
+            git config --global user.name 'github-actions[bot]'
+            git config --global user.email '41898282+github-actions[bot]@users.noreply.github.com'
+            git commit -m "$Update ids after publishment"
+            git push
+          fi

.github/workflows/reviewdog.yml

@@ -0,0 +1,27 @@
+name: reviewdog
+
+# PRが作成・更新された時に実行
+on:
+  pull_request:
+
+jobs:
+  markdownlint:
+    name: Markdown Lint
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      # リポジトリをチェックアウト
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      # reviewdogを使用してmarkdownlintを実行
+      - name: Run markdownlint with reviewdog
+        uses: reviewdog/action-markdownlint@v0
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          reporter: github-pr-review
+          level: warning
+          markdownlint_flags: '**/*.md --ignore node_modules'

.gitignore

@@ -1,3 +1,4 @@
 # Qiita CLI
 .qiita-cli
+.remote
 node_modules

.markdownlint.json

@@ -0,0 +1,6 @@
+{
+  "default": true,
+  "MD013": false,
+  "MD033": false,
+  "MD041": false
+}

README.md

@@ -4,32 +4,28 @@ Qiita記事をGitHubで管理するためのリポジトリです。
 
 ## セットアップ
 
-### 1. Qiitaアクセストークンの取得
+セットアップ方法については [SETUP.md](./SETUP.md) をご覧ください。
+
+## 記事一覧
+
+全 18 件の記事があります。
+
+- [開発マネージャがメンバーに知って欲しい事 ※随時更新](./public/開発マネージャがメンバーに知って欲しい事.md) (更新: 2025-04-22)
+- [最近良く見る「アウトプット」「アウトカム」「インパクト」とは何か？](./public/最近良く見る「アウトプット」「アウトカム」「インパクト」とは何か？.md) (更新: 2025-03-17)
+- [理解しやすいコードの書き方～理解容易性の7つの観点～](./public/理解しやすいコードの書き方～理解容易性の7つの観点～.md) (更新: 2025-03-14)
+- [AWS ネットワーク構成図サンプル（VPC）](./public/AWS_ネットワーク構成図サンプル（VPC）.md) (更新: 2024-12-23)
+- [JSTQB テスト自動化エンジニア v2016 要約・意訳](./public/JSTQB_テスト自動化エンジニア_v2016_要約・意訳.md) (更新: 2024-10-10)
+- [やりたくない仕事をやらずに済む方法](./public/やりたくない仕事をやらずに済む方法.md) (更新: 2023-12-11)
+- [CodeceptJSにトライしてみた。](./public/CodeceptJSにトライしてみた.md) (更新: 2023-11-11)
+- [開発に便利なユニットテストの使い方](./public/開発に便利なユニットテストの使い方.md) (更新: 2023-01-13)
+- [認定スクラムマスター資格をとるまでの流れ](./public/認定スクラムマスター資格をとるまでの流れ.md) (更新: 2022-10-07)
+- [たまに使うGitコマンド集](./public/たまに使うGitコマンド集.md) (更新: 2022-09-16)
+- [GitLab CEでGitHubをミラーリングする](./public/GitLab_CEでGitHubをミラーリングする.md) (更新: 2022-05-02)
+- [なぜ単純な増員は生産性の改善に直結しないのか？](./public/なぜ単純な増員は生産性の改善に直結しないのか？.md) (更新: 2022-03-05)
+- [実践：「質とスピード」を維持するには](./public/実践：「質とスピード」を維持するには.md) (更新: 2021-12-21)
+- [AWS CDKはグローバルでインストールしない](./public/AWS_CDKはグローバルでインストールしない.md) (更新: 2020-12-25)
+- [AWS CLIがMINGW64でc:\program: bad interpreter: No such file or directoryエラーになる場合の回避方法](./public/AWS_CLIがMINGW64でc_program_bad_interpreter_No_such_file_or_directoryエラーになる場合の回避方法.md) (更新: 2020-12-25)
+- [AWS CDKで「Error: ARNs must have at least 6 components: undefined」になる時の解決策](./public/AWS_CDKで「Error_ARNs_must_have_at_least_6_components_undefined」になる時の解決策.md) (更新: 2020-12-24)
+- [長く売れる製品を考える為の観点](./public/長く売れる製品を考える為の観点.md) (更新: 2020-12-24)
+- [JIRAでGitHub Enterpriseを連携する際の設定値の具体例](./public/JIRAでGitHub_Enterpriseを連携する際の設定値の具体例.md) (更新: 2020-12-02)
 
-1. [Qiitaの設定ページ](https://qiita.com/settings/tokens/new)でアクセストークンを生成
-2. 必要な権限: `read_qiita`, `write_qiita`
-
-### 2. GitHubシークレットの設定
-
-1. リポジトリの Settings > Secrets and variables > Actions に移動
-2. `QIITA_TOKEN` という名前でシークレットを追加
-3. 上記で取得したQiitaアクセストークンを値として設定
-
-## 使用方法
-
-### 既存記事の取得
-
-1. GitHubリポジトリの Actions タブに移動
-2. 「既存記事の取得」ワークフローを選択
-3. 「Run workflow」ボタンをクリックして手動実行
-
-このワークフローは、Qiitaに投稿済みの記事を取得し、リポジトリに保存します。
-
-### 記事の公開
-
-1. `public/` ディレクトリ内の記事ファイルを編集または新規作成
-2. 変更をコミットしてブランチにプッシュ
-3. main ブランチへのプルリクエストを作成
-4. プルリクエストをマージ
-
-プルリクエストがマージされると、自動的に記事がQiitaに公開されます。

SETUP.md

@@ -0,0 +1,60 @@
+# セットアップガイド
+
+このドキュメントでは、Qiita記事をGitHubで管理するためのセットアップ方法を説明します。
+
+## セットアップ
+
+### 1. Qiitaアクセストークンの取得
+
+1. [Qiitaの設定ページ](https://qiita.com/settings/tokens/new)でアクセストークンを生成
+2. 必要な権限: `read_qiita`, `write_qiita`
+
+### 2. GitHubシークレットの設定
+
+1. リポジトリの Settings > Secrets and variables > Actions に移動
+2. `QIITA_TOKEN` という名前でシークレットを追加
+3. 上記で取得したQiitaアクセストークンを値として設定
+
+## 使用方法
+
+### 既存記事の取得
+
+1. GitHubリポジトリの Actions タブに移動
+2. 「既存記事の取得」ワークフローを選択
+3. 「Run workflow」ボタンをクリックして手動実行
+
+このワークフローは、Qiitaに投稿済みの記事を取得し、リポジトリに保存します。
+
+### 記事の公開
+
+1. `public/` ディレクトリ内の記事ファイルを編集または新規作成
+2. 変更をコミットしてブランチにプッシュ
+3. main ブランチへのプルリクエストを作成
+4. プルリクエストをマージ
+
+プルリクエストがマージされると、自動的に記事がQiitaに公開されます。
+
+## 品質チェック
+
+### Markdown Lint
+
+プルリクエストを作成すると、reviewdogを使用したmarkdown-lintの自動チェックが実行されます。
+
+- チェック対象: すべての `.md` ファイル
+- レビューコメント: 問題が見つかった場合、PRに自動的にコメントが投稿されます
+- 設定ファイル: `.markdownlint.json`
+
+無効化されているルール:
+
+- MD013: 行の長さ制限（Qiita記事では長い行が一般的なため）
+- MD033: HTML使用（Qiita記事ではHTMLタグが使用されることがあるため）
+- MD041: 最初の行は見出しであるべき（Qiitaの記事にはfrontmatterがあるため）
+
+### リンクチェック
+
+記事内のリンクが正しく機能しているかを自動的にチェックします。
+
+- **自動実行**: 毎月1日の午前9時（JST）に自動実行
+- **手動実行**: GitHubリポジトリの Actions タブから「リンクチェック」ワークフローを選択し、「Run workflow」ボタンをクリック
+- **通知**: 壊れたリンクが見つかった場合は、自動的にIssueが作成されます（bugラベル付き）
+- **ログ保存**: チェック結果はアーティファクトとして30日間保存されます