Agent Skills: Semantic Generation

|

UncategorizedID: TakumiOkayasu/dotfile-work/semantic-generation

Install this agent skill to your local

pnpm dlx add-skill https://github.com/TakumiOkayasu/dotfile-work/tree/HEAD/common/skills/semantic-generation

Skill Files

Browse the full folder contents for semantic-generation.

Download Skill

Loading file tree…

common/skills/semantic-generation/SKILL.md

Skill Metadata

Name
semantic-generation
Description
曖昧な指示対象や新しい用語が多い設計文書・命名作業で、referent tableを明示的に使って対応関係を整理したい場合に使用する。通常の文書作成や命名では使用しない。

Semantic Generation

語を先に作って対象を後付けすることで意味がずれる場面に限り、referent tableを補助線として使う。

使用条件

  • userがreferent tableまたは対応表を明示的に求めた
  • 同じ語が複数の状態・事象・値・責務を指しており、本文だけでは曖昧さを解消しにくい
  • public contractや命名で、誤った指示対象が後続実装へ波及するriskが高い

通常の設計文書、調査報告、短い命名、既存用語だけで成立する文章では使わない。

進め方

必要な行だけ、次の形で整理する。

| 出典 | 具体対象 | 役割 | 既存用語 | 候補語 |
| --- | --- | --- | --- | --- |
  • 具体対象 と 役割 を先に確定し、候補語はその後に置く
  • userの用語・既存domain用語を優先する
  • 新語が必要なら初出で意味を定義する
  • tableが不要になった時点で本文へ移り、table作成自体を目的化しない

境界

  • 別fileへの保存、hash記録、本文の破棄・再生成は要求しない
  • tableを独立成果物にするか本文内に置くかはtaskに合わせる
  • 曖昧さを通常推論で解消できるならskillを起動しない

禁止事項

  • 文書作成全般へ自動適用する
  • tableを作るためだけに対象や役割を増やす
  • 定義できない造語を導入する
  • userの既存用語を理由なく置き換える