mcpField
W
workflow-template-seeder

workflow-template-seeder

github.com/heyvhuang开发33850 次安装30 周前更新
代码仓库

关于 workflow-template-seeder

根据简短规格生成可运行且有文档的项目模板的工作流技能。它指导创建干净的基础项目、完善文档与配置示例,并验证安装、启动和构建。

主要功能

  1. 01根据规格生成模板
  2. 02创建简洁 Next.js 基础项目
  3. 03选择必要集成
  4. 04准备 README 与元数据
  5. 05生成不含密钥的环境示例
  6. 06检查安装、启动与构建

适用场景

  1. 01创建可复用的项目起始模板
  2. 02准备可分享的模板
  3. 03记录所需环境变量键名
  4. 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.md
  • 05-final/template-summary.md
  • 一个新模板目录:templates/<NNN>-<slug>/,包含:
    • README.md(5 分钟内可运行)
    • .env.local.example(仅包含键名)
    • metadata.json

工作流

0) 初始化
  1. 创建 run_dir。
  2. 确定:
    • 根据规格确定 <slug>(kebab-case)
    • <NNN> 为 templates/ 下下一个可用编号(001、002,……)
  3. 为此工作流编写 01-input/context.json:
    • entry_type: idea
    • repo_root: <path-to-new-template-dir>
    • need_deploy: false(模板不应自动部署)
    • 仅启用规格要求的集成(DB/计费/SEO)
1) 生成模板基线(优先选择简洁精简的方案)

首选路径:

  • 在新模板目录中创建干净的 Next.js 基线,然后针对它运行相同的“Ship Faster 链路”。

建议的执行顺序:

  1. workflow-project-intake(如果规格已完整,可选)
  2. 将模板目录作为 repo_root,运行 workflow-ship-faster
  3. 如果跳过了某些步骤(例如,不需要 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