Compétences core-development
📦

core-development

Sûr

FigramコアDSL処理パッケージの開発

Également disponible depuis: 7nohe

Figramコアパッケージは、タイプ、検証、正規化、差分ロジック間で慎重な調整が必要です。このスキルは、タイプ安全性と一貫したデータフローパターンでDSL処理を拡張するための構造化されたワークフローを提供します。

Prend en charge: Claude Codex Code(CC)
⚠️ 67 Médiocre
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "core-development". Add a 'healthCheck' property to nodes that can be 'healthy', 'warning', or 'critical'

Résultat attendu:

  • • Added DSLNode.healthCheck and IRNode.healthCheck to types.ts
  • • Updated validate.ts: healthCheck must be one of ['healthy', 'warning', 'critical']
  • • Updated normalize.ts: default healthCheck to 'healthy' when undefined
  • • Updated diff.ts: nodes with same ID but different healthCheck trigger upsertNode
  • • Added tests in validate.test.ts for valid/invalid healthCheck values
  • • Added tests in normalize.test.ts for default value handling

Audit de sécurité

Sûr
v3 • 1/10/2026

This skill is purely documentation-based with no executable code, scripts, or network capabilities. It provides guidance for working with TypeScript type definitions, validation, normalization, and diff algorithms in a DSL processing pipeline.

1
Fichiers analysés
144
Lignes analysées
0
résultats
3
Total des audits
Aucun problème de sécurité trouvé

Score de qualité

38
Architecture
100
Maintenabilité
83
Contenu
20
Communauté
100
Sécurité
78
Conformité aux spécifications

Ce que vous pouvez construire

コアパッケージのタイプを拡張する

適切な検証および正規化サポートを備えたDSLに新しいノードまたはエッジプロパティを追加します。

検証バグを修正する

YAML検証で不正なエラーメッセージを引き起こすエッジケースを診断および修正します。

パッチ操作を追加する

CLIとFigJam plugin間の拡張された同期のための新しいパッチ操作タイプを実装します。

Essayez ces prompts

ノードプロパティの追加
types.tsのDSLNodeとIRNodeに新しい'color'プロパティを追加します。次に、colorが有効な16進数文字列であることを確認するためにvalidate.tsを更新し、デフォルト値を設定するためにnormalize.tsを更新し、等価性チェックでcolorの変更を処理するためにdiff.tsを更新します。
検証ルールの追加
validate.ts内のすべてのルール配列内のノードIDがドキュメント内において一意であることを確認する検証ルールを追加します。重複ID検出のためのテストケースを追加します。
差分出力をデバッグする
diff.tsの実装をレビューします。ノードラベルのみが変更された2つのIRDocumentを比較する場合、差分アルゴリズムが upsertNode と removeNode+upsertNode 操作のどちらが必要かをどのように判断するかを説明してください。
WebSocketプロトコルの更新
部分的なドキュメント同期を要求するための新しい'sync'メッセージタイプをWebSocketプロトコルに追加します。types.ts内の適切なインターフェースを更新し、期待されるメッセージフローを文書化します。

Bonnes pratiques

  • 新しいプロパティを追加するとき、タイプ、検証、正規化、差分ロジックを同期させてください
  • 検証エラー、正規化デフォルト、差分エッジケースのテストケースを追加してください
  • 問題を処理パイプラインを通じて追跡するために文書化されたデータフローに従ってください

Éviter

  • 対応するDSLタイプと正規化ロジックなしでIRにプロパティを追加する
  • 新しいフィールドを追加するとき検証をスキップして、ランタイムエラーにつながる
  • 正規化の等価性チェックを更新せずに差分ロジックを変更する

Foire aux questions

YAML検証を処理するファイルはどれですか?
packages/core/src/のvalidate.tsには、説明的なエラーメッセージを持つDSL入力のすべての検証ロジックが含まれています。
新しいプロパティはDSLに追加されますか?
последова的にtypes.ts、validate.ts、normalize.ts、diff.tsを更新します。各レイヤにテストを追加します。
増分更新は何を生成しますか?
diff.tsは2つのIRDocument間の差分を計算し、効率的な更新のためのPatch操作を生成します。
データを処理するのは安全ですか?
はい。コアパッケージは依存関係がなく、ネットワークアクセスやファイルシステム書き込みなしでメモリ内でデータを処理します。
テスト失敗はどのように診断されますか?
bun test packages/core/を実行して、どのレイヤが失敗したかを確認します。問題の原因を特定するためにデータフローを追跡します。
これは他のDSLツールとどのように比較されますか?
Figramは特にアーキテクチャ図に焦点を当て、YAMLからFigJam変換のための最小でタイプセーフなパイプラインを提供します。

Détails du développeur

Structure de fichiers

📄 SKILL.md