init-project-jpkb
Initialize new JPKB projects with standardized documentation and folder structure. JPKB-specific version with category folders and fixed base path. Use when creating a new project in the jpkb repository, when the user says "init project", "new project", or when the target is the JPKB projects folder.
安装与使用
请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求,再添加到工作流。
查看来源 ↗使用指南技能说明
JPKB Project Initialization Workflow
Scaffold new projects in the JPKB repository with standardized documentation artifacts.
Execution Steps
1. Gather Requirements
Before creating any files, clarify with user:
| Required | Question | Default |
|---|---|---|
| ✓ | Project name? | None — must ask |
| ✓ | Category/parent folder? | Prompt with existing options |
| Project type? | general |
|
| License preference? | MIT | |
| Brief description? | "A new project" |
Skip questions if context provides answers. If user says "init parametric-hinge in 3d-prints", don't re-ask.
2. Confirm Target Path
Before creating files, confirm the full path:
Target: E:\Projects\JP KB\jpkb\projects\<category>\<project-name>\
Wait for user confirmation or correction.
3. Check for Existing Files
Before creating, check what already exists:
| If Exists | Action |
|---|---|
| README.md | Skip — preserve existing |
| CHANGELOG.md | Skip — preserve existing |
| LICENSE | Skip — preserve existing |
| .gitignore | Merge — append missing entries |
| _NOTES/ | Skip — preserve existing |
| AGENTS/ | Create missing parts only |
This allows safe re-runs on existing projects to add agentic structure.
4. Create Directory Structure
<project-name>/
├── README.md
├── CHANGELOG.md
├── LICENSE
├── .gitignore
├── _NOTES/
│ └── .gitkeep
└── AGENTS/
└── claude-opus-4.5/
├── CONTEXT.md
├── TODO.md
├── DECISIONS.md
└── SESSION-LOG/
5. Populate Files
Use templates from assets/ folder, substituting:
-
{{PROJECT_NAME}}— Project name -
{{DESCRIPTION}}— Project description -
{{DATE}}— Current date (YYYY-MM-DD) -
{{YEAR}}— Current year -
{{CATEGORY}}— Project category
See references/project-types.md for type-specific variations.
6. Confirm Completion
Report to user:
- Full path created
- Files generated
- Suggested next steps
Project Types
| Type | Additional Structure | Use When |
|---|---|---|
general |
Base structure only | Default, documentation |
code-python |
+ src/, tests/, pyproject.toml |
Python projects |
code-node |
+ src/, package.json |
Node.js projects |
3d-print |
+ models/, images/ |
3D printing projects |
research |
+ data/, notebooks/ |
Research/data projects |
See references/project-types.md for complete details.
Template Assets
| File | Source |
|---|---|
| README.md | assets/README.template.md |
| CHANGELOG.md | assets/CHANGELOG.template.md |
| LICENSE (MIT) | assets/LICENSE-MIT.txt |
| LICENSE (Apache) | assets/LICENSE-Apache2.txt |
| .gitignore | assets/gitignore-general.txt |
| CONTEXT.md | assets/CONTEXT.template.md |
| TODO.md | assets/TODO.template.md |
| DECISIONS.md | assets/DECISIONS.template.md |
Integration with wrap-session
This skill creates the structure that /wrap-session writes to:
| Init Creates | Wrap-Session Updates |
|---|---|
| README.md (template) | README.md (with progress) |
| CHANGELOG.md ([Unreleased]) | CHANGELOG.md (with changes) |
| CONTEXT.md (initial state) | CONTEXT.md (current state) |
| TODO.md (empty) | TODO.md (with tasks) |
| SESSION-LOG/ (empty) | SESSION-LOG/*.md |
使用示例
查看来源仓库中的使用示例与配置说明。
查看来源 ↗来源历史
- 收录时间
- 2026-01-20
- 索引更新时间
- 2026-01-28
- Branch
- main
收录与同步日期属于本站记录。源码修改历史请查看来源仓库。
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!