@anionzo/skill 1.4.0 → 1.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CONTRIBUTING.md +2 -1
- package/README.md +82 -24
- package/docs/design-brief.md +17 -13
- package/docs/knowledge-spec.md +1 -0
- package/i18n/CONTRIBUTING.vi.md +2 -1
- package/i18n/README.vi.md +82 -24
- package/i18n/design-brief.vi.md +17 -13
- package/i18n/knowledge-spec.vi.md +1 -0
- package/knowledge/global/skill-triggering-rules.md +3 -2
- package/package.json +1 -1
- package/scripts/install-opencode-skills +197 -35
- package/skills/brainstorming/SKILL.md +176 -13
- package/skills/brainstorming/meta.yaml +18 -10
- package/skills/code-review/SKILL.md +214 -19
- package/skills/code-review/meta.yaml +21 -9
- package/skills/commit/SKILL.md +187 -0
- package/skills/commit/examples.md +62 -0
- package/skills/commit/meta.yaml +29 -0
- package/skills/commit/references/output-template.md +14 -0
- package/skills/debug/SKILL.md +252 -0
- package/skills/debug/examples.md +83 -0
- package/skills/debug/meta.yaml +39 -0
- package/skills/debug/references/output-template.md +16 -0
- package/skills/docs-writer/SKILL.md +85 -10
- package/skills/docs-writer/meta.yaml +18 -13
- package/skills/extract/SKILL.md +201 -0
- package/skills/extract/examples.md +47 -0
- package/skills/extract/meta.yaml +33 -0
- package/skills/extract/references/output-template.md +24 -0
- package/skills/feature-delivery/SKILL.md +12 -5
- package/skills/feature-delivery/meta.yaml +6 -1
- package/skills/planning/SKILL.md +146 -17
- package/skills/planning/meta.yaml +19 -7
- package/skills/refactor-safe/SKILL.md +10 -7
- package/skills/research/SKILL.md +130 -0
- package/skills/research/examples.md +79 -0
- package/skills/research/meta.yaml +31 -0
- package/skills/research/references/output-template.md +23 -0
- package/skills/test-driven-development/SKILL.md +194 -0
- package/skills/test-driven-development/examples.md +77 -0
- package/skills/test-driven-development/meta.yaml +31 -0
- package/skills/test-driven-development/references/.gitkeep +0 -0
- package/skills/test-driven-development/references/output-template.md +31 -0
- package/skills/using-skills/SKILL.md +33 -17
- package/skills/using-skills/examples.md +20 -5
- package/skills/using-skills/meta.yaml +7 -4
- package/skills/verification-before-completion/SKILL.md +127 -13
- package/skills/verification-before-completion/meta.yaml +23 -14
- package/templates/SKILL.md +8 -1
- package/skills/bug-triage/SKILL.md +0 -47
- package/skills/bug-triage/examples.md +0 -68
- package/skills/bug-triage/meta.yaml +0 -25
- package/skills/bug-triage/references/output-template.md +0 -26
- package/skills/repo-onboarding/SKILL.md +0 -52
- package/skills/repo-onboarding/examples.md +0 -115
- package/skills/repo-onboarding/meta.yaml +0 -23
- package/skills/repo-onboarding/references/output-template.md +0 -24
|
@@ -1,115 +0,0 @@
|
|
|
1
|
-
# Examples
|
|
2
|
-
|
|
3
|
-
## Example 1
|
|
4
|
-
|
|
5
|
-
User request:
|
|
6
|
-
|
|
7
|
-
```text
|
|
8
|
-
Can you explain how this service is structured before we add a queue worker?
|
|
9
|
-
```
|
|
10
|
-
|
|
11
|
-
Expected result:
|
|
12
|
-
|
|
13
|
-
- read top-level docs first
|
|
14
|
-
- inspect runtime entrypoints and worker-related modules
|
|
15
|
-
- summarize current architecture and likely integration points
|
|
16
|
-
|
|
17
|
-
### Completed output — Example 1
|
|
18
|
-
|
|
19
|
-
```
|
|
20
|
-
Project purpose: Order processing microservice — receives orders via REST API, persists to PostgreSQL, publishes events to RabbitMQ.
|
|
21
|
-
|
|
22
|
-
Architecture summary: Express.js app using a layered structure (routes → controllers → services → repositories). Bull is already listed in package.json but no active queue consumer exists.
|
|
23
|
-
|
|
24
|
-
Major components:
|
|
25
|
-
- src/routes/ — REST endpoint definitions
|
|
26
|
-
- src/controllers/ — request handling and validation
|
|
27
|
-
- src/services/ — business logic (OrderService, PaymentService)
|
|
28
|
-
- src/repositories/ — Knex-based database access
|
|
29
|
-
- src/events/ — RabbitMQ publisher (no consumer yet)
|
|
30
|
-
|
|
31
|
-
Important commands:
|
|
32
|
-
- npm run dev — start with hot reload
|
|
33
|
-
- npm test — jest unit + integration tests
|
|
34
|
-
- npm run migrate — run Knex migrations
|
|
35
|
-
|
|
36
|
-
Notable conventions:
|
|
37
|
-
- All services are instantiated via a simple DI container in src/container.ts
|
|
38
|
-
- Tests use a shared test database seeded per suite
|
|
39
|
-
|
|
40
|
-
Open questions:
|
|
41
|
-
- Is Bull the intended queue driver, or should the new worker use the existing RabbitMQ publisher?
|
|
42
|
-
- Are there any existing retry/dead-letter conventions?
|
|
43
|
-
|
|
44
|
-
Recommended next reads: src/events/publisher.ts, src/container.ts, config/queue.ts (if present)
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
### Completed output — Example 2
|
|
48
|
-
|
|
49
|
-
```
|
|
50
|
-
Project purpose: Internal dashboard for managing feature flags and A/B test configurations.
|
|
51
|
-
|
|
52
|
-
First things to read:
|
|
53
|
-
1. README.md — setup instructions and architecture overview (up to date, last edited 2 weeks ago)
|
|
54
|
-
2. package.json scripts — `npm run dev`, `npm test`, `npm run build`, `npm run seed`
|
|
55
|
-
3. src/config/ — environment variable definitions and feature flag schema
|
|
56
|
-
4. prisma/schema.prisma — data model (3 main tables: Flag, Variant, Assignment)
|
|
57
|
-
|
|
58
|
-
Important commands:
|
|
59
|
-
- npm run dev — Next.js dev server on port 3000
|
|
60
|
-
- npm test — Vitest test suite (47 tests, all passing)
|
|
61
|
-
- npm run seed — seed local database with sample flags
|
|
62
|
-
- npx prisma studio — open database GUI
|
|
63
|
-
|
|
64
|
-
Directory overview:
|
|
65
|
-
- src/app/ — Next.js App Router pages and layouts
|
|
66
|
-
- src/lib/ — shared utilities (flag evaluation engine, auth helpers)
|
|
67
|
-
- src/components/ — React UI components
|
|
68
|
-
- prisma/ — database schema and migrations
|
|
69
|
-
- e2e/ — Playwright end-to-end tests
|
|
70
|
-
|
|
71
|
-
Notable conventions:
|
|
72
|
-
- Server components by default; client components marked with "use client"
|
|
73
|
-
- Flag evaluation happens server-side via src/lib/evaluate.ts
|
|
74
|
-
- Auth is handled via NextAuth with GitHub OAuth only
|
|
75
|
-
|
|
76
|
-
Recommended next step: Run `npm run dev && npm run seed` to get a local instance with sample data, then explore the flag management UI at /flags.
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
## Example 3 — Sample completed output
|
|
80
|
-
|
|
81
|
-
User request:
|
|
82
|
-
|
|
83
|
-
```text
|
|
84
|
-
Can you explain how this service is structured before we add a queue worker?
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
### Completed output
|
|
88
|
-
|
|
89
|
-
```
|
|
90
|
-
Project purpose: Order processing microservice — receives orders via REST API, persists to PostgreSQL, publishes events to RabbitMQ.
|
|
91
|
-
|
|
92
|
-
Architecture summary: Express.js app using a layered structure (routes → controllers → services → repositories). Bull is already listed in package.json but no active queue consumer exists.
|
|
93
|
-
|
|
94
|
-
Major components:
|
|
95
|
-
- src/routes/ — REST endpoint definitions
|
|
96
|
-
- src/controllers/ — request handling and validation
|
|
97
|
-
- src/services/ — business logic (OrderService, PaymentService)
|
|
98
|
-
- src/repositories/ — Knex-based database access
|
|
99
|
-
- src/events/ — RabbitMQ publisher (no consumer yet)
|
|
100
|
-
|
|
101
|
-
Important commands:
|
|
102
|
-
- npm run dev — start with hot reload
|
|
103
|
-
- npm test — jest unit + integration tests
|
|
104
|
-
- npm run migrate — run Knex migrations
|
|
105
|
-
|
|
106
|
-
Notable conventions:
|
|
107
|
-
- All services are instantiated via a simple DI container in src/container.ts
|
|
108
|
-
- Tests use a shared test database seeded per suite
|
|
109
|
-
|
|
110
|
-
Open questions:
|
|
111
|
-
- Is Bull the intended queue driver, or should the new worker use the existing RabbitMQ publisher?
|
|
112
|
-
- Are there any existing retry/dead-letter conventions?
|
|
113
|
-
|
|
114
|
-
Recommended next reads: src/events/publisher.ts, src/container.ts, config/queue.ts (if present)
|
|
115
|
-
```
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
name: repo-onboarding
|
|
2
|
-
version: 0.1.0
|
|
3
|
-
category: discovery
|
|
4
|
-
summary: Build a practical map of an unfamiliar repository before making claims or edits.
|
|
5
|
-
summary_vi: Xây dựng bản đồ thực tế của repo lạ trước khi đưa ra nhận định hoặc sửa code.
|
|
6
|
-
triggers:
|
|
7
|
-
- explain this repo
|
|
8
|
-
- onboard into a codebase
|
|
9
|
-
- understand architecture before changing code
|
|
10
|
-
inputs:
|
|
11
|
-
- repository files
|
|
12
|
-
- README and operating docs when present
|
|
13
|
-
outputs:
|
|
14
|
-
- architecture summary
|
|
15
|
-
- important commands
|
|
16
|
-
- open questions and next reads
|
|
17
|
-
constraints:
|
|
18
|
-
- prefer source-grounded observations
|
|
19
|
-
- do not infer architecture from names alone
|
|
20
|
-
related_skills:
|
|
21
|
-
- using-skills
|
|
22
|
-
- planning
|
|
23
|
-
- docs-writer
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
## Project Purpose
|
|
2
|
-
|
|
3
|
-
- What the project is for
|
|
4
|
-
|
|
5
|
-
## Architecture Summary
|
|
6
|
-
|
|
7
|
-
- Runtime or framework:
|
|
8
|
-
- Major subsystems:
|
|
9
|
-
- External integrations:
|
|
10
|
-
|
|
11
|
-
## Important Commands
|
|
12
|
-
|
|
13
|
-
- install:
|
|
14
|
-
- test:
|
|
15
|
-
- build:
|
|
16
|
-
- run:
|
|
17
|
-
|
|
18
|
-
## Open Questions
|
|
19
|
-
|
|
20
|
-
- Unknowns that still need deeper inspection
|
|
21
|
-
|
|
22
|
-
## Recommended Next Reads
|
|
23
|
-
|
|
24
|
-
- Files or directories to inspect next
|