{"id":47036260,"url":"https://github.com/igapyon/igapyon-agent-skills","last_synced_at":"2026-06-02T02:02:20.214Z","repository":{"id":343594349,"uuid":"1178341429","full_name":"igapyon/igapyon-agent-skills","owner":"igapyon","description":"Personal Codex Agent Skills repository for GitHub writing, Japanese article writing, companion writing workflows, repository conventions, and miku-soft development workflows.","archived":false,"fork":false,"pushed_at":"2026-05-30T13:23:13.000Z","size":31640,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"devel","last_synced_at":"2026-05-30T15:11:24.407Z","etag":null,"topics":["agent-skills","codex","mikuku","note","qiita","writing-assistant"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/igapyon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-10T23:47:43.000Z","updated_at":"2026-05-30T13:23:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/igapyon/igapyon-agent-skills","commit_stats":null,"previous_names":["igapyon/igapyon-agent-skills"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/igapyon/igapyon-agent-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igapyon%2Figapyon-agent-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igapyon%2Figapyon-agent-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igapyon%2Figapyon-agent-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igapyon%2Figapyon-agent-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/igapyon","download_url":"https://codeload.github.com/igapyon/igapyon-agent-skills/tar.gz/refs/heads/devel","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igapyon%2Figapyon-agent-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33802170,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","codex","mikuku","note","qiita","writing-assistant"],"created_at":"2026-03-12T01:12:50.070Z","updated_at":"2026-06-02T02:02:20.208Z","avatar_url":"https://github.com/igapyon.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# igapyon-agent-skills\n\n個人用の Agent Skills を管理するためのリポジトリです。\n\n日本語の Note / Qiita 記事作成と、技術・音楽投稿の伴走型ライティング支援に使う skill を置いています。\n\n## 方針\n\n- skill は `skills/` 配下に置く\n- 1 skill = 1 directory\n- skill ごとの詳細仕様は各 `SKILL.md` に書く\n- skill の具体ルール、例、長めの手順は `references/` 配下に置く\n- Note / Qiita 記事 Markdown は、各 writer skill 配下の `references/` を正本として管理する\n- skill を新規作成・更新した後は、`SKILL.md` が必要な `references/` を案内していること、必要に応じて `index.json` を参照することを確認する\n- repo 全体の運用ルールはこの `README.md` に書く\n- 作業メモは repo 直下の `TODO.md` に集約する\n- skill ごとの `index.json` は `miku-indexgen` で生成する\n- ローカル作業用に `workplace/` を置き、`workplace/.gitkeep` だけを Git 管理下に入れる\n- Java / Maven 開発では `.mvn/jvm.config` を repo に含める\n\n## バージョン更新\n\nこの repo 全体のバージョンは、root の `pom.xml` を正本として管理します。\n\nバージョン形式は `1.YYYYMMDD.N` を基本とし、`YYYYMMDD` はその保守更新日、`N` は同じ日付内の更新番号を表します。  \nたとえば 2026-05-21 の最初の保守更新では、repo 全体のバージョンを `1.20260521.1` にします。\n\nrepo 全体のバージョンを更新するときは、日付部分に合わせて `skills/igapyon-mikuku-agent/references/VERSION.md` の `Version` も更新します。  \n`みくく` のバージョンは `YYYYMMDDx` 形式で、`YYYYMMDD` を repo 全体のバージョンの日付部分と揃えます。  \n同じ日付内の更新は、`みくく` 側では `a`, `b`, `c` ... と suffix を進め、repo 全体のバージョンでは対応する `N` を `1`, `2`, `3` ... と進めます。\n\n## 記事公開の優先順位\n\n技術記事は、まず Note 向けの記事として作成・公開することを優先します。\n\nNote では、みくく担当のテック主記事を一次公開記事として扱います。  \n文体は Qiita 寄りの技術記事文体とし、技術内容、使い方、CLI、仕様、手順、コマンド例などをしっかり含めます。\n\nQiita では、Note のテック主記事をもとに、技術詳細、手順、CLI リファレンス、設定例、コマンド例などをより参照しやすい形で後追い整理します。\n\n従来型の Note 記事も引き続き作成します。  \nこちらはうさぴょん担当とし、Note らしい柔らかい文体で、開発背景、使いどころ、利用イメージ、つまずきや意図などを含めた読み物として整えます。\n\n記事の正本管理は従来どおり、媒体ごとに分けます。\n\n- Note 向け記事の正本: `skills/igapyon-note-writer/references/`\n- Qiita 技術記事の正本: `skills/igapyon-qiita-writer/references/`\n\nQiita 側は投稿頻度や下書き作成数に制限がかかる場合があるため、公開は間隔を空けて行います。  \n大量の記事移行や連続公開が必要な場合でも、まずこの repo の `references/` に正本を保持し、公開作業は媒体側の制限に合わせて進めます。\n\n## 移行期の writer skill 運用\n\nNote 優先運用への移行期は、掲載媒体ではなく記事タイプで writer skill を選びます。\n\nみくく担当の Note テック主記事は、Note 掲載であっても `igapyon-qiita-writer` を使って作成・整理します。  \nこれは、文体と情報密度を Qiita 寄りの技術記事として保つためです。\n\nうさぴょん担当の従来型 Note 記事は、`igapyon-note-writer` を使って作成・整理します。  \nこちらは、技術詳細を詰め込みすぎず、背景、感触、読み物としての流れを優先します。\n\n記事ファイルの正本配置は、利用した writer skill ではなく掲載媒体に合わせます。  \nそのため、`igapyon-qiita-writer` で作成した Note テック主記事でも、Note 掲載用の正本は `skills/igapyon-note-writer/references/` に置きます。\n\n## .gitignore の扱い\n\nmacOS が生成する `.DS_Store` は Git 管理対象外とするため、repo 側の `.gitignore` に記載します。\n\n`workplace/` は clone した外部リポジトリ、展開した zip、生成物、検証用ファイルなどを置くローカル作業フォルダです。  \n`workplace/` 配下の作業物は Git 管理対象外とし、ディレクトリを維持するための `workplace/.gitkeep` だけを Git 管理下に入れます。\n\n`.codex/skills/` は Codex から利用するためのローカル配備先です。  \nこの repo では `skills/` 配下を正本として管理し、`.codex/skills/` 配下のコピーは Git 管理対象外とします。\n`skills/` から `.codex/skills/` への反映は、必要なタイミングで手動実行します。Maven の `package` フェーズでは自動コピーしません。\n\n## Codex skills 更新後の反映 tips\n\nCodex skills を更新した後、基本は VS Code のウィンドウ再読み込みで有効になります。\n\nコマンドパレットから実行する場合は、次を実行します。\n\n```text\nDeveloper: Reload Window\n```\n\nmacOS の通常操作では、次のショートカットでコマンドパレットを開きます。\n\n```text\nCmd+Shift+P\n```\n\nその後、`Reload Window` を実行します。\n\nターミナルから VS Code を操作できる環境では、対象ワークスペースで次のコマンドでも近い動きになります。\n\n```sh\ncode -r .\n```\n\nただし、`code -r .` は同じウィンドウを再利用して開き直す動きです。拡張や Codex 側の状態更新まで確実に反映したい場合は、VS Code 内の `Developer: Reload Window` を使うのが一番確実です。\n\n## Java / Maven の扱い\n\nJava / Maven を使う repo では、実行時の JVM 設定を repo 側で明示するため、`.mvn/jvm.config` を Git 管理下に入れます。\n\nこの repo では、ローカル環境での名前解決やネットワーク挙動を安定させるため、IPv4 を優先する JVM オプションを `.mvn/jvm.config` に記載しています。\n\n## references の扱い\n\n各 skill 配下の `references/` は、skill 利用時に参照しやすいように同梱する参考資料です。\n\nskill を利用する際は、`SKILL.md` を入口とし、具体ルール、例、長めの手順、参照記事、テンプレートなどは必要に応じて各 skill 配下の `references/` を読んで適用します。  \n`SKILL.md` には発火条件、基本フロー、参照先の案内を中心に置き、詳細は `references/` 側を利用する方針です。\n\n`skill-creator` などで skill を作成した直後は、必要な具体ルールを `SKILL.md` に詰め込みすぎず、`references/` へ分離します。  \nまた、参照資料の全体像を探す必要がある skill では、`SKILL.md` に `index.json` を discovery index として使う旨を明記します。\n\nNote / Qiita 記事 Markdown は、各 writer skill 配下の `references/` を正本として管理します。\n\n- Note 記事の正本: `skills/igapyon-note-writer/references/`\n- Qiita 技術記事の正本: `skills/igapyon-qiita-writer/references/`\n\nみくく担当の Note テック主記事は、正本を `skills/igapyon-note-writer/references/` に置きます。  \n一方で、みくく文体の参照例として使うため、公開済みまたは参照価値の高い記事コピーを `skills/igapyon-mikuku-agent/references/examples/articles/` に同期して置きます。\n\nこのコピーは文体・構成の参照用です。記事本文、URL、掲載用属性を更新する場合は、まず Note 正本側を更新し、その後で `igapyon-mikuku-agent` 側の writing example にコピーして同期します。\n\n`references/general/` は、特定の `miku` 系プロダクトに分類されない一般記事用の置き場です。  \n`miku` 系プロダクトの記事は、各 writer skill の `references/\u003cproject\u003e/` に置きます。\n\n`workplace/*/docs/articles/` などに記事メモや旧配置の Markdown が残っている場合でも、記事として更新・公開対象にする正本は writer skill 配下の `references/` です。\n\n## docs/articles 集約状況\n\n記事管理は、Qiita 向け記事を `skills/igapyon-qiita-writer/references/`、Note 向け記事を `skills/igapyon-note-writer/references/` に集約し、そこを正本として扱う方針です。\n\n2026-05-06 時点で、`workplace/*/docs/articles/qiita/` 配下の有意な記事本文は、`README.md` と `TEMPLATE.md` を除き、すべて `skills/igapyon-qiita-writer/references/` 側に同一内容で存在することを確認済みです。\n\n対象は次の通りです。\n\n- `miku-abc-player`: 1 件\n- `miku-indexgen`: 1 件\n- `miku-xlsx2md`: 8 件\n- `mikuproject`: 4 件\n- `mikuscore`: 2 件\n\n同じく 2026-05-06 時点で、`workplace/*/docs/articles/note/` 配下の有意な記事本文は、`README.md` と `TEMPLATE.md` を除き、すべて `skills/igapyon-note-writer/references/` 側に同一内容で存在することを確認済みです。\n\n対象は次の通りです。\n\n- `miku-abc-player`: 1 件\n- `miku-indexgen`: 1 件\n- `miku-xlsx2md`: 3 件\n- `mikuproject`: 3 件\n- `mikuscore`: 2 件\n\n`mikuscore` の記事は、`workplace/docs-articles/mikuscore-devel/` と `workplace/docs-articles/miku-abc-player-devel/vendor/mikuscore/` の両方に重複して存在する場合があります。  \n集約先の `references/mikuscore/` では 1 セットとして保持します。\n\n`references/general/` 配下の記事は、`workplace/*/docs/articles/` 由来ではない一般記事を、この repo 側で集約管理するための置き場です。\n\n## 構成\n\n```text\n.\n├─ skills/\n│  ├─ igapyon-qiita-writer/\n│  │  ├─ SKILL.md\n│  │  └─ references/\n│  ├─ igapyon-note-writer/\n│  │  ├─ SKILL.md\n│  │  └─ references/\n│  ├─ igapyon-companion-techpost-writer/\n│  │  └─ SKILL.md\n│  ├─ igapyon-companion-musicpost-writer/\n│  │  └─ SKILL.md\n│  ├─ igapyon-github-writer/\n│  │  ├─ SKILL.md\n│  │  └─ references/\n│  ├─ igapyon-ffmpeg-helper/\n│  │  ├─ SKILL.md\n│  │  └─ references/\n│  ├─ igapyon-miku-soft-developer/\n│  │  ├─ SKILL.md\n│  │  └─ references/\n│  ├─ igapyon-mikuku-agent/\n│  │  ├─ SKILL.md\n│  │  ├─ assets/\n│  │  └─ references/\n│  └─ igapyon-repo-conventions/\n│     ├─ SKILL.md\n│     └─ references/\n├─ pom.xml\n├─ TODO.md\n└─ README.md\n```\n\n## 現在の skill\n\n- `igapyon-qiita-writer`\n\n  Qiita 向けの日本語技術記事の作成、整理、改善向け。明示的に指定した場合、または Qiita 記事化の意図が明確な場合に利用する。\n\n- `igapyon-note-writer`\n\n  Note 向けの日本語記事の作成、整理、改善向け。明示的に指定した場合、または Note 記事化の意図が明確な場合に利用する。\n\n- `igapyon-companion-techpost-writer`\n\n  技術系日本語投稿の伴走、最小整理、全文再構成向け。明示的に指定した場合、または伴走型の最小整理が明確に求められた場合に利用する。\n\n- `igapyon-companion-musicpost-writer`\n\n  音楽系日本語投稿の伴走、最小整理、全文再構成向け。明示的に指定した場合、または伴走型の最小整理が明確に求められた場合に利用する。\n\n- `igapyon-github-writer`\n\n  GitHub PR、GitHub Release、GitHub About に貼る文章の作成向け。明示的に指定した場合に利用する。\n\n- `igapyon-ffmpeg-helper`\n\n  H4essential のオーケストラ録音から、切り出し、単純ゲイン調整、必要なら結合、静止画付き YouTube 用動画作成までの個人用 FFmpeg ワークフロー向け。明示的に指定した場合に利用する。\n\n- `igapyon-miku-soft-developer`\n\n  miku-soft project の新規作成・既存保守ワークフロー向け。skill の利用を明示的に指定した場合のみ利用し、miku-soft 作成・保守の相談だけでは存在案内に留める。\n\n- `igapyon-mikuku-agent`\n\n  日本語キャラクター agent `みくく` として応答するための会話スタイル向け。明示的に指定した場合に利用する。\n\n- `igapyon-repo-conventions`\n\n  Git / GitHub repository の `.gitignore`、`workplace/`、`.codex/skills/`、Java / Maven 設定、README 運用ルールの整理向け。明示的に指定した場合に利用する。\n\n## index.json の更新\n\n各 skill の `index.json` を更新する場合は、次のコマンドで `skills/` 配下をまとめて再生成します。\n\n```sh\nmvn generate-resources\n```\n\nビルド全体とあわせて更新する場合は、次のコマンドでも `index.json` を更新できます。\n\n```sh\nmvn clean package\n```\n\n生成された `index.json` は、skill と一緒にコミットします。\n\n## Release archive\n\nGitHub Release に添付する利用者向け archive は、次のコマンドで作成します。\n\n```sh\nmvn clean package\n```\n\n生成物は `target/igapyon-agent-skills-\u003cversion\u003e.zip` です。\n\narchive には `README.md`、`INSTALL.md`、`LICENSE`、`pom.xml`、`.mvn/`、`lib/`、`skills/` を含めます。\n利用者は archive を展開し、`INSTALL.md` の手順で `skills/*` を自分の Codex skills directory へコピーします。\n\nrelease archive には、この repo の `skills/` に加えて、外部管理の miku-soft 系 skill も同梱します。\n外部 skill は `mvn package` の `prepare-package` フェーズで `target/release-staging/skills/` に取得し、archive 化します。\n取得元は `pom.xml` の `external.*` properties で固定します。\n\n同梱する外部 skill は次の通りです。\n\n- `miku-indexgen-skills` `v1.4.4.1`: `skills/igapyon-miku-indexgen/`\n- `miku-text-bundle-skills` `v0.8.1`: `skills/miku-text-bundle/`\n- `mikuproject-skills` `v0.8.1.1`: `skills/mikuproject/`\n- `mikuscore-skills` `v0.1.0`: `skills/mikuscore/`\n\nGitHub では `v*` tag が push されたときに GitHub Actions で `mvn clean package` を実行し、生成された zip を GitHub Release asset として添付します。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figapyon%2Figapyon-agent-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Figapyon%2Figapyon-agent-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figapyon%2Figapyon-agent-skills/lists"}