SuperAPI AI 工具集

template-renderer

智能体与模型

查看项目

更新于 10-16 02:36

技能介绍

用途:把模板文件中的 {{TOKEN}} 占位符替换为实际值,生成规范文档、计划文档和任务文档三类产物。

主要能力:分六步执行。一,校验输入,模板路径必须在 PROJECT_ROOT 内且仅允许 .claude/templates/,拒绝 ../ 穿越;令牌须在按模板类型划分的白名单内(specification、plan、tasks 各有允许令牌集);令牌值经清洗,去除 <>、${、{{ 并 trim。二,读取模板:.claude/templates/specification-template.md、plan-template.md、tasks-template.md。三,替换所有 {{TOKEN}},未列入白名单的令牌报错,替换后若仍有未解析令牌也报错。四,仅对 specification 模板校验:抽取 YAML frontmatter,用 js-yaml 解析并以 Ajv 对照 .claude/schemas/specification-template.schema.json 校验。五,写入输出路径,需在 PROJECT_ROOT 内,必要时建父目录,UTF-8 编码。六,验证:用 grep 检查残留 {{,统计 frontmatter 的 --- 行数(应为 2),可选 ajv 命令校验。错误处理覆盖缺失令牌、非白名单令牌、路径穿越、Schema 校验失败及未使用令牌警告。

使用方式:可被其他技能以 Skill({...}) 调用,传入 templateName、outputPath、tokens;也可用 CLI:node .claude/skills/template-renderer/scripts/main.cjs --template specification-template --output ./my-spec.md --tokens '{"FEATURE_NAME":"My Feature","VERSION":"1.0.0","AUTHOR":"Claude","DATE":"2026-01-28"}',或 --tokens-file ./tokens.json。文档还建议开始前读取 .claude/context/memory/learnings.md,并将新模式、问题、决策分别写入对应记忆文件。

适用场景:需要从模板批量生成规范、计划、任务文档,且要求注入安全与 schema 合规的流程。

限制:令牌必须在白名单内;路径受 PROJECT_ROOT 与 .claude/templates/ 约束;schema 校验仅针对 specification 模板;CLI 包装器需先在 main.cjs 中实现,文档中相关命令标注为“after implementation”。具体收费、平台与性能数据暂未提供。