AgentSkillsCN

用語・表記ガイドライン

严格遵循日语书写规则,统一片假名用法。在代码生成、文档撰写以及UI文案制作时,务必加以应用。

SKILL.md
--- frontmatter
name: 用語・表記ガイドライン
description: 日本語表記ルール、カタカナ語の統一。コード生成、ドキュメント作成、UI文言作成時に必ず適用。

用語・表記ガイドライン

カタカナ語の表記(長音記号なし)

このプロジェクトでは、以下のカタカナ語は長音記号(ー)を省略して表記します。

✅ 正しい❌ 使用禁止
サーバサーバー
ユーザユーザー
コンピュータコンピューター
プリンタプリンター
スキャナスキャナー
ルータルーター
ブラウザブラウザー
フォルダフォルダー
パラメータパラメーター
マネージャマネージャー
プロバイダプロバイダー
コントローラコントローラー
ハンドラハンドラー
レンダラレンダラー

コード・UIでの適用

翻訳ファイル

typescript
// ✅ 正しい
const translations = {
  ja: {
    serverUrl: "サーバURL",
    userName: "ユーザ名",
    userManagement: "ユーザ管理",
    serverError: "サーバエラー",
  }
};

// ❌ 使用禁止
const translations = {
  ja: {
    serverUrl: "サーバーURL",
    userName: "ユーザー名",
  }
};

コメント

typescript
// ✅ 正しい
// サーバから取得したユーザ情報を処理

// ❌ 使用禁止
// サーバーから取得したユーザー情報を処理

UI文言

tsx
// ✅ 正しい
<label>ユーザ名</label>
<p>サーバに接続中...</p>

// ❌ 使用禁止
<label>ユーザー名</label>
<p>サーバーに接続中...</p>

長音を維持する語

以下の語は長音記号を維持します(省略すると意味が変わる・不自然になる語):

  • データ(データ)
  • エラー(エラー)
  • モジュール(モジュール)
  • ファイル(ファイル)
  • メール(メール)
  • ツール(ツール)
  • ルール(ルール)
  • プール(プール)
  • キー(キー)
  • メニュー(メニュー)

チェックリスト

コード生成・文言作成時:

  • 「サーバー」→「サーバ」に修正
  • 「ユーザー」→「ユーザ」に修正
  • その他の長音省略対象語を確認
  • 翻訳ファイル・UI・コメントすべてで統一