From 5775b67549d40512c6fdbc9e94a8e8469a58473a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20Hidemaru=20Ogoshi=20/=20=E5=A4=A7=E8=B6=8A?= =?UTF-8?q?=E3=83=8B=E3=82=B3=E3=83=A9=E3=82=B9=E7=A7=80=E4=B8=B8?= <40846197+Nicolas0315@users.noreply.github.com> Date: Thu, 24 Sep 2026 14:35:03 +0900 Subject: [PATCH 1/5] =?UTF-8?q?chore:=20=E3=83=81=E3=83=BC=E3=83=A0?= =?UTF-8?q?=E9=96=8B=E7=99=BA=E3=81=AE=E6=A8=99=E6=BA=96=E3=83=95=E3=82=A1?= =?UTF-8?q?=E3=82=A4=E3=83=AB=E3=82=92=E8=B6=B3=E3=81=99=20(repo-standardi?= =?UTF-8?q?ze)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - CODEOWNERS - .github/pull_request_template.md - .pre-commit-config.yaml - AGENTS.md Co-Authored-By: Claude Opus 5.5 --- .github/pull_request_template.md | 13 +++++++++++++ .pre-commit-config.yaml | 13 +++++++++++++ AGENTS.md | 32 ++++++++++++++++++++++++++++++++ CODEOWNERS | 2 ++ 4 files changed, 60 insertions(+) create mode 100644 .github/pull_request_template.md create mode 100644 .pre-commit-config.yaml create mode 100644 AGENTS.md create mode 100644 CODEOWNERS diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md new file mode 100644 index 0000000..6d8195d --- /dev/null +++ b/.github/pull_request_template.md @@ -0,0 +1,13 @@ +## 何を変えたか + + +## なぜ + + +## どう確かめたか + +- [ ] ローカルでテストが通った +- [ ] 画面を実際に操作して確認した(UI の変更がある場合) +- [ ] 本番・staging の設定や秘密情報は変えていない(変えた場合はここに書く) + +## レビューで見てほしいところ diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml new file mode 100644 index 0000000..aa71d14 --- /dev/null +++ b/.pre-commit-config.yaml @@ -0,0 +1,13 @@ +# repo-standardize が置いた標準の安全チェック(このリポは CI を持たないのでローカルで走らせる)。 +# 有効化: brew install pre-commit && pre-commit install --hook-type pre-commit --hook-type pre-push +repos: + - repo: https://github.com/gitleaks/gitleaks + rev: v8.30.1 + hooks: + - id: gitleaks + - repo: https://github.com/semgrep/pre-commit + rev: v1.178.0 + hooks: + - id: semgrep + args: ["--config", "p/default", "--error", "--skip-unknown-extensions", "--metrics=off"] + stages: [pre-push] diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..332555b --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,32 @@ +# .github + +Repo-specific delta only. The global baseline is inherited; do not repeat it here. + +## Scope + +(このリポが何をするかを1〜2行で書く) + +## Paths + + + +## Commands + + +- (自動検出できなかった。install / test / build のコマンドを書く) + +## Constraints + + + +## Verification + + + +## Delivery + + + +Keep this file under 200 lines and 16 KiB. Put multi-step or occasional procedures in docs or a task-specific Skill. diff --git a/CODEOWNERS b/CODEOWNERS new file mode 100644 index 0000000..8e09693 --- /dev/null +++ b/CODEOWNERS @@ -0,0 +1,2 @@ +# 既定の担当者。ディレクトリごとに分けるときは下に行を足す。 +* @Nicolas0315 From e063f5fee3cc73a1bc756b1cf128e749bdd6257e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20Hidemaru=20Ogoshi=20/=20=E5=A4=A7=E8=B6=8A?= =?UTF-8?q?=E3=83=8B=E3=82=B3=E3=83=A9=E3=82=B9=E7=A7=80=E4=B8=B8?= <40846197+Nicolas0315@users.noreply.github.com> Date: Sat, 26 Sep 2026 21:17:52 +0900 Subject: [PATCH 2/5] =?UTF-8?q?chore:=20=E5=85=AC=E9=96=8B=E3=83=AA?= =?UTF-8?q?=E3=83=9D=E3=81=AB=E6=A4=9C=E6=9F=BB=E8=A8=AD=E5=AE=9A=E3=82=92?= =?UTF-8?q?=E7=BD=AE=E3=81=8B=E3=81=9A=E3=80=81AGENTS.md=20=E3=81=A8=20REA?= =?UTF-8?q?DME=20=E3=81=AE=E7=B6=99=E6=89=BF=E3=83=95=E3=82=A1=E3=82=A4?= =?UTF-8?q?=E3=83=AB=E8=A1=A8=E3=82=92=E5=AE=9F=E6=85=8B=E3=81=AB=E5=90=88?= =?UTF-8?q?=E3=82=8F=E3=81=9B=E3=82=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit README の「稼働中の検査構成やセキュリティツールの具体的な設定を書かない」に反するので .pre-commit-config.yaml を外す。AGENTS.md のプレースホルダーを埋め、org 全体へ継承される PR テンプレートを README の適用範囲の表に足した。 Co-Authored-By: Claude Opus 5.5 --- .pre-commit-config.yaml | 13 ------------- AGENTS.md | 17 ++++++++--------- README.md | 3 ++- 3 files changed, 10 insertions(+), 23 deletions(-) delete mode 100644 .pre-commit-config.yaml diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml deleted file mode 100644 index aa71d14..0000000 --- a/.pre-commit-config.yaml +++ /dev/null @@ -1,13 +0,0 @@ -# repo-standardize が置いた標準の安全チェック(このリポは CI を持たないのでローカルで走らせる)。 -# 有効化: brew install pre-commit && pre-commit install --hook-type pre-commit --hook-type pre-push -repos: - - repo: https://github.com/gitleaks/gitleaks - rev: v8.30.1 - hooks: - - id: gitleaks - - repo: https://github.com/semgrep/pre-commit - rev: v1.178.0 - hooks: - - id: semgrep - args: ["--config", "p/default", "--error", "--skip-unknown-extensions", "--metrics=off"] - stages: [pre-push] diff --git a/AGENTS.md b/AGENTS.md index 332555b..2f5ca93 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,29 +4,28 @@ Repo-specific delta only. The global baseline is inherited; do not repeat it her ## Scope -(このリポが何をするかを1〜2行で書く) +CyberticalAI organization の default community health files(`SECURITY.md`、`.github/pull_request_template.md`)を置く public リポ。自前の同名ファイルを持たない org 内の全リポに自動で適用される。 ## Paths - +- `SECURITY.md` / `.github/pull_request_template.md` は org 全体へ継承される。`AGENTS.md` / `CODEOWNERS` / `README.md` はこのリポだけのもの ## Commands - -- (自動検出できなかった。install / test / build のコマンドを書く) +- N/A(Markdown だけのリポで、install / test / build は無い) ## Constraints - +- public リポ。`README.md` の「編集にあたって」にある項目(社内チャンネル名・社内 URL、稼働中の検査構成やセキュリティツールの具体的な設定、個別リポジトリ名、個人のメールアドレス)を書かない +- 継承されるファイルを足したり外したりしたら、`README.md` の適用範囲の表も同じ変更で直す ## Verification - +- N/A(CI は無い)。変更後は GitHub 上で Markdown の表示を確認する ## Delivery - +- 正本ブランチは `main`。merge した時点で、同名ファイルを持たない org 内のリポに適用される。デプロイ手順は無い +- 受入確認: 自前のテンプレートを持たない org 内のリポで PR を新規作成し、本文にテンプレートが入ることを見る Keep this file under 200 lines and 16 KiB. Put multi-step or occasional procedures in docs or a task-specific Skill. diff --git a/README.md b/README.md index bc9a102..4a8c6ba 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,7 @@ | ファイル | 適用範囲 | | --- | --- | | [`SECURITY.md`](./SECURITY.md) | 脆弱性の報告経路と対応の目安 | +| [`.github/pull_request_template.md`](./.github/pull_request_template.md) | PR 本文の既定(何を・なぜ・どう確かめたか)。自前の PR テンプレートを持たないリポで、PR 作成時に本文へ入る | ## 編集にあたって @@ -21,4 +22,4 @@ ## 個別リポジトリで上書きしたいとき -そのリポジトリのルートに `SECURITY.md` を置けば、そちらが優先されます。社内情報を含む完全版を使いたい場合はこの方法を取ってください。 +そのリポジトリのルートに `SECURITY.md` を置けば、そちらが優先されます(PR テンプレートも同じで、リポ側に `.github/pull_request_template.md` などがあればそちらが使われます)。社内情報を含む完全版を使いたい場合はこの方法を取ってください。 From c5793000f273ca3509e006160dcd9385ce850964 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20Hidemaru=20Ogoshi=20/=20=E5=A4=A7=E8=B6=8A?= =?UTF-8?q?=E3=83=8B=E3=82=B3=E3=83=A9=E3=82=B9=E7=A7=80=E4=B8=B8?= <40846197+Nicolas0315@users.noreply.github.com> Date: Wed, 30 Sep 2026 13:43:20 +0900 Subject: [PATCH 3/5] docs: describe organization docs check --- AGENTS.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 2f5ca93..4f093b3 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -12,7 +12,8 @@ CyberticalAI organization の default community health files(`SECURITY.md`、`.g ## Commands -- N/A(Markdown だけのリポで、install / test / build は無い) +- install / build: N/A(Markdown だけのリポ) +- CI: `.github/workflows/docs.yml` が README と SECURITY の存在・リンク、変更行を検査する ## Constraints @@ -21,7 +22,7 @@ CyberticalAI organization の default community health files(`SECURITY.md`、`.g ## Verification -- N/A(CI は無い)。変更後は GitHub 上で Markdown の表示を確認する +- PR の `docs` チェックを通し、GitHub 上で Markdown の表示を確認する ## Delivery From fe1e4d30db25fe737914c22a0fd76f2f0363a7fa Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20Hidemaru=20Ogoshi=20/=20=E5=A4=A7=E8=B6=8A?= =?UTF-8?q?=E3=83=8B=E3=82=B3=E3=83=A9=E3=82=B9=E7=A7=80=E4=B8=B8?= <40846197+Nicolas0315@users.noreply.github.com> Date: Wed, 30 Sep 2026 13:53:57 +0900 Subject: [PATCH 4/5] docs: cite default template locations and private scope --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 4a8c6ba..86ac9f8 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,8 @@ ここに置いたファイルは、同じ organization が所有する全リポジトリ（private を含む）のうち、**自前の同名ファイルを持たないもの** に自動で適用されます。GitHub の仕様上、この機能を有効にするには本リポジトリが public である必要があります。 +GitHub の[既定コミュニティファイルの説明](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file)によると、配布先の可視性にかかわらず適用され、テンプレートはこのリポジトリのルート・`.github/`・`docs/` のいずれにも置けます。ここでは `.github/pull_request_template.md` を使います。 + | ファイル | 適用範囲 | | --- | --- | | [`SECURITY.md`](./SECURITY.md) | 脆弱性の報告経路と対応の目安 | From b484617de56e948cbd39d64be8fe912e39467e69 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20Hidemaru=20Ogoshi=20/=20=E5=A4=A7=E8=B6=8A?= =?UTF-8?q?=E3=83=8B=E3=82=B3=E3=83=A9=E3=82=B9=E7=A7=80=E4=B8=B8?= <40846197+Nicolas0315@users.noreply.github.com> Date: Wed, 30 Sep 2026 14:04:09 +0900 Subject: [PATCH 5/5] docs: clarify default scope and keep secrets out of PR bodies --- .github/pull_request_template.md | 2 +- AGENTS.md | 2 +- README.md | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 6d8195d..1fd69b9 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -8,6 +8,6 @@ - [ ] ローカルでテストが通った - [ ] 画面を実際に操作して確認した(UI の変更がある場合) -- [ ] 本番・staging の設定や秘密情報は変えていない(変えた場合はここに書く) +- [ ] 本番・staging の設定や秘密の変更有無を記載した（秘密の値は書かない） ## レビューで見てほしいところ diff --git a/AGENTS.md b/AGENTS.md index 4f093b3..751db83 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,7 +4,7 @@ Repo-specific delta only. The global baseline is inherited; do not repeat it her ## Scope -CyberticalAI organization の default community health files(`SECURITY.md`、`.github/pull_request_template.md`)を置く public リポ。自前の同名ファイルを持たない org 内の全リポに自動で適用される。 +CyberticalAI organization の default community health files(`SECURITY.md`、`.github/pull_request_template.md`)を置く public リポ。適用条件は README の GitHub 公式文書を参照する。 ## Paths diff --git a/README.md b/README.md index 86ac9f8..7acf753 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,9 @@ 株式会社サイバーティカル（CyberticalAI organization）の **default community health files** を置くリポジトリです。 -ここに置いたファイルは、同じ organization が所有する全リポジトリ（private を含む）のうち、**自前の同名ファイルを持たないもの** に自動で適用されます。GitHub の仕様上、この機能を有効にするには本リポジトリが public である必要があります。 +ここに置いたファイルは、同じ organization が所有するリポジトリのうち、**自前の同名ファイルを持たないもの** に自動で適用されます。GitHub の仕様上、この機能を有効にするには本リポジトリが public である必要があります。 -GitHub の[既定コミュニティファイルの説明](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file)によると、配布先の可視性にかかわらず適用され、テンプレートはこのリポジトリのルート・`.github/`・`docs/` のいずれにも置けます。ここでは `.github/pull_request_template.md` を使います。 +適用条件と配置場所は GitHub の[既定コミュニティファイルの説明](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file)に従います。ここでは `.github/pull_request_template.md` を使います。 | ファイル | 適用範囲 | | --- | --- |