菜单
CraftBuddy TypeScript conventions for AFNM ModAPI work. Activate when writing or reviewing TypeScript, adding interfaces, touching globals, or considering any/ts-ignore.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Standardized commit messages and branch naming for AFNM mod projects. Activate when creating commits, branches, or release tags to follow the project's conventional commit format.
CraftBuddy orientation for Ascend From Nine Mountains mod work. Activate first for AFNM-CraftBuddy tasks to route into optimizer, runtime integration, UI validation, ModAPI lookup, validation, and release skills without bulk-loading docs.
CraftBuddy release and Workshop publishing workflow. Activate when bumping versions, packaging, uploading to Steam Workshop item 3661729323, pushing release commits, tagging GitHub releases, changing Workshop description copy, or for any Steam Workshop upload mechanics.
CraftBuddy ModAPI lookup workflow. Activate when using AFNM hooks, actions, utilities, root-state APIs, gameData, injectUI, registerOptionsUI, or when verifying API signatures before implementation.
Browser automation CLI for agents. Use for opening pages, clicking, filling forms, taking screenshots, reading DOM snapshots, testing local harnesses, or connecting to AFNM/Electron DevTools sessions.
CraftBuddy debugging methodology. Activate when typecheck/build/runtime/test failures occur, optimizer behavior regresses, auto-craft stalls, or repeated fix attempts start to thrash.
| name | typescript-afnm |
| description | CraftBuddy TypeScript conventions for AFNM ModAPI work. Activate when writing or reviewing TypeScript, adding interfaces, touching globals, or considering any/ts-ignore. |
This repo runs TypeScript in strict mode and uses runtime-shaped AFNM data. Keep type boundaries explicit.
any, @ts-ignore, unchecked casts, or bundled externalsstrict or weaken tsconfig.json.unknown plus type guards over any.src/modContent/*; optimizer modules should receive normalized data only.src/ui/* and do not let UI concerns enter search logic.bun run typecheck; build transpilation is not a substitute.AFNM runtime APIs can drift across game versions. Use optional chaining and stable fallbacks:
const snapshot = window.modAPI?.getGameStateSnapshot?.() ?? null;
const unsubscribe = window.modAPI?.subscribe?.(() => {
// observe state changes; dispatch side effects elsewhere
});
const getNextCondition = window.modAPI?.utils?.getNextCondition;
Never assume hook/util presence without a guard. Verify questionable APIs with bun run runtime:grep -- "<symbol>".
Declare project globals in src/global.d.ts. CraftBuddy's public debug surface is window.craftBuddyDebug.
declare global {
interface Window {
craftBuddyDebug?: CraftBuddyDebugApi;
modAPI?: ModAPI;
}
}
Use afnm-types for runtime contracts and import type-only symbols with import type when possible:
import type { ModAPI, RootState, CraftingTechnique } from 'afnm-types';
import { GAME_VERSION } from 'afnm-types';
If installed runtime behavior disagrees with types, verify with runtime-oracle / runtime:grep, then narrow at the adapter boundary instead of spreading casts.
React, ReactDOM, MUI, and MUI Icons are runtime externals in webpack.config.js; do not bundle duplicate copies.
Formatting is controlled by .prettierrc: 2 spaces, single quotes, trailing commas, LF endings, no tabs.
craftbuddy-runtime-integration — data-source priority and runtime boundary rulestypescript-best-practices — general TypeScript patterns