SuperAPI AI 工具集

wizard-development

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:本技能讲解 PostHog wizard 的架构设计哲学,在改动结构(新增功能、扩展 runner 等)前应先阅读。它回答系统为何是当前形态,而过程性技能只讲如何新增内容。

核心纪律:每个架构决策都围绕一个问题——接下来谁需要改动它,他们最少需要理解什么。由此产生可测试的承诺:产品知识绝不进入基础设施代码。runner 管线、TUI store、检测循环、prompt 组装器都是机器,不知道 PostHog 或框架是什么,只执行配置驱动的管线。知识放在带类型边界的配置面:FrameworkConfig、context-mill 中的技能 markdown、warlock 仓库中的 YARA-X 规则、programs/ 中的步骤数组、UI 组件等。

五条原则:一,路由到最窄的配置面,不往 runner 或 store 里塞产品逻辑;二,知识放 markdown 而非代码,prompt 组装器应短小;三,预防优先于恢复,分 L0 命令、L1 canUseTool 允许列表、L2 warlock 扫描三层,不确定时失败关闭;四,新能力是新 program 而非新分支,只加 ProgramConfig 并注册;五,UI 是状态的纯函数,无命令式导航。

扩展常见类型:新工具加到 wizard-tools.ts 并经 secret vault 处理密钥;新安全规则提交到 warlock;新检测信号加到 detection/features.ts;新中间件实现 Middleware 接口;新 TUI 原语放在 primitives/ 并在 playground 注册;agent 后步骤用 postRun,自定义结尾用 buildOutroData。

测试:使用 vitest,放在相邻 tests/。多数热点是纯函数,可直接测试;不要测试 agent 运行、SDK 调用与真实网络。完成前运行 pnpm build && pnpm test && pnpm fix。

限制:资料未提供该技能的具体安装命令、收费与价格信息,亦未提供官方支持平台说明。