feat(cli): --guide — task-oriented help so a new agent knows how to use CodeLens (closes #319)#320
Merged
Merged
Conversation
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
…se CodeLens (closes #319) `codelens --help` lists commands; a new agent still has to guess how to invoke them. `codelens --guide` answers "I want to do X — what do I run?" with a task→command map, copy-paste examples, explicit positional conventions, and sub-checks derived live from each umbrella's _CHECKS. `--format json` gives a machine-parseable form. A flag like --command-count, so command count stays 12. The traps found by dogfooding are baked in: search's positional is the PATTERN (first; workspace optional second) — the reverse of every other command; trace resolves backend symbols best with --domain backend; a machine-format arg error lands on stdout as {"s":"error"} (#315), so empty is really empty. A test guard parses every task command and asserts its umbrella is a real command and its --check exists in that umbrella's _CHECKS — the guide can never silently hand an agent a wrong invocation. Verified: guide renders (human + json), all 15 task commands reference real commands/checks, dogfood traps documented. 7 tests. Full suite 19 = 19 on main. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #319. Arahan Wolfvin: help yang membuat agent baru langsung paham.
Yang dibangun
codelens --guide(flag, count tetap 12) → guide task-oriented:--guide --format json→ machine-parseable untuk agent. Sub-check di-derive live dari_CHECKS(tak drift).Jebakan dogfood tertanam
Yang kutemukan saat memakai CodeLens sendiri, kini di guide supaya agent lain tak terjebak:
searchpositional = pattern (bukan workspace);tracebutuh--domain backend; CLI error muncul di stdout (#315) jadi empty benar-benar empty.Guard anti-bohong
Test mem-parse tiap task command → assert umbrella-nya command nyata +
--check-nya ada di_CHECKSumbrella itu. Guide tak pernah bisa diam-diam kasih agent invocation salah.Verifikasi (dijalankan)
🤖 Generated with Claude Code