القائمة
Semantic code navigation and editing triggered by speq-skills.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Audit a speq project's health — spec-library structure, feature/decision-log/plan validation, mission-to-spec sync, unrecorded plans, and gitignore hygiene — then guide fixes. Use when the user asks to audit, health-check, doctor, lint, or sanity-check the specs or repo, or after cloning or inheriting a speq project.
Code review tag taxonomy and findings output format — guardrail violations, dead code, obsolete tests, bad comments, optimizations, YAGNI/over-engineering. Triggered by code-reviewer.
Headless follow-up to speq-plan-pr. Continues on a plan's feat/plan-name branch, runs speq-implement, bumps the version, runs the real test suites, records only if green, then pushes and opens/updates a PR. Arg: plan name, PR number, or branch name.
Orchestrate implementation of reviewed plans according to the spec deltas. Arg: <plan-name>.
Create specs/mission.md via interactive interview. Detects brownfield vs greenfield.
Headless, non-interactive version of speq-plan. Plans a feature without a live interview, commits the result to a feat/plan-name branch, and opens a PR. If a decision genuinely needs a human, it persists the partial plan and open questions and asks in a PR comment instead of blocking. Arg — plan name, feature intent text, PR number, or branch name.
| name | speq-code-tools |
| description | Semantic code navigation and editing triggered by speq-skills. |
Semantic code navigation and editing via Serena MCP.
| Task | Use | Not |
|---|---|---|
| List directory | list_dir | ls, find |
| Find files | find_file | find, rg --files |
| File symbols | get_symbols_overview | rg "class|function" |
| Symbol definition | find_symbol | rg "function foo" |
| Symbol references | find_referencing_symbols | rg "foo(" |
| Update function | replace_symbol_body | read/edit/write |
| Insert after | insert_after_symbol | read/edit/write |
| Insert before | insert_before_symbol | read/edit/write |
| Rename symbol | rename_symbol | rg + manual edits |
Apply the Feynman Technique — explain your understanding before proceeding. Call these tools at key moments:
| Tool | When |
|---|---|
think_about_collected_information | After exploration sequence |
think_about_task_adherence | Before writing code |
think_about_whether_you_are_done | Before reporting completion |
Explore → find_symbol, get_symbols_overview
Understand → find_referencing_symbols
Reflect → think_about_collected_information
Edit → replace_symbol_body, insert_*_symbol
Verify → find_referencing_symbols
Complete → think_about_whether_you_are_done