用途:在 JPKB 仓库中脚手架化新项目,生成标准化文档产物与目录结构,属于 JPKB 专用版本,使用分类文件夹和固定基础路径。
主要能力:
- 创建目录结构,包含 README.md、CHANGELOG.md、LICENSE、.gitignore、_NOTES/.gitkeep,以及 AGENTS/claude/ 下的 CONTEXT.md、TODO.md、DECISIONS.md 和 SESSION-LOG/。
- 按项目类型追加结构:general 仅基础结构;code-python 增加 src/、tests/、pyproject.toml;code-node 增加 src/、package.json;3d-print 增加 models/、images/;research 增加 data/、notebooks/。
- 使用 assets/ 模板填充文件,替换占位符 {{PROJECT_NAME}}、{{DESCRIPTION}}、{{DATE}}、{{YEAR}}、{{CATEGORY}}。
- 安全重跑:README.md、CHANGELOG.md、LICENSE、_NOTES/ 已存在则保留;.gitignore 合并追加缺失项;AGENTS/ 仅创建缺失部分。
使用方式:先收集需求(项目名称必问;分类/父文件夹、项目类型默认 general、许可证默认 MIT、简介默认 “A new project”);若上下文已提供答案则跳过提问,例如用户说 “init parametric-hinge in 3d-prints” 不再重复询问。随后确认目标完整路径:E:\Projects\JP KB\jpkb\projects<category><project-name>\,等待用户确认或更正。再检查已存在文件,按上述规则处理。最后报告创建路径、生成文件和建议后续步骤。
与 wrap-session 集成:本技能创建的结构由 /wrap-session 后续写入,README.md 模板会被更新为带进度,CHANGELOG.md 从 [Unreleased] 写入变更,CONTEXT.md 从初始状态更新为当前状态,TODO.md 从空变为带任务,SESSION-LOG/ 由空目录写入 *.md 记录。
限制:资料未提供运行环境、安装命令、平台支持范围、收费与价格信息;模板文件具体内容未提供;项目类型完整细节需参见 references/project-types.md。