资讯动态

agents-generator - template-filling-guide

发布时间:2026/10/23 2:40:18 来源:尧图企业网站定制
模板填写指南在填写assets/*.md中的模板占位符时请遵循这些具体性规则。输出必须像references/example-output/README.md中的示例一样具体。快速决策表完整的检测逻辑在decision-matrix.md中。这是用于选择模板的快速参考表SignalDecisionworkspacesin package.jsonMonorepo → generate package dependency rules, shared package rebuild commandsturbo.json,nx.json,lerna.jsonMonorepo tool → adapt commands (turbo run,nx,lerna run)nextin deps app/vspages/Next.js Router type → App Router (server components default) vs Pages Router (getServerSideProps)nestjs/coreNestJS backend → module architecture, guards, DTOstrpc/*tRPC → completely different backend rules than RESTreact-hook-form,formikForm library → generateforms.mdnext-intl,react-i18nexti18n → generatei18n.mdprisma,drizzle-ormORM → generatedatabase.mdstyled-components,.module.cssNon-Tailwind CSS → generatestyling.mdwith different rulesnext-auth,clerk/nextjs,luciaAuth → route protection rulestanstack/react-query,swrServer state → different state rules than Zustand/Reduxvitest,jest,playwrightTest runner(s) → generatetesting.mdwith correct commandsNo TypeScriptJS project → skiptsc, different type safety rules占位符填充规则{{STACK_TABLE}}每一行必须包含来自package.json的确切版本号。切勿写“latest”或“X.Y.Z”。格式| Capa | Tecnología | Versión |。包括框架、UI、运行时、ORM、验证、测试、代码规范检查、分析、字体。{{ARCHITECTURE_DIAGRAM}}使用项目中的实际目录名称来制作 ASCII 艺术。显示真实的连接——哪个文件导入了哪个文件。不要使用标有“Component”或“Service”的框。对于单体仓库显示包依赖箭头。对于单个应用显示 app/ → components/ lib/ → 外部服务。{{DATA_FLOW}}带编号的步骤使用真实函数名detectPlatform()而不是 “validate input”ttdl(url)而不是 “call API”。显示完整链条用户操作 → 前端 → 后端/服务器操作 → 外部库/数据库 → 响应 → UI 更新。步骤之间使用 ASCII 箭头。{{ROUTING_TABLE}}在app/或pages/中找到的每个路由文件。包括路由路径、类型服务器/客户端/API、文件路径以及项目 UI 语言中的一行用途说明。检查内容page.tsx、layout.tsx、route.ts、error.tsx、loading.tsx、not-found.tsx、sitemap.ts、robots.ts、API 路由、动态路由。{{ESSENTIAL_COMMANDS}}仅限那些script key 存在于package.json中的命令。使用{pm} run key或{pm} key格式匹配包管理器。如果某个脚本缺失则省略该行 —— 不要编造命令。核心行dev、build、lint、test、test:run、test:coverage以及如果存在则包括质量工具doctor/lint-staged。{{TEST_COUNT}}统计所有测试文件中实际的test()/it()调用次数。报告实际数字例如N tests。如果无法准确统计则报告测试文件数量N test files。还请报告测试运行器版本、环境node/jsdom、覆盖率提供者和目标、严格TDD模式是/否。{{COMMIT_EXAMPLES}}使用来自项目最近 git 历史的真实文件名或功能名的 2-3 个示例。如果可用请阅读git log --oneline -5以获取真实示例。格式类型: 消息每行一个。{{VERIFICATION_CYCLE}}从已验证的命令组装{typecheck} → {lint} → {test} → {doctor}。仅包含工具存在的步骤。使用 package.json 中的确切命令格式。{{GLOBAL_CONVENTIONS}}列出5-8个项目特定的约定。每一个都必须可以通过配置文件验证而不是通用建议。例如✅ “始终使用 Bun。不要使用 npm 或 yarn。”从 bun.lock 检测到✅ “没有外部验证库 — TypeScript 类型手动守卫。”依赖中没有 Zod❌ “使用 TypeScript 的良好实践。”通用的不可验证的❌ “干净且有文档的代码。”通用不可验证

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑