brilliantrough/agent-skills

steady-do

Develop features in an existing project within the current session with ponytail taste.

Ver código fuente
Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

Steady Do: understand → clarify → implement here → verify

Choose the workflow

  • An explicit user choice takes precedence. Do not silently switch workflows; if the chosen one cannot safely fit the task, explain the mismatch and ask about the necessary adjustment.
  • Without an explicit choice: use quick-do for clear, bounded changes; steady-do for ordinary feature work or unresolved design decisions; plan-brief for long-horizon work needing a durable plan and separate-session execution.
  • Judge by uncertainty, coupling, risk, and handoff needs, not prompt length or file count. If unsure between quick and steady, use steady. If a handoff would help but was not requested, propose it before changing who executes; complexity alone does not authorize a handoff.
  • These workflows govern requested development work, not every explanation or read-only question. Skill instructions are in English; replies and deliverables follow the user's language (Chinese by default).

1. Understand the request and project

  • Read the complete requirement and decisions already settled in this conversation. Separate explicit requirements from open questions; investigate before modifying files.
  • Read project rules, README, relevant entry points and modules. Trace the real flow, reuse opportunities, affected callers, and compatibility boundaries. Expand by relevance, not a whole-repo tour or a single-function guess.
  • Establish the runtime, dependency versions, launch commands, input/output formats, and config locations needed for this work. Inspect facts rather than assuming an interpreter or system Python.
  • Briefly state the goal, scope, non-goals, and observable completion criteria in chat. Do not create a plan document.

2. Grill the unresolved decisions

Use the bounded, round-based grilling method below; it is self-contained and does not require a separate skill or document workflow.

  • Find facts yourself; ask the user for decisions. Consult code, config, project memory, and docs first. For uncertain external APIs or platform limits, check upstream docs, source, or issues instead of presenting guesses as constraints.
  • Ask only questions that affect behavior, scope, compatibility, risk, or acceptance. Give a recommendation and a brief trade-off for each. Resolve ordinary implementation details using project conventions.
  • Group independently answerable questions in one round; defer questions that depend on unanswered ones. Use structured questions when available, otherwise numbered questions in chat, then wait for answers.
  • Do not repeat settled questions or invent a question quota. If the request and context already resolve the decisions, proceed to the recap.
  • Establish what will run, what observable result counts, and who verifies what. Reuse an agreed verification approach instead of asking again.
  • Stop when implementation-critical and acceptance-critical ambiguity is resolved and understanding is shared. Do not grill speculative future requirements or ask the user to design each function.

3. Recap and implement here

  • Briefly recap the agreed scope, approach, and verification, then begin without an extra plan-approval gate. If the recap introduces an unresolved material choice, wait for its answer first.
  • Keep primary implementation in this session; do not hand it to a fresh session or execution sub-agent. Optional read-only research or review may be delegated when useful, not as a default multi-agent pipeline.
  • No plan documents, launcher prompts, development reports, or review reports. Track multi-step work with a session todo; required product docs and project memory still apply.
  • If new evidence invalidates the agreed approach or requires broader scope or changed external behavior, pause the affected work and realign. Resolve ordinary local implementation issues yourself.
  • Before destructive or irreversible actions, show the impact and obtain explicit authorization. Permission to start does not permit overwriting secrets or changing unrelated environments.

4. Keep ponytail taste

  • Keep the smallest working change: reuse existing code, then stdlib/native features, then installed dependencies. Do not add dependencies for simple problems.
  • No over-encapsulation, speculative abstractions, defensive boilerplate, redundant checks, future scaffolding, or unrelated cleanup.
  • Fix root causes along the real call chain, not just the reported symptom; inspect sibling callers of shared logic.
  • Preserve necessary trust-boundary validation, security, accessibility, data protection, and error handling that prevents data loss.

5. Verify and finish

  • Default to the smallest real execution path plus a reread of the change and affected adjacent behavior. Check the agreed observable outcome, not merely the absence of errors. For documentation-only changes, inspect content and applicable format checks.
  • Do not add tests, TDD, or verification scripts by default. Follow explicit user requests and mandatory project checks; feature work does not automatically imply TDD.
  • Distinguish static checks, successful loading, local calls, and complete user interaction. A loadable plugin is not a working feature; injected input is not a physical terminal interaction.
  • If execution needs the user's environment or is blocked, state what remains unverified and give concrete steps and expected observations. Never invent completion or silently omit blocked work.
  • Briefly report what changed, what actually ran, and what needs user confirmation. One line when sufficient; no separate report or summary essay.
del mismo repositorio

Más Skills

Todos los Skills
brilliantrough
Comunidad

code-review

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes: Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/spec asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to \"review since X\".

instalaciones
1
GitHub Stars
3
Actualizado
20 sept
brilliantrough
Comunidad

domain-modeling

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md, or recording or editing an ADR.

instalaciones
1
GitHub Stars
3
Actualizado
20 sept
brilliantrough
Comunidad

exp-probe

Run one-off research spot experiments with minimal ceremony. Use when explicitly requested, or for a missing datapoint, a rerun after failure (OOM, crash), a sanity check of one configuration, a minimal bug reproduction, or a cheap measurement that a campaign needs before deciding. At most one focused question; run, record, report in one line. Escalate to exp-batch if the spot check turns into a branch, or exp-campaign if it reveals a decision tree; if the question itself is still fuzzy, route back to exp-discuss.

instalaciones
1
GitHub Stars
3
Actualizado
20 sept
brilliantrough
Comunidad

grill-with-docs

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

instalaciones
1
GitHub Stars
3
Actualizado
20 sept