Przejdź do treści
Biblioteka skilli
Programowanie · Nauka i wyjaśnianie

ds-principles

/ds-principles

Podaje zwięzłe zasady inżynierskie z wyzwalaczami, np. przy wymianie API, rozmiarze zmiany lub debugowaniu.

Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Podaje zwięzłe zasady inżynierskie z wyzwalaczami, np. przy wymianie API, rozmiarze zmiany lub debugowaniu.

Oryginalny opis (EN)

Compact engineering principles for design, debugging, verification, and delegation, each with a trigger. Use when choosing structure or types, sizing a diff, replacing an API, debugging, writing tests, or when the user types /ds-principles.

Jak działa

  1. Design
  2. Debugging and verification
  3. Process
  4. Types
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 661 słów
Podgląd SKILL.md
---
name: ds-principles
description: "Compact engineering principles for design, debugging, verification, and delegation, each with a trigger. Use when choosing structure or types, sizing a diff, replacing an API, debugging, writing tests, or when the user types /ds-principles."
metadata:
  source: "adapted from github.com/aicodeking/deepseek-stack (MIT, (c) 2026 AICodeKing)"
---

# Engineering principles

If a trigger matches, apply the rule. Name principles that changed a decision.

## Design

1. **Subtract, then add little.** Remove dead code and stale checks first, then make the shortest diff that works. No abstraction with one user. Apply when sizing a diff or tempted to add a layer.
2. **Data shape first.** Choose the core types and structures before logic. Apply before writing new logic.
3. **Model the domain.** Put states in one structure, such as a typed union, state machine, or lookup table, not scattered conditionals. Apply when code branches a lot or repeats a shape across files.
4. **Redesign for the new need.** Fit a new requirement as if it existed from day one. Apply when an addition strains the design.
5. **Low reader load.** Inline one-caller wrappers and shrink mutable scope. Check "one caller" with `graft_callers`, not by guessing. Apply when code is hard to trace.
6. **Guards at boundaries.** Validate where input enters: CLI, config, network, files, external APIs. Trust types inside and keep core logic pure. Apply when adding validation or error handling.
7. **Idempotent steps.** Rerunning a step, even after a crash, reaches the same state. Apply to commands, setup, and retries.
8. **No shared writers.** Give each concurrent actor its own file, branch, or key before using locks. Apply when parallel work touches shared state.
9. **Migrate, then delete.** Find every caller with `graft_callers` (plus `graft_grep` for string uses), move them all, and delete the old API in one change. No shims. Apply when replacing an API or rewriting in phases.
10. **Compare options.** For an unprecedented design, sketch two or three. Prefer fewer, polished features. Apply to novel architecture, UX, or scope choices.

## Debugging and verification

11. **Fix root causes.** Fix where state first went wrong. A guard fixes only legitimate states. Apply when debugging.
12. **Attack the premise.** After two failed fixes that share an assumption, write it down and test it directly (see ds-unstick). Apply before a third attempt.
13. **Prove it works.** Run the real thing and read the actual output, not a proxy. Apply before claiming done.
14. **Verifiable units.** Split work into steps that each end in a passing check. Apply to sweeps, migrations, and stacked commits.
15. **Test behavior.** Assert what callers can observe, so tests survive refactors. Apply when writing or keeping a test.
16. **Explain the number.** Find what limits a measurement and confirm it measured the right work. Apply to benchmarks and eval scores.
17. **Build the tool.** Script bulk or repeated work so it can be rerun. Apply to large edit sets or checks.

## Process

18. **Guard the context.** Keep summaries, not dumps. Use `graft_skeleton` for a file's API instead of reading the whole file, and `graft_ask` instead of wide grep sweeps. Apply when outputs or files are large.
19. **Do not block on the human.** On reversible work, proceed and show the result. Apply when tempted to ask "should I?".
20. **Encode repeated lessons.** A correction given twice becomes a lint, test, or script (see ds-lessons). Apply when a mistake recurs.
21. **Comments explain why.** Keep a comment only for a reason the code cannot show, such as an external constraint or a public API contract. Delete narration and dead code. Fix code whose surprise needs a comment. Apply when writing or reviewing code.

## Types

- Make illegal states unrepresentable. Use discriminated unions, not optional-field bags.
- Parse external data once at the boundary into a named type. Trust it inside.
- Use `unknown` for untrusted input. Never `any`. No `as` casts before validation.
- Derive types from a schema, not hand-written guards.
- Add a `never` check in default branches so new variants fail the build.
- Brand primitives that must not mix, such as user IDs and order IDs.
- In Python: dataclasses or TypedDict at boundaries, `Literal` / `Enum` for states, and run the type checker if the project has one.
Pliki w paczce (2)
  • LICENSE 1 KB
  • SKILL.md 4 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · adithyanraj03/dsh-skills-pack90MIT
aicodeking/deepseek-stack90MIT

Migawka bazy z 13.11.2026 · wersja paczki 2c6a7c0b3a61 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90principles
    Podaje zasady inżynierskie z projektowania, architektury, weryfikacji i delegowania, czytając te, które dotyczą danej pracy.
  • 90principles
    Zbiera zasady inżynierskie dotyczące wielkości zmiany, typów, debugowania, weryfikacji, pomiarów i delegowania, gdy zadanie trafia w jeden z wyzwalaczy.
  • 90principles
    Podpowiada zasady projektowania danych i typów, debugowania, sprawdzania wyników i dzielenia pracy między podagentów.
  • 85engineering-principles
    Stosuje 24 zasady inżynierskie do decyzji projektowych, implementacyjnych, testowych i pomiarowych, nazywając zasadę, która zmieniła daną decyzję.
  • 100testing-principles
    Pomaga wybrać zakres testów dla zmiany i ocenić jakość testów, także testów E2E w przeglądarce.
  • 85engineering-principles
    Stosuje podstawowe zasady inżynierii oprogramowania przy projektowaniu systemów, strukturze kodu, przeglądzie zmian i obsłudze stanu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.