Przejdź do treści
Biblioteka skilli
Produktywność osobista · Integracja z narzędziem

akidevsync-notes

/akidevsync-notes

Czyta i edytuje plik .akidevsync/notes.json z zadaniami i notatkami projektu z aplikacji Aki-Dev-Sync: lista, dodawanie, przypinanie, kończenie, edycja i usuwanie oraz porównanie z wydaniem.

Repozytorium
akidevrule ↗
Licencja
MIT
Ostatnia zmiana repozytorium
20.10.2026

Ocena i bezpieczeństwo

100/ 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ść35 / 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
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

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

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/notes_cli.py

Co robi i kiedy

Czyta i edytuje plik .akidevsync/notes.json z zadaniami i notatkami projektu z aplikacji Aki-Dev-Sync: lista, dodawanie, przypinanie, kończenie, edycja i usuwanie oraz porównanie z wydaniem.

Oryginalny opis (EN)

Read and edit a project's `.akidevsync/notes.json` task/note file — the per-project task list written by the Aki-Dev-Sync app (github.com/lacvietanh/aki-dev-sync). Use whenever the task reads or changes that project task list — listing, adding, pinning, completing, editing or deleting a task or note, in any wording. Also use when asked to cross-check pinned/open notes against what a release actually shipped (CHANGELOG, code) before marking them done.

Jak działa

  1. Locating the file
  2. Commands
  3. Cross-checking pinned notes against a shipped release
  4. What this skill does not do
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 585 słów
Podgląd SKILL.md
---
name: akidevsync-notes
description: Read and edit a project's `.akidevsync/notes.json` task/note file — the per-project task list written by the Aki-Dev-Sync app (github.com/lacvietanh/aki-dev-sync). Use whenever the task reads or changes that project task list — listing, adding, pinning, completing, editing or deleting a task or note, in any wording. Also use when asked to cross-check pinned/open notes against what a release actually shipped (CHANGELOG, code) before marking them done.
---

# akidevsync-notes — edit a project's Aki-Dev-Sync task file safely

The Aki-Dev-Sync app stores every project's task list at `<project>/.akidevsync/notes.json` (schema: `about`, `schema`, `notes`, `tasks[]`, `updated_at`; each task has `id`, `title`, `detail`, `done`, `pin`, `wish`, `created_at`, `updated_at` in epoch-ms). The file is normally gitignored (`.akidevsync/` — the app excludes it from PUSH/PULL by default too), so edits here are local-only and never show up in `git diff`.

**Never hand-edit the JSON with the Edit tool.** The app itself reads/writes this file, so any mutation must match its exact formatting (2-space indent, `ensure_ascii=False` so Vietnamese text stays literal, alphabetical per-task key order, a trailing newline) or the next diff a human looks at gets noisy for no reason. Always go through the bundled script:

```
python3 ~/.claude/skills/akidevsync-notes/scripts/notes_cli.py <path-to-notes.json> <command> [args]
```

(On Antigravity/Codex/Kiro/Grok, substitute that CLI's skills root — see `~/.aki/akidevrule/.source-repo`'s `README.md` for the list of sync targets.)

## Locating the file

`find <project-root> -maxdepth 2 -name notes.json -path '*/.akidevsync/*'` (or just check `<cwd>/.akidevsync/notes.json`). If it does not exist, the project has never opened in Aki-Dev-Sync, or task notes were never migrated — **do not create one uninvited**. Only run `... init` when the user explicitly asks to start tracking tasks for a project that doesn't use the app.

## Commands

```
list [--pin] [--done] [--pending] [--wish] [--detail]   # --detail also prints each task's detail body
add "<title>" [--detail "<text>"] [--pin] [--wish]
set <task-id> [--done true|false] [--pin true|false] [--wish true|false] [--title "<t>"] [--detail "<t>"]
delete <task-id>                                          # permanent — confirm with the user first
note "<text>"                                              # replaces the project-wide notes field (not a task)
init                                                        # only if the user explicitly wants a new file
```

`set`/`delete` need the task's `id` (shown by `list`) — never guess it from the title, titles are not unique.

## Cross-checking pinned notes against a shipped release

A recurring use: the user pins a wish/bug note while working, ships a release, then asks "does what I fixed in vX.Y actually cover this note — mark it done." Work like this, not by pattern-matching titles alone:

1. `list --pin` (or `list --pending` for everything still open) to get the candidate set.
2. For each note, read its `detail` too — the real bug report is usually there, not in the short title, and is often the most reliable string to grep the CHANGELOG for.
3. Read the actual CHANGELOG entry (or `git log`) for the release, and where the claim is non-trivial, verify against the code itself (grep the relevant file/function) rather than trusting the changelog prose alone — changelog text can overstate what shipped.
4. If the changelog or code itself flags the fix as unverified/runtime-only/needs-owner-confirmation, **ask the user** whether they've actually confirmed it before marking done — do not mark done on an unverified claim just because the code changed.
5. Only `set <id> --done true` for notes you can point to a specific matching commit/changelog line/code diff for. Leave ambiguous or unmatched ones pinned and tell the user why, rather than silently leaving them out of the report.
6. Summarize what you marked done and why (one line per note, citing the matching change) so the user can sanity-check the batch rather than re-deriving it.

## What this skill does not do

It has no opinion on the app's UI, sync, or release process — it only edits `notes.json`. Never touch other files in `.akidevsync/`, never run git commands on this path (it's meant to stay untracked), and never bulk-delete tasks without the user naming them explicitly.
Pliki w paczce (2)
  • SKILL.md 4 KB
  • scripts/notes_cli.py 7 KB

Wersje

W bazie nie ma innych skilli o nazwie akidevsync-notes.

Migawka bazy z 13.11.2026 · wersja paczki c9d016aac632 (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

  • 90apple-notes
    Tworzy, przegląda, edytuje, przenosi i eksportuje notatki Apple Notes z terminala na macOS przez CLI memo.
  • 100apple-notes
    Obsługuje Apple Notes na macOS przez CLI memo: tworzenie, listowanie, wyszukiwanie, edycja, przenoszenie, usuwanie i eksport notatek oraz folderów.
  • 86apple-notes
    Zarządza Apple Notes na macOS przez CLI memo: tworzy, przegląda, edytuje, usuwa, wyszukuje, przenosi i eksportuje notatki oraz porządkuje foldery.
  • 100apple-notes
    Zarządza Apple Notes na macOS przez CLI memo: tworzy, wyświetla, edytuje, usuwa, wyszukuje, przenosi i eksportuje notatki.
  • 100apple-notes-core-workflow-a
    Buduje zautomatyzowane przepływy zarządzania notatkami w Apple Notes skryptami JXA: masowe tworzenie, synchronizacja ze źródeł zewnętrznych, foldery i szablony.
  • 90plib
    Zarządza notatkami i wielokrotnie używanym tekstem w bibliotece Project Library przez CLI plib: czyta, szuka, zapisuje, edytuje i synchronizuje.

Uwagi i zgłoszenia

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