diff --git a/.claude/skills/kintone-provision/SKILL.md b/.claude/skills/kintone-provision/SKILL.md index d9431f2..8b53b2a 100644 --- a/.claude/skills/kintone-provision/SKILL.md +++ b/.claude/skills/kintone-provision/SKILL.md @@ -45,9 +45,9 @@ Markdown設計ドキュメント | company_name | 文字列(1行) | 会社名 | ○ | | | contact_name | 文字列(1行) | 担当者名 | ○ | | | email | リンク | メールアドレス | | protocol: MAIL | -| phone | 文字列(1行) | 電話番号 | | | +| tel | 文字列(1行) | 電話番号 | | | | status | ドロップダウン | ステータス | ○ | 新規, 商談中, 成約, 失注 | -| note | 文字列(複数行) | 備考 | | | +| memo | 文字列(複数行) | 備考 | | | ### ビュー - 全件一覧: company_name, contact_name, status, email @@ -66,6 +66,23 @@ Markdown設計ドキュメント | description | 文字列(複数行) | 詳細 | | | ``` +### フィールドコードの命名規則 + +フィールドコードは **英語 snake_case** で命名する(ラベルは日本語のまま)。 +ユーザーが設計ドキュメントでフィールドコードを明示的に指定している場合はそれに従う。 +指定がない場合は以下の規則で自動命名する。 + +| ルール | 例 | +|---|---| +| 業務固有の用語はローマ字 | `bumon_code`, `tokuisaki_name`, `souko_code`, `shohin_code` | +| 一般的な項目は英語 | `zip_code`, `tel`, `fax`, `email`, `memo` | +| 区分は `_kbn` | `tax_kbn`, `delete_kbn`, `shohin_kbn` | +| フラグは `_flag` | `souko_renkei_flag`, `disabled_flag` | +| 日付は `_date` | `torihiki_start_date`, `campaign_start_date` | +| 金額は `_amount` | `genka_amount`, `yoshin_limit` | +| 名称は `_name` | `bumon_name`, `tokuisaki_name1` | +| 略称は `_short` | `tokuisaki_short`, `nouhin_short` | + ### フィールド型の対応表 ドキュメント内では日本語名またはkintone APIの型名のどちらでも使用可能です。 diff --git a/CLAUDE.md b/CLAUDE.md index 56d0c1a..7ef2199 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -91,6 +91,14 @@ npm run typecheck ## kintone開発ルール +### フィールドコードの命名規則 + +フィールドコードは英語 snake_case で命名する。ラベル(表示名)は日本語。ユーザーが明示的にコードを指定した場合はそれに従う。 + +- 業務固有の用語はローマ字: `bumon_code`, `tokuisaki_name`, `souko_code` +- 一般的な項目は英語: `zip_code`, `tel`, `fax`, `email`, `memo` +- 区分 `_kbn`, フラグ `_flag`, 日付 `_date`, 金額 `_amount`, 名称 `_name` + ### 組み込みAPI優先 JSカスタマイズを実装する際、自前でロジックを書く前にkintone JS APIの組み込み関数で実現できないか必ず https://cybozu.dev/ja/ で調べること。組み込みで対応可能なものは組み込みを使う。