关于 workflow-template-seeder
根据简短规格生成可运行且有文档的项目模板的工作流技能。它指导创建干净的基础项目、完善文档与配置示例,并验证安装、启动和构建。
主要功能
- 01根据规格生成模板
- 02创建简洁 Next.js 基础项目
- 03选择必要集成
- 04准备 README 与元数据
- 05生成不含密钥的环境示例
- 06检查安装、启动与构建
适用场景
- 01创建可复用的项目起始模板
- 02准备可分享的模板
- 03记录所需环境变量键名
- 04交付前检查模板
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ heyvhuang/ ship-faster --skill workflow-template-seeder安装后在 Claude Code 中输入/workflow-template-seeder确认已加载。
详细介绍
工作流:模板播种器(技能 → 模板)
目标:将简短的模板规格转化为 templates/ 下可运行且有文档说明的模板。
此工作流以技能优先:
- 将技能作为主要执行引擎
- 将模板视为“冻结的输出”(示例 + 回归参考),而非主线产品
输入(仅传入路径)
repo_root:Ship Faster 仓库根目录(templates/所在位置)run_dir:runs/template-seeder/active/<run_id>/template_spec.md:一页规格说明(说明模板用途、目标用户、核心页面和所需集成)
输出(持久化保存)
03-plans/template-plan.md05-final/template-summary.md- 一个新模板目录:
templates/<NNN>-<slug>/,包含:README.md(5 分钟内可运行).env.local.example(仅包含键名)metadata.json
工作流
0) 初始化
- 创建
run_dir。 - 确定:
- 根据规格确定
<slug>(kebab-case) <NNN>为templates/下下一个可用编号(001、002,……)
- 根据规格确定
- 为此工作流编写
01-input/context.json:entry_type: idearepo_root: <path-to-new-template-dir>need_deploy: false(模板不应自动部署)- 仅启用规格要求的集成(DB/计费/SEO)
1) 生成模板基线(优先选择简洁精简的方案)
首选路径:
- 在新模板目录中创建干净的 Next.js 基线,然后针对它运行相同的“Ship Faster 链路”。
建议的执行顺序:
workflow-project-intake(如果规格已完整,可选)- 将模板目录作为
repo_root,运行workflow-ship-faster - 如果跳过了某些步骤(例如,不需要 DB/计费),请在
00-index.md/05-final/template-summary.md中记录原因
2) 加固模板(生成可分享的输出)
必须完成:
- 删除机密信息;
.env.local.example中仅保留环境变量键名 - 确保
README.md包含:- Node 版本
- 安装和开发命令
- 必需的环境变量键
- 可选集成说明
- 确保
metadata.json准确且通用(除非有意为之,否则不包含私有品牌信息)
3) 验证
至少完成以下检查,并在 05-final/template-summary.md 中记录结果:
- 安装成功
dev可启动build成功(如果模板需要外部凭据,请记录所需的最少键名)
约束
- 不要创建包罗万象的模板。
- 避免大规模重构;优先选择易于改造的简洁基线。
- 切勿提交机密信息。
评论
支持 Markdown