AgentSkillsCN

init-project-jpkb

以标准化的文档和文件夹结构初始化新的 JPKB 项目。采用专为 JPKB 设计的版本,内置分类文件夹并固定基础路径。当用户在 jpkb 仓库中创建新项目时,或当用户输入“初始化项目”“新建项目”,又或是目标文件夹为 JPKB 项目文件夹时,均可使用此流程。

SKILL.md
--- frontmatter
name: init-project-jpkb
description: 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.

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:

RequiredQuestionDefault
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:

code
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 ExistsAction
README.mdSkip — preserve existing
CHANGELOG.mdSkip — preserve existing
LICENSESkip — preserve existing
.gitignoreMerge — 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

code
<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

TypeAdditional StructureUse When
generalBase structure onlyDefault, documentation
code-python+ src/, tests/, pyproject.tomlPython projects
code-node+ src/, package.jsonNode.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

FileSource
README.mdassets/README.template.md
CHANGELOG.mdassets/CHANGELOG.template.md
LICENSE (MIT)assets/LICENSE-MIT.txt
LICENSE (Apache)assets/LICENSE-Apache2.txt
.gitignoreassets/gitignore-general.txt
CONTEXT.mdassets/CONTEXT.template.md
TODO.mdassets/TODO.template.md
DECISIONS.mdassets/DECISIONS.template.md

Integration with wrap-session

This skill creates the structure that /wrap-session writes to:

Init CreatesWrap-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