openharmony-cpp について
openharmony-cppは、OpenHarmony向けのC++コード作成、リファクタリング、レビューに使うスキルです。命名や書式、ヘッダー管理、安全なコーディングの規則をまとめています。
主な機能
- 01OpenHarmonyの命名・書式規則
- 02ヘッダーとインクルードの指針
- 03入力検証の要件
- 04メモリとビット演算の安全規則
活用シーン
- 01規約に沿ったクラスやモジュールの生成
- 02既存C++コードの整理
- 03規約に照らしたコードレビュー
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ openharmonyinsight/ openharmony-skills --skill openharmony-cppインストール後、Claude Code で/openharmony-cppを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/class_function_design.mdheaders_scopes.mdnaming_formatting.mdsecure_coding.md詳細
OpenHarmony C++ コーディングスキル
基本要件(よくある落とし穴)
これらのルールは OpenHarmony で厳格に適用され、一般的な C++ プロジェクトとは異なることがよくあります。
1. 厳格な命名規則と書式
- 拡張子: 常に
.cppと.hを使用します。 - ファイル: ファイル名はクラス名と一致させる必要があります(Unix 系の形式、例:
my_class.cpp)。 - 変数: グローバル変数は
g_で始める必要があります(例:g_config)。クラスメンバーは_で終える必要があります(例:value_)。 - 波括弧: K&R スタイルが必須です(開始波括弧を同じ行に置きます)。
- 詳細: naming_formatting.md を参照してください。
2. ヘッダー管理
- ガード:
#ifndefガードを使用します。#pragma once は禁止です。 - インクルード: 隠れた依存関係を防ぐため、前方宣言よりも
#includeを優先します。 - 詳細: headers_scopes.md を参照してください。
3. 重要なセキュリティ要件
- 入力検証: 外部データはすべて、使用前に検証する必要があります(インデックス、サイズ、ループ)。
- メモリ安全性: ポインターは削除後、直ちに
nullptrに設定する必要があります。 - ビット演算: 符号なし型に対してのみ行います。
- 詳細: secure_coding.md を参照してください。
使用ガイド
使用する場面
- 新しいコード: 新しいクラスやモジュールを生成するとき。
- リファクタリング: レガシーコードを整理するとき。
- レビュー: OpenHarmony の標準に照らしてコードを確認するとき。
リファレンス一覧
- naming_formatting.md:命名規則(g_、_)、波括弧(K&R)、行の長さ。
- secure_coding.md:入力検証、整数の安全性、メモリ管理、禁止されている関数。
- class_function_design.md:コンストラクター、継承、モダン C++(nullptr、const)、関数のサイズ。
- headers_scopes.md:ヘッダーガード、名前空間、インクルード規則。
コメント
Markdown 対応