메뉴
AbilityKit 设计文档治理——Docs/design/ canonical 体系与 00-index.md 总索引、E0-E5 证据分级、文档类型(能力地图/Canonical/接入指南/审计/演进计划)、单篇最小结构、事实状态语言(规范/实现/示例策略/目标/限制)、能力下沉判定、文档版本记录维护。触发场景：写/改设计文档、判成熟度、E0-E5、canonical、能力地图、事实基线、文档版本、能力下沉、区分框架原语与项目应用层。
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/HOBOBO/AbilityKit --skill design-docs명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
AbilityKit MOBA 技能框架速查与实现约束。涵盖两套触发器引擎（旧字符串键引擎 + 新 Plan 行为树引擎）、技能施放管线（SkillPipelineRunner/SkillCastCoordinator）、Pipeline（com.abilitykit.pipeline 独立包）、Effect 系统（替代旧 EffectSource）、BUFF 生命周期、Combat/Damage Pipeline、Continuous、Host/WorldBlueprints 多包装配、Console Demo 运行调试。触发场景：用户提到 abilitykit、技能 cast/pipeline、触发器 trigger、event bus、被动 Passive、Plan 行为树、BUFF apply/remove/tick、EffectService/EffectInstance、PipelineRuntime/EditorPipelineRegistry、HostRuntime/WorldBlueprintRegistry、IWorldModule、Console Demo、dotnet run、AutoTestRunner、Configs/moba|luban|ability、帧同步日志、DamagePipeline、Continuous、MobaTriggerPlanExecutor。
AbilityKit 定点数与确定性栈——com.abilitykit.deterministic 定点数学(Fixed64/Q32.32/FixedVec/CORDIC 三角/DeterministicHash)、DeterministicMathBridge 收敛层、raw long 快照约定、帧时钟确定≠全战斗确定的边界、定点改造配方(基类 raw 存储+float 视图)、已知漂移源(遍历序/System.Math/float 计时)。触发场景：定点化改造、确定性 bug、漂移排查、Fixed64、raw long 快照、回滚 payload、golden 测试、帧同步一致性、位一致断言、MathUtil.Sqrt、DeterministicMathBridge。
AbilityKit 框架包发布流程——OpenUPM scoped registry + monorepo cohort 版本(0.1.0) + 白名单批次；tools/publish/ 工具链(align-versions.js/audit-versions.js/release.js/release-manifest.json)；thirdparty/demo 永不发布；dry-run 打 tag 流程与依赖闭环 gate。触发场景：发布包、改 package.json 版本/keywords/author、对齐版本、清 BOM、打 tag、查发布批次、新增包进白名单、发布审计。
SOC 직업 분류 기준
SKILL.md 표시 중
| name | design-docs |
| description | AbilityKit 设计文档治理——Docs/design/ canonical 体系与 00-index.md 总索引、E0-E5 证据分级、文档类型(能力地图/Canonical/接入指南/审计/演进计划)、单篇最小结构、事实状态语言(规范/实现/示例策略/目标/限制)、能力下沉判定、文档版本记录维护。触发场景：写/改设计文档、判成熟度、E0-E5、canonical、能力地图、事实基线、文档版本、能力下沉、区分框架原语与项目应用层。 |
基于源码核校（2026-08-17）。设计文档是"能力边界、源码落点、生命周期、限制、证据等级"的 canonical 入口，总索引是 Docs/design/00-index.md。写/改任何跨模块结论前，先看它。
| 等级 | 含义 |
|---|---|
| E0 | 源码/接口/配置存在，可定位实现 |
| E1-E2 | 有示例消费者，或进入某项目/服务端主链 |
| E3 | 有可执行的单元/契约/本地回环测试 |
| E4 | 有指定环境、配置和日期的 Smoke/Acceptance artifact |
| E5 | 有实际 CI/发布门禁、预算和失败阻断责任 |
铁律：局部 E3 不能外推为跨平台 E4；workflow 文件存在 ≠ 本次 E5 运行结果；"存在实现" ≠ "生产就绪"。下结论/写文档时显式标证据等级，别拿类名当能力。
能力地图 / Canonical 设计 / 接入指南 / 示例分析 / 历史审计 / 演进计划。每篇开头用 > 文档类型：… 声明，并带 事实基线 日期。
能力定位 → 文档类型 → 设计方案（抽象边界/核心对象/生命周期/扩展点）→ 源码入口（Unity 包/.NET 工程/Server 工程）→ 运行流程（Mermaid）→ 使用路径 → 事实状态 → 风险与约束（生命周期/线程/确定性/性能/跨端）。
规范约束 / 当前实现 / 示例策略 / 目标设计 / 已知限制 / 历史结论——同一篇里绝不能把"示例策略"写成"框架默认"，把"目标设计"写成"当前实现"。
一段示例代码要同时满足 5 条才下沉：①语义稳定 ②依赖可反转 ③所有权明确 ④扩展成本受控 ⑤交叉验证（第二个非同构示例/真实项目证明）。只满足"多个项目大概都有这段代码"→ 保留为 Recipe/Starter/示例，不发布为运行时依赖。
文档类型：… | 事实基线：YYYY-MM-DD | 证据等级：… + *文档版本：vX.Y | 最后更新：YYYY-MM-DD*。00-index.md 末尾有版本记录表：改动要加一条 | 日期 | 版本 | 内容范围 |，历史记录行不删（是 changelog，不是当前状态）。ModifierPipeline.Create() 注释与实现不符、logic World 双定义等）。04-PresentationLayerDesign/04-* 实际是客户端流程运行时），改结构前先看 00-index.md 的"文档目录"导航，别乱建新编号。