Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
git clone --depth 1 https://github.com/xc404/kiwiWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/rules/xc404/kiwi/api-frontend-integration)<a href="https://agentmods.dev/rules/xc404/kiwi/api-frontend-integration"><img src="https://agentmods.dev/badge/rules/xc404/kiwi/api-frontend-integration/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/rules/xc404/kiwi/api-frontend-integration"><img src="https://agentmods.dev/badge/rules/xc404/kiwi/api-frontend-integration.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00487 | $0.00487 |
| Opus 5.5 | $0.00195 | $0.00195 |
| Sonnet 5.5 | $0.00097 | $0.00097 |
| Haiku 4.5 | $0.00049 | $0.00049 |
Grade A, and why
api-frontend-integration scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
前后端对接与前端异步规范(kiwi)
1. 集合类接口与 CollectionResult
- 后端若直接返回
Collection或 数组,会经ResponseAdvice等逻辑包装为CollectionResult(字段content承载实际集合),再包在统一响应(如R)里。 - 前端对接时:不要假设 HTTP 体是「裸数组」;应从统一成功载荷中读取
content(或项目约定的等价路径),再映射为列表/表格数据。 - 列表接口若日后扩展分页,
CollectionResult也便于扩展字段;对接时以类型定义或服务层封装为准。
2. 异常与 ExceptionHandler
- 业务与框架异常由
ExceptionHandler(@ControllerAdvice)拦截,统一返回R.fail(...)(含业务码、消息等),而不是把 Java 异常栈直接暴露给浏览器。 - 前端错误处理应基于统一响应结构(成功/失败、
code、msg、data等)判断,并在 HTTP 拦截器或服务层集中处理登录失效、无权限等分支;不要只依赖catch原始 Error 文本当作后端语义。
3. 前端异步:优先 Observable
- 在 Angular 前端(
kiwi-admin/frontend)中,异步数据流优先使用 RxJSObservable(如HttpClient返回的流、switchMap/pipe组合),与现有服务层风格一致。 - 仅在边界处(如必须对接仅支持 Promise 的 API)再使用
lastValueFrom/firstValueFrom等转换;避免在业务层大面积混用async/await与 Observable 导致订阅与取消逻辑不一致。
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 23 lines · 487 tokens per session scan A 536b81455733
api-frontend-integration is a cursor rule published in the GitHub repository xc404/kiwi (7 stars, last pushed 1mo ago), licensed MIT. It adds 487 tokens to every session, about $0.0019 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other cursor rules, from other repositories
api-property-optionality-hygiene
Fix ApiProperty/ApiPropertyOptional optionality mismatches in DTO files; use for scheduled batch fixes or DTO edits.
python
Python best practices and patterns for modern software development with Flask and SQLite.
cursor
You are working on the checkout service. Preserve transaction integrity and auditability.
django
Definitive guidelines for writing maintainable, performant, and secure Django applications, emphasizing modern best practices, clear code organization, and efficient patterns.
shared-libraries
Shared libraries - condition framework, inventory containers, file-backed DB, itinerary, references.
selectools-providers
Rules for working with LLM provider adapters in selectools.