docs: add achievement design skill

.codex/skills/th1-achievement-design/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: th1-achievement-design
+description: TH1 project workflow for designing, auditing, or rewriting achievement names and copy, especially wonder/civilization achievement tiers in Achievement.asset. Use when Codex needs to create TH1 成就命名, 奇观成就, 图鉴星星成就, civilization achievement sets, or derive achievement names from historical anecdotes, famous people, memorable events, or touching stories.
+---
+
+# TH1 Achievement Design
+
+## Source Of Truth
+
+Use this skill for achievement concept and naming work under `Unity/Assets/BundleResources/DataAssets/Achievement.asset`.
+
+Do not edit generated export/localization outputs such as `Unity/Assets/BundleResources/Export/*`, `Tools/Multilingual.xlsx`, or `Tools/MultilingualTxt.txt` unless the user explicitly asks for export/import workflow changes.
+
+When designing wonder achievements, also inspect `Unity/Assets/BundleResources/DataAssets/LibraryDataAssets.asset` for the wonder name, civilization, category, and `AchivePreId`.
+
+## Workflow
+
+1. Read the target achievement rows in `Achievement.asset` and nearby comparable rows.
+2. Read the target wonder or civilization rows in `LibraryDataAssets.asset` when applicable.
+3. Map achievement IDs before naming:
+   - `BigID: 3` is the wonder achievement group.
+   - `SmallID` matches the last two digits of `LibraryWonderData.AchivePreId`.
+   - Wonder achievement tiers usually use `InternalID` 1/2/3 with targets 10/20/30.
+4. Identify at least three historical hooks per wonder before proposing tier names.
+5. Prefer names that encode a story, person, quote, or surprising fact, not just a descriptive label.
+6. Keep game-facing text concise enough for UI labels.
+
+## Wonder Achievement Naming
+
+For a three-tier wonder achievement set, make every tier carry a distinct anecdote:
+
+- Tier 10: accessible place/object hook, founder, builder, visible landmark, or immediately recognizable feature.
+- Tier 20: deeper cultural or human story, including reforms, travel, scholarship, rituals, love, loyalty, exile, rivalry, or faith transition.
+- Tier 30: strongest remembered event, tragedy, mythic afterlife, famous quote, legacy, rediscovery, or historical turn.
+
+Use the existing first four empire style as the baseline:
+
+- Names are short Chinese titles, usually 4-12 characters, but can be longer for famous quotes or deliberate jokes.
+- A good name often hides a one-sentence explanation behind it: `最后一位图书管理员`, `你去你的凡尔赛`, `柏林墙的幽灵`, `玄奘访学`, `我见她在白雾中微笑`.
+- Mix tones across a civilization set: serious, poetic, witty, tragic, and warm names can coexist.
+- Use famous people by name when the person is the hook: ruler, scholar, architect, traveler, poet, musician, reformer, general, explorer, or mythic figure.
+- Avoid three names that all say the same thing with different nouns, such as three geographic labels.
+- Avoid opaque proper nouns unless the name still has rhythm or the surrounding set clearly supports it.
+
+## Historical Hook Quality
+
+Prefer hooks in this order:
+
+1. Directly tied to the target wonder.
+2. Directly tied to a famous person connected with that place.
+3. Widely known anecdote, quote, reform, tragedy, discovery, or pilgrimage related to the place.
+4. Broader civilization motif only when the wonder lacks a stronger local story.
+
+Do not invent false history. If a hook is uncertain, mark it as tentative instead of presenting it as canon.
+
+## Checks
+
+Before finishing:
+
+- Confirm every proposed achievement name maps to the correct `WonderLibrary` and `SmallID`.
+- Confirm the three tiers are distinguishable without reading a long explanation.
+- Confirm at least one tier in each wonder set references a named person or named group when historically appropriate.
+- If editing `Achievement.asset`, preserve YAML serialization shape and update only intended `Name`/`Desc`/condition fields.
+- If only raw DataAssets are edited, tell the user that Unity multilingual export/import must run to sync runtime `Export` assets.

.codex/skills/th1-achievement-design/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "TH1 Achievement Design"
+  short_description: "Design TH1 achievements with historical anecdote hooks."
+  default_prompt: "Use $th1-achievement-design to design TH1 achievement names from wonder, hero, or civilization context."