SuperAPI AI 工具集

night-market-architecture-contract

设计与创作

查看项目

更新于 10-15 17:21

技能介绍

用途:该技能记录支撑 claude-night-market 的设计决策、由强制代码维持的不变量,以及已知且被接受的弱点。在提出跨越插件边界、改动 hook、新增技能或升级版本的变更前应先阅读。每条主张都引用仓库内证据:ADR(docs/adr/)、提交哈希或已检入的强制文件。

主要能力:列出六类承重决策,包括插件为自包含可部署单元(ADR-0001)、hook 在宿主 Python(可低至 3.9)下从缓存目录运行、生态版本由 marketplace.json 统一扇出到各清单、技能发现预算有限且溢出静默、集体记忆与信任依赖外部服务、每个技能属于三种角色之一。同时给出不变量及其强制手段,例如 hook 导入链需兼容 Python 3.9、禁止裸 except、清单版本一致、技能图与退出条件漂移棘轮检查等。

使用方式:引用前先验证,例如 git log --oneline -1 <hash> 与 rg -n "Status" docs/adr/<file>.md。版本更新使用 uv run python plugins/sanctum/scripts/update_versions.py <version>。

适用场景:评审设计变更、判断技能是否为孤儿或枢纽、理解历史决策与回退原因。

限制:资料明确该技能不用于门禁,变更分类与评审应使用 night-market-change-control;事故历史、运维命令、配置目录、插件机制与故障排查分别由其他技能承担。部分 ADR 状态或数字已过时,需通过变更控制更新。