refactor(agents): simplify librarian code search guidance

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
YeonGyu-Kim
2026-04-22 12:56:07 +09:00
parent acd867ec9d
commit 70e18e95c4
+5 -11
View File
@@ -141,11 +141,9 @@ Step 2: Get commit SHA for permalinks
cd \${TMPDIR:-/tmp}/repo-name && git rev-parse HEAD
Step 3: Find the implementation
- ast_grep_search for code shape (function/class/impl declarations)
pattern must be valid source code using $VAR and $$$ - NOT regex
- grep for string literals, log tags, config keys, comments
- read the specific file for surrounding context
- git blame for history if needed
- grep/ast_grep_search for function/class
- read the specific file
- git blame for context if needed
Step 4: Construct permalink
https://github.com/owner/repo/blob/<sha>/path/to/file#L10-L20
@@ -248,12 +246,8 @@ https://github.com/tanstack/query/blob/abc123def/packages/react-query/src/useQue
- **Sitemap Discovery**: Use webfetch - \`webfetch(docs_url + "/sitemap.xml")\` to understand doc structure
- **Read Doc Page**: Use webfetch - \`webfetch(specific_doc_page)\` for targeted documentation
- **Latest Info**: Use websearch_exa - \`websearch_web_search_exa("query ${new Date().getFullYear()}")\`
- **Fast Code Search (cross-repo, text or regex)**: Use grep_app - \`grep_app_searchGitHub(query, language, useRegexp)\`
- **Deep Code Search (single repo, text or regex)**: Use gh CLI - \`gh search code "query" --repo owner/repo\` or \`grep\` on a cloned repo
- **AST Pattern Search (cloned repo, by code shape)**: Use ast_grep_search on a cloned repo. Patterns are strict AST, NOT regex:
- Valid: \`function $NAME($$$) { $$$ }\`, \`class $C { $$$ }\`, \`impl $T for $S { $$$ }\`, \`callee($$$)\`
- Never pass regex: \`|\` (alternation), \`.*\` (wildcards), \`\\w\` / \`\\d\` (escapes), \`[a-z]\` (character classes)
- For text search or cross-repo search prefer grep_app or grep
- **Fast Code Search**: Use grep_app - \`grep_app_searchGitHub(query, language, useRegexp)\`
- **Deep Code Search**: Use gh CLI - \`gh search code "query" --repo owner/repo\`
- **Clone Repo**: Use gh CLI - \`gh repo clone owner/repo \${TMPDIR:-/tmp}/name -- --depth 1\`
- **Issues/PRs**: Use gh CLI - \`gh search issues/prs "query" --repo owner/repo\`
- **View Issue/PR**: Use gh CLI - \`gh issue/pr view <num> --repo owner/repo --comments\`