agentleFS
arsen-ask-lxarsen-ask-lx/Agent_Quality_Kit/.claude/skills/search-first/SKILL.md

search-first

Skill4 starsChanged 2 months agoMITView on GitHub

Посмотреть наружу вместо догадки. Вызывать, когда не знаешь, как принято сейчас; не знаешь, есть ли готовое решение; собираешься написать распространённую вещь; помнишь ответ, но из обучения, а не из проверки. Также перед новой записью каталога и перед выбором библиотеки, формата или соглашения.

43 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use continuous-agent-loop, agent-harness-construction and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • junimnjwSkill

    continuous-agent-loop

    Patterns for continuous autonomous agent loops with quality gates, evals, and recovery controls.

    Also in 4 projects that use this

  • junimnjwSkill

    agent-harness-construction

    Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates.

    Also in 4 projects that use this

  • loulanyueSkill

    safety-guard

    Also in 3 projects that use this

  • loulanyueSkill

    rules-distill

    Scan skills to extract cross-cutting principles and distill them into rules — append, revise, or create new rule files

    Also in 3 projects that use this

  • dcs-soniSkill

    codebase-onboarding

    Help developers understand unfamiliar codebases quickly. Use when

    Also in 3 projects that use this

  • MicrosoftSkill

    error-handling

    统一错误处理系统。在添加 API 端点、修改错误处理、添加前端 API 调用、编写错误相关测试时使用。

    Also in 3 projects that use this

  • +2 more from junimnjw

The file

Files
SKILL.md

Сомнение — повод посмотреть наружу

Когда это обязательно

Не «когда захочется», а по признаку. Четыре признака:

  1. «Как это принято сейчас». Обучение кончилось в прошлом, мир нет.
  2. «Наверняка уже есть готовое». Правило «сперва готовое» — не пожелание: своя реализация распространённой вещи оплачивается собственной поддержкой навсегда.
  3. «Я это помню». Помнить и проверить — разные утверждения. Вспомненный API мог быть переименован, библиотека — заброшена, соглашение — заменено.
  4. Перед новой записью каталога. Раздел «готовый аналог» в README записи обязателен, и «не искал» — не ответ на него. Это единственная часть правила, за которой следит машина: bash tool/selfcheck/gates.sh.
  5. Всегда, когда возникло сомнение — даже если кажется мелочью и даже если владелец рядом. Человек чаще всего не знает тоже: он и позвал агента, чтобы не разбираться. Двое, не знающих как принято, договариваются до местного костыля — и тот выглядит согласованным решением, а не догадкой. У человека спрашивают, чего он хочет; как принято — спрашивают у мира.

Как искать, чтобы не получить пересказ

  • Ищи код, а не статьи. Репозиторий, исходник, issue — сильнее блога и сильнее выдачи. Разбор конкурентов по документации однажды дал нам три неверных вывода подряд; те же выводы, сделанные по их коду, оказались противоположными.
  • Смотри состояние, а не звёзды. Дата последнего коммита, доля коммитов от бота, открытые issue. Мёртвый проект с 88 ⭐ — не решение.
  • Проверь лицензию до того, как взял. Бывает «MIT, но»: у одного из разобранных нами проектов Modified MIT запрещает использовать код как данные для обучения.
  • Спроси, кто заполняет поле. Прежде чем копировать чужое решение — кто в нём источник истины: машина или автор? Поле, заполняемое автором, переносит к нам его дефект вместе с формой.

Что записать после

  • Нашёл готовое и взял — назвать в коде или README, откуда.
  • Нашёл готовое и не взял — назвать причину. «Не подошло» без причины через месяц читается как «не искали», и поиск повторяют.
  • Не нашёл — так и сказать. «Не искал» и «нет» — разные утверждения, и второе сильнее.

Чего не делать

  • не пересказывать выдачу поисковика как факт: выдача — это заголовки, а не проверка;
  • не искать то, что проверяется прогоном за секунду: у себя в репозитории смотрят грепом;
  • не превращать поиск в отговорку от работы — минута на проверку, а не час на чтение.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.