RRepoGEO

REPOGEO 报告 · LITE

ciembor/agent-rules-books

默认分支 main · commit a7d76490 · 扫描时间 2026/5/18 16:51:51

星标 1,469 · Fork 211

本仓库扫描历史

下方为分数趋势（含全部就绪扫描；左旧右新，可横向滚动）。表格明细默认折叠，展开后每页 10 条，最新在上。

分数趋势（左 → 右：旧 → 新）

共 2 条就绪扫描。点击下方按钮展开表格（每页 10 条，可翻页）。

AI 可见性总分
27 /100
亟需修复
品类召回
0 / 2
在所有问题中均未被推荐
规则结果
通过 2 · 警告 0 · 失败 0
客观元数据检查
AI 认识你的名字
1 / 3
直接询问时，AI 是否点名你的仓库
如何阅读这份报告

行动计划告诉你下一步要做什么——按影响力排序、可直接复制粘贴的修改。品类可见性是真正的 GEO 测试：当用户向 AI 提一个不带品牌、本应让 ciembor/agent-rules-books 浮出水面的问题时，AI 是真的推荐了你，还是推荐了你的竞品？客观检查验证 AI 引擎最先权衡的那些元数据信号。自指检查判断 AI 是否还认识你的名字。

行动计划 — 可复制粘贴的修复

3 条由 gemini-2.5-flash 生成、按优先级排序的修改。修完后请把对应条目标记为完成。

整体方向
  • highreadme#1
    Reposition README H1 and description to clarify 'AI coding agents' and 'software engineering principles'

    原因：

    当前
    <h1 align="center">AI agents Rules / Skills from<br />Programming Books v0.5</h1>

<p align="center"><strong>AGENTS.md rules</strong> / <strong>skills</strong> for <strong>Codex</strong>, <strong>Cursor</strong>, <strong>Claude Code</strong>, distilled from classic <strong>software engineering books</strong> about refactoring, architecture, DDD and code quality.</p>

Description: AGENTS.md rules / skills for AI coding agents: Codex, Cursor & Claude Code. Inspired by Clean Code, Refactoring, DDD, Clean Architecture and DDIA programming books.
    复制粘贴的修复
    <h1 align="center">Software Engineering Principles for AI Coding Agents<br />(Rules / Skills from Programming Books v0.5)</h1>

<p align="center"><strong>AGENTS.md rules</strong> / <strong>skills</strong> to guide <strong>AI coding agents</strong> like <strong>Codex</strong>, <strong>Cursor</strong>, and <strong>Claude Code</strong>, distilling classic <strong>software engineering books</strong> on refactoring, architecture, DDD, and code quality into actionable prompts.</p>

Description: Actionable AGENTS.md rules / skills to guide AI coding agents (Codex, Cursor, Claude Code) in applying Clean Code, Refactoring, DDD, Clean Architecture, and DDIA principles to AI-generated code.
  • mediumtopics#2
    Add more specific topics to reinforce AI coding agent guidance

    原因：

    当前
    agent-rules, agent-skills, agents-md, ai-agent, ai-skills, claude-code, claude-code-skills, code-quality, codex, codex-skills, cursor-rules, cursor-skills, domain-driven-design, programming-books, refactoring
    复制粘贴的修复
    agent-rules, agent-skills, agents-md, ai-agent, ai-coding-assistant, ai-skills, claude-code, claude-code-skills, code-quality, codex, codex-skills, cursor-rules, cursor-skills, domain-driven-design, programming-books, refactoring, software-engineering-for-ai, ai-code-quality
  • lowreadme#3
    Add a 'Comparison' section to the README

    原因：

    复制粘贴的修复
    ## Comparison to other tools

Unlike linters (ESLint, Prettier) or static analysis tools (SonarQube, CodeClimate) that analyze existing code, this repository provides *guidelines and rule sets* for *AI coding agents* to *generate* cleaner, more maintainable code from the outset. It is not a security rule engine like Wazuh, but rather a framework for applying classic software engineering principles to AI-assisted development.

本次扫描解析到的品类 GEO 通道：google/gemini-2.5-flash, deepseek/deepseek-v4-flash

品类可见性 — 真正的 GEO 测试

向 google/gemini-2.5-flash 提出的不带品牌问题。AI 推荐了你，还是推荐了别人？

各模型使用同一组问题 — 切换标签对比回答与排名。

召回
0 / 2
0% 的问题里出现了 ciembor/agent-rules-books
平均排名
—
越小越好。#1 表示首位推荐。
声量占比
0%
在所有被点名的工具中，你占了多少？
头号对手
ESLint
在 2 个问题中被推荐 1 次
竞品排行
  1. ESLint · 被推荐 1 次
  2. Prettier · 被推荐 1 次
  3. SonarQube · 被推荐 1 次
  4. CodeClimate · 被推荐 1 次
  5. Husky · 被推荐 1 次
  • 品类问题
    How can I guide my AI coding assistant to write cleaner, more maintainable code?
    你：未被推荐
    AI 推荐顺序：
    1. ESLint
    2. Prettier
    3. SonarQube
    4. CodeClimate
    5. Husky
    6. lint-staged
    7. Reviewdog
    8. GitHub Actions
    9. GitLab CI/CD
    10. Jenkins

    AI 推荐了 10 个替代方案，却始终没点名 ciembor/agent-rules-books。这就是要补上的差距。

    查看 AI 完整回答
  • 品类问题
    What frameworks or guidelines exist to apply classic software design principles to AI-generated code?
    你：未被推荐
    AI 推荐顺序：
    1. SOLID Principles
    2. Design Patterns
    3. Clean Code
    4. Domain-Driven Design
    5. Test-Driven Development
    6. Layered Architecture
    7. Microservices
    8. Hexagonal Architecture

    AI 推荐了 8 个替代方案，却始终没点名 ciembor/agent-rules-books。这就是要补上的差距。

    查看 AI 完整回答

客观检查

针对 AI 引擎最看重的元数据信号的规则审计。

  • Metadata completeness
    pass

  • README presence
    pass

自指检查

当被直接问到你时，AI 是否还知道你的仓库存在？

  • Compared to common alternatives in this category, what is the core differentiator of ciembor/agent-rules-books?
    pass
    AI 未点名 ciembor/agent-rules-books —— 很可能在说另一个项目

    AI 的回答可能信誓旦旦却是错的。请按事实核对：技术栈、目标人群、差异化点是不是和你实际的对得上？

  • If a team adopts ciembor/agent-rules-books in production, what risks or prerequisites should they evaluate first?
    pass
    AI 明确点名了 ciembor/agent-rules-books

    AI 的回答可能信誓旦旦却是错的。请按事实核对：技术栈、目标人群、差异化点是不是和你实际的对得上？

  • In one sentence, what problem does the repo ciembor/agent-rules-books solve, and who is the primary audience?
    pass
    AI 未点名 ciembor/agent-rules-books —— 很可能在说另一个项目

    AI 的回答可能信誓旦旦却是错的。请按事实核对：技术栈、目标人群、差异化点是不是和你实际的对得上？

嵌入你的 GEO 徽章

把这个徽章贴进 ciembor/agent-rules-books 的 README。每次重新扫描都会自动更新，并跳到最新报告——是「我在乎 AI 可发现性」最简单的公开证明。

RepoGEO badge preview实时预览
MARKDOWN（README）
[![RepoGEO](https://repogeo.com/badge/ciembor/agent-rules-books.svg)](https://repogeo.com/zh/r/ciembor/agent-rules-books)
HTML
<a href="https://repogeo.com/zh/r/ciembor/agent-rules-books"><img src="https://repogeo.com/badge/ciembor/agent-rules-books.svg" alt="RepoGEO" /></a>
Pro

订阅 Pro，解锁深度诊断

ciembor/agent-rules-books — 轻量扫描仍免费；本卡列出 Pro 相对轻量的深度额度。

  • 深度报告每月 10 次
  • 无品牌品类查询5，轻量 2
  • 优先行动项8，轻量 3