用途:把常见的“我的用户手册”文档改写成一份 OpenAPI 风格的个人 API 规范,用行为而非价值观描述与他人的协作方式。核心检验标准是:新同事读完后是否会改变行为。
主要能力:产出一份个人 API 规范,包含端点(人们最常找你做的 4–6 件事,含方法、路径、请求内容、响应与时限)、顶部快速上手(覆盖 90% 场景的三个调用)、速率限制(每日会议容忍度、专注时段、各渠道真实响应时间)、错误码(如 429、400、503,写出症状、不该做什么与重试策略)、认证与权限范围、计划维护时间以及 2–3 条诚实的变更日志。可选产出团队版规范及主持说明。
使用方式:先收集输入——他人应如何向你提需求(渠道、上下文深度、什么样的请求可执行或令人反感)、真实容量、真实失败模式、信任的建立与消耗、能量来源与消耗。撰写时需追问具体行为版本,为端点设定真实数字,将错误码写成自我认知,并加入认证、变更日志与快速上手。
适用场景:个人协作文档、团队工作协议、新人入职第一周参考。限制:需要本人诚实提供信息;不写只有顺利路径的规范;不伪造或隐藏怪癖;需随角色变化重新版本化。官方文本未提供,具体命令、平台与收费信息暂未提供。