Imported from Jxck/jxck.io (
AGENTS.md). Install upstream withnpx skills add Jxck/jxck.io. Copyright stays with the author.
Project Agent Policy
このリポジトリで作業する際の正本ルールです。
Project Notes
- ビルドの中心は
Makefileと.src/build.ts .src/build.tsは起動時にprocess.chdir(import.meta.dirname)するため、相対パスは.src/基準make(引数なし) とmake allは blog の一式 (make blog+make image) を実行する。make dictだけは h2o reload を伴うため明示的に実行するmake blogは記事の差分ビルドとindex.html更新を行い、最後にmake compを呼んで変更分の.br/.html.dcbを生成するmake dictは古い*.dict/*.dict.brを掃除してから辞書を再生成し、blog.jxck.io/dictionary/entries/<hash>.dictと配信用の<hash>.dict.brを作り、active.dict(<hash>.dictへの symlink) とh2o.dict.confを更新し、全.html.dcbも生成し直したうえで、最後にmake reloadで h2o に反映するmake compは通常の.brとblog.jxck.io/entries/**/*.html.dcbを生成するmake cleanは.br/.dcb/.dictを削除、make distcleanは全生成物を削除- 辞書生成・圧縮ツールは
.src/dictionary/、配信用辞書はblog.jxck.io/dictionary/entries/に置く - CDT 配信ロジックは
h2o.confではなく.mruby.handler/dcb.rbにある Dictionary-IDは Structured Fields String なので、mruby では"entries"のように quotes を含んだ値で比較する
Plan File Policy
- プラン作成・レビュー・固定化の正本ルールはグローバル skill (
planning) にある - プランを作成またはレビューする場合は、必ず
planningskill を使う
Skill Directory Workflow
- 共有 skill の正本は
.agents/skills/<skill>/に置く .claude/skills/<skill>と.codex/skills/<skill>は、原則としてその正本ディレクトリへの symlink にする- skill の内容を更新する場合は、正本だけを編集する
nameやdescriptionを含む frontmatter は正本だけに持たせる- Claude/Codex 側に内容を複製して持たない
Article Review Policy
- 記事のレビュー/校正ルールの正本は
.agents/skills/article-review/SKILL.mdに置く - 記事をレビューまたは校正する場合は、必ず
article-reviewskill を使う
Commit Message Policy
- commit message のルールの正本は
.agents/skills/commit-message/SKILL.mdに置く - commit message を書く場合は、必ず
commit-messageskill を使う