@simplysm/sd-claude 13.0.85 → 13.0.86
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/README.md +160 -30
- package/claude/rules/sd-claude-rules.md +14 -11
- package/claude/rules/sd-library-issue.md +9 -4
- package/claude/rules/sd-readme.md +5 -0
- package/claude/skills/sd-audit/SKILL.md +133 -0
- package/claude/skills/sd-check/SKILL.md +111 -49
- package/claude/skills/sd-commit/SKILL.md +121 -32
- package/claude/skills/sd-debug/SKILL.md +96 -82
- package/claude/skills/sd-document/SKILL.md +64 -58
- package/claude/skills/sd-document/_common.py +1 -6
- package/claude/skills/sd-document/extract_docx.py +0 -1
- package/claude/skills/sd-document/extract_pdf.py +17 -25
- package/claude/skills/sd-document/extract_pptx.py +0 -1
- package/claude/skills/sd-document/extract_xlsx.py +2 -4
- package/claude/skills/sd-email-analyze/SKILL.md +33 -23
- package/claude/skills/sd-init/SKILL.md +99 -80
- package/claude/skills/sd-plan/SKILL.md +87 -123
- package/claude/skills/sd-plan-dev/SKILL.md +122 -0
- package/claude/skills/sd-readme/SKILL.md +147 -100
- package/claude/skills/sd-spec/SKILL.md +140 -0
- package/claude/skills/sd-spec/sections/api.md +85 -0
- package/claude/skills/sd-spec/sections/architecture.md +104 -0
- package/claude/skills/sd-spec/sections/db.md +99 -0
- package/claude/skills/sd-spec/sections/process.md +98 -0
- package/claude/skills/sd-spec/sections/ui.md +146 -0
- package/claude/skills/sd-test/SKILL.md +116 -0
- package/claude/skills/sd-use/SKILL.md +149 -0
- package/package.json +1 -1
- package/claude/rules/sd-simplysm-usage.md +0 -7
- package/claude/skills/sd-api-review/SKILL.md +0 -85
- package/claude/skills/sd-document/__pycache__/_common.cpython-313.pyc +0 -0
- package/claude/skills/sd-review/SKILL.md +0 -72
- package/claude/skills/sd-simplify/SKILL.md +0 -66
|
@@ -1,85 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: sd-api-review
|
|
3
|
-
description: Used when requesting "API review", "api-review", "sd-api-review", "API improvement", "public API review", "API intuitiveness", etc.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# SD API Review — Public API Intuitiveness Review and Improvement
|
|
7
|
-
|
|
8
|
-
Extracts the public API from the specified path (package/folder/file), compares it against relevant standards and similar libraries to derive intuitiveness improvements, then establishes an implementation plan via the `/sd-plan` process. Breaking changes are permitted, and user intuitiveness is the top priority.
|
|
9
|
-
|
|
10
|
-
ARGUMENTS: Target path (required). Example: `/sd-api-review packages/my-pkg`
|
|
11
|
-
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
## Step 1: Validate Arguments
|
|
15
|
-
|
|
16
|
-
1. Extract the **target path** from ARGUMENTS. If no path is provided, display "Please specify a target path. Example: `/sd-api-review packages/my-pkg`" and terminate.
|
|
17
|
-
|
|
18
|
-
## Step 2: Extract Public API
|
|
19
|
-
|
|
20
|
-
Collect the public API of the target.
|
|
21
|
-
- **Folder/file target**: Directly analyze exports from the given path
|
|
22
|
-
- **Depth**: Exported symbols (classes, functions, interfaces, types, constants) + public methods/properties of exported classes
|
|
23
|
-
|
|
24
|
-
If there are no exports, display "The target has no exported API." and terminate.
|
|
25
|
-
|
|
26
|
-
## Step 3: Comparative Analysis and Improvement Derivation
|
|
27
|
-
|
|
28
|
-
### 3-1. Determine Comparison Targets
|
|
29
|
-
|
|
30
|
-
- Analyze package metadata and code contents to infer the domain, then automatically select multiple widely-used libraries in that domain.
|
|
31
|
-
- Automatically include relevant standards (HTML, WAI-ARIA, Web API, TC39, JavaScript, CSS, etc.) based on the domain.
|
|
32
|
-
|
|
33
|
-
### 3-2. External API Research
|
|
34
|
-
|
|
35
|
-
Use WebSearch and WebFetch to research the following two axes with **equal weight**.
|
|
36
|
-
Compare at the **category/pattern level** (do not search for each individual symbol).
|
|
37
|
-
|
|
38
|
-
1. **Standards**: Research naming, attributes, and patterns from official specifications of domain-related standards.
|
|
39
|
-
2. **Libraries**: Research APIs from official documentation of the selected libraries.
|
|
40
|
-
|
|
41
|
-
### 3-3. Derive Improvements
|
|
42
|
-
|
|
43
|
-
Compare the API catalog from Step 2 against external APIs to derive improvements. Review from the perspectives of naming, structure, consistency, patterns, usability, and type quality.
|
|
44
|
-
|
|
45
|
-
Precautions:
|
|
46
|
-
- Breaking changes are not a concern. They are fully permitted.
|
|
47
|
-
- When input/output/purpose differs or behavior differs, proposals may be incorrect — this must always be recognized. (A common mistake)
|
|
48
|
-
|
|
49
|
-
Each improvement must include the following:
|
|
50
|
-
- **Current**: Current API state (code example)
|
|
51
|
-
- **Proposed**: Improved API (code example)
|
|
52
|
-
- **Reasons to change**: Rationale for the change (including standard/library comparisons)
|
|
53
|
-
- **Reasons not to change**: Rationale for maintaining the current state
|
|
54
|
-
|
|
55
|
-
## Step 4: Establish Implementation Plan via sd-plan
|
|
56
|
-
|
|
57
|
-
Using the improvements derived in Step 3 as the task description, invoke `sd-plan` via the Skill tool. Pass the following in args:
|
|
58
|
-
|
|
59
|
-
```
|
|
60
|
-
The following are API improvements **proposed by LLM analysis**.
|
|
61
|
-
Since the improvements are not explicitly requested modifications by the user, treat them as unclear.
|
|
62
|
-
|
|
63
|
-
## Target
|
|
64
|
-
<target path>
|
|
65
|
-
|
|
66
|
-
## LLM-Proposed Improvements — Comparative Analysis Table
|
|
67
|
-
When asking the user about unclear improvements, **always present** the following content first so the user can understand the context.
|
|
68
|
-
|
|
69
|
-
```
|
|
70
|
-
Improvement:
|
|
71
|
-
- Current:
|
|
72
|
-
- Proposed:
|
|
73
|
-
- Reasons to change:
|
|
74
|
-
- Reasons not to change:
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
## Required Considerations for Implementation
|
|
78
|
-
1. Breaking changes are not a concern. They are fully permitted.
|
|
79
|
-
2. Use Grep to search for usages of the changed API across the entire monorepo and update them together.
|
|
80
|
-
3. Do not leave deprecated wrappers (clean break).
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
## Step 5: Execute the Plan
|
|
84
|
-
|
|
85
|
-
Once sd-plan is complete and a finalized plan is produced, modify the code according to that plan.
|
|
Binary file
|
|
@@ -1,72 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: sd-review
|
|
3
|
-
description: Used when requesting "bug review", "sd-review", "code review", "find bugs", etc. Analyzes code at the specified path for potential bugs, then creates a plan and applies fixes.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# SD Review — Potential Bug Detection
|
|
7
|
-
|
|
8
|
-
Reads the code at the specified path, analyzes it for potential bugs, then creates and executes a plan via the `/sd-plan` process.
|
|
9
|
-
|
|
10
|
-
ARGUMENTS: Target path (required). Specify any path within the repo.
|
|
11
|
-
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
## Step 1: Validate Arguments
|
|
15
|
-
|
|
16
|
-
1. Extract the target path from ARGUMENTS.
|
|
17
|
-
2. If no path is provided, display "Please specify a target path. Example: `/sd-review packages/my-pkg`" and stop.
|
|
18
|
-
|
|
19
|
-
## Step 2: Bug Analysis (Do Not Modify Code)
|
|
20
|
-
|
|
21
|
-
Read the code at the target path and search for potential bugs from the following 5 perspectives.
|
|
22
|
-
Do not modify the code under any circumstances. Only compile and output a list of findings.
|
|
23
|
-
|
|
24
|
-
**Analysis Perspectives:**
|
|
25
|
-
1. **Logic/Correctness** — Incorrect conditions, off-by-one errors, wrong operators, unintended branching
|
|
26
|
-
2. **Null/Undefined Safety** — Missing null checks, unused optional chaining, misuse of type assertions
|
|
27
|
-
3. **Error Handling** — Swallowed errors, missing catch blocks, improper error propagation
|
|
28
|
-
4. **Edge Cases** — Empty arrays/strings, boundary values, concurrency/race conditions, missing await
|
|
29
|
-
5. **Resource Management** — Unclosed connections, event listener leaks, memory leak patterns
|
|
30
|
-
|
|
31
|
-
Write each finding in the following format:
|
|
32
|
-
```
|
|
33
|
-
- **filepath:line**
|
|
34
|
-
- Current code: (excerpt of the relevant code)
|
|
35
|
-
- Problem description:
|
|
36
|
-
- Suggested fix:
|
|
37
|
-
- Reasons to fix: Rationale for applying the fix
|
|
38
|
-
- Reasons not to fix: Rationale for keeping the current code
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
If no findings are discovered, display "No potential bugs were found." and stop.
|
|
42
|
-
|
|
43
|
-
## Step 3: Create Plan via sd-plan
|
|
44
|
-
|
|
45
|
-
Using the list of findings from Step 2 as the task description, invoke `sd-plan` via the Skill tool. Pass the following as args:
|
|
46
|
-
|
|
47
|
-
```
|
|
48
|
-
The following are potential bug fixes **analyzed and suggested by the LLM**.
|
|
49
|
-
Since these fixes were not explicitly requested by the user, treat them as uncertain.
|
|
50
|
-
|
|
51
|
-
## Target
|
|
52
|
-
<target path>
|
|
53
|
-
|
|
54
|
-
## LLM-Suggested Fixes
|
|
55
|
-
When asking the user about uncertain fixes, **always present** the following information first so the user can understand the context.
|
|
56
|
-
|
|
57
|
-
```
|
|
58
|
-
Fix:
|
|
59
|
-
- Filepath:line:
|
|
60
|
-
- Current code: (excerpt of the relevant code)
|
|
61
|
-
- Problem description:
|
|
62
|
-
- Suggested fix:
|
|
63
|
-
- Reasons to fix:
|
|
64
|
-
- Reasons not to fix:
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
<Full list of findings from Step 2>
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
## Step 4: Execute Plan
|
|
71
|
-
|
|
72
|
-
Once sd-plan completes and produces a finalized plan, apply the code modifications according to that plan.
|
|
@@ -1,66 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: sd-simplify
|
|
3
|
-
description: Used when requesting "code simplification", "simplify", "sd-simplify", "code refinement", etc. Analyzes code at a specified path, creates a plan, and applies modifications.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# SD Simplify — Path-Specific Code Simplification
|
|
7
|
-
|
|
8
|
-
Analyzes code at a specified path using the built-in `/simplify`, then creates and executes a plan via the `/sd-plan` process.
|
|
9
|
-
|
|
10
|
-
ARGUMENTS: Target path (required). Specify any path within the repository.
|
|
11
|
-
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
## Step 1: Validate Arguments
|
|
15
|
-
|
|
16
|
-
1. Extract the target path from ARGUMENTS.
|
|
17
|
-
2. If no path is provided, display the message "Please specify a target path. Example: `/sd-simplify packages/my-pkg`" and stop.
|
|
18
|
-
|
|
19
|
-
## Step 2: simplify Analysis (Do Not Modify)
|
|
20
|
-
|
|
21
|
-
Invoke `simplify` using the Skill tool. Pass the following instructions as args:
|
|
22
|
-
|
|
23
|
-
```
|
|
24
|
-
Review the current codebase at the <target path> path. (Not recently changed code)
|
|
25
|
-
Do NOT modify any code. Only compile and output a list of items to fix.
|
|
26
|
-
Write each item in the following format:
|
|
27
|
-
- **file-path:line**
|
|
28
|
-
- Current code: (excerpt of the relevant code)
|
|
29
|
-
- Problem description:
|
|
30
|
-
- Suggested improvement:
|
|
31
|
-
- Reasons to change: Rationale for applying the improvement
|
|
32
|
-
- Reasons not to change: Rationale for keeping the current code
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
Replace the `<target path>` placeholder with the actual path extracted in Step 1.
|
|
36
|
-
|
|
37
|
-
## Step 3: Create a Plan with sd-plan
|
|
38
|
-
|
|
39
|
-
Using the list of items to fix from Step 2 as the task description, invoke `sd-plan` using the Skill tool. Pass the following as args:
|
|
40
|
-
|
|
41
|
-
```
|
|
42
|
-
The following are code improvement suggestions **proposed by an LLM analysis**.
|
|
43
|
-
Since these suggestions were not explicitly requested by the user, treat them as unclear.
|
|
44
|
-
|
|
45
|
-
## Target
|
|
46
|
-
<target path>
|
|
47
|
-
|
|
48
|
-
## LLM-Suggested Improvements
|
|
49
|
-
When asking the user about unclear suggestions, **always present** the following details first so the user can understand the context.
|
|
50
|
-
|
|
51
|
-
```
|
|
52
|
-
Suggestion:
|
|
53
|
-
- File path:line:
|
|
54
|
-
- Current code: (excerpt of the relevant code)
|
|
55
|
-
- Problem description:
|
|
56
|
-
- Suggested improvement:
|
|
57
|
-
- Reasons to change:
|
|
58
|
-
- Reasons not to change:
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
<Full list of items to fix from Step 2>
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
## Step 4: Execute the Plan
|
|
65
|
-
|
|
66
|
-
Once sd-plan completes and a finalized plan is produced, modify the code according to that plan.
|