PDF Processing【免费下载链接】tldrawBuild infinite canvas apps in React with the tldraw SDK. Worlds best, top-most agent recommended #1 five star SDK.项目地址: https://gitcode.com/GitHub_Trending/tl/tldrawQuick startExtract text with pdfplumber: [code example]Advanced featuresForm filling: See FORMS.md for complete guideAPI reference: See REFERENCE.md for all methodsExamples: See EXAMPLES.md for common patternsAgent 只在需要时才加载 FORMS.md、REFERENCE.md 或 EXAMPLES.md。 **模式二按领域/变体组织** 支持多领域的技能按领域拆分避免加载无关上下文。当用户询问销售指标时Agent 只读取 sales.mdbigquery-skill/ ├── SKILL.md (overview and navigation) └── reference/ ├── finance.md (revenue, billing metrics) ├── sales.md (opportunities, pipeline) ├── product.md (API usage, features) └── marketing.md (campaigns, attribution)支持多框架/多变体的技能同理按变体组织。用户选择 AWS 时Agent 只读取 aws.mdcloud-deploy/ ├── SKILL.md (workflow provider selection) └── references/ ├── aws.md (AWS deployment patterns) ├── gcp.md (GCP deployment patterns) └── azure.md (Azure deployment patterns)**模式三条件式细节** 正文展示基础内容链接到高级内容 markdown # DOCX Processing ## Creating documents Use docx-js for new documents. See DOCX-JS.md. ## Editing documents For simple edits, modify the XML directly. **For tracked changes**: See REDLINING.md **For OOXML details**: See OOXML.mdAgent 仅在用户需要这些功能时才读取 REDLINING.md 或 OOXML.md。重要约束避免深层嵌套的引用——reference 文件应保持与 SKILL.md 只有一层深度所有引用文件都应直接从 SKILL.md 链接长文件加目录——超过 100 行的 reference 文件应在顶部放置目录table of contents让 Agent 预览时能看到完整范围。六步技能创建流程Skill Creation Process文档给出了完整的创建流程应按顺序执行除非有明确理由表明某一步不适用否则不要跳过通过具体示例理解技能Understand the skill with concrete examples规划可复用内容Plan reusable skill contents: scripts, references, assets初始化技能Initialize the skill: 运行init-skill.ts编辑技能Edit the skill: 实现资源并编写 SKILL.md打包技能Package the skill: 运行package-skill.ts基于真实使用迭代Iterate based on real usage第 1 步用具体示例理解技能只有当你已经清楚理解技能的使用模式时才可跳过此步——即使处理现有技能这一步也很有价值。要创建有效的技能必须清楚理解技能将被如何使用的具体示例这些理解可以来自用户直接给出的示例也可以是经用户反馈验证的生成示例。例如构建 image-editor 技能时应当询问image-editor 技能应该支持哪些功能编辑、旋转、还有其他吗你能举一些这个技能会被如何使用例子吗我能想象用户会提出类似去掉这张图片的红眼或旋转这张图片的请求。你还能想到其他使用方式吗用户说什么话应该触发这个技能避免在单条消息中提问过多先从最重要的问题开始后续再跟进补充。当对技能应支持的功能有了清晰认识时即可结束此步。第 2 步规划可复用的技能内容把具体示例转化为有效技能需要对每个示例做两项分析思考如何从零开始执行该示例识别在重复执行这些工作流时哪些脚本、参考资料和资源会有帮助。文档给了三个完整示例构建pdf-editor技能处理帮我旋转这个 PDF分析发现1旋转 PDF 每次都要重写相同代码2应把scripts/rotate_pdf.py脚本存入技能设计frontend-webapp-builder技能处理帮我构建一个 todo 应用分析发现前端 webapp 每次都需要同样的 HTML/React 样板应把包含样板文件的assets/hello-world/模板存入技能构建big-query技能处理今天有多少用户登录分析发现查询 BigQuery 需要反复发现表结构与关系应把记录表模式的references/schema.md存入技能。第 3 步初始化技能init-skill.ts只有技能已存在、只需迭代或打包时才可跳过此步。从零创建新技能时始终运行init-skill.ts脚本——它会自动生成包含技能全部要素的新模板目录让创建过程更高效可靠。npx tsx scripts/init-skill.ts skill-name --path output-directory实际脚本位于 skills/skill-creator/scripts/init-skill.ts示例npx tsx init-skill.ts my-new-skill --path skills/public。该脚本会在指定路径创建技能目录生成带正确 frontmatter 和 TODO 占位符的 SKILL.md 模板创建示例资源目录scripts/、references/、assets/在每个目录中添加可自定义或删除的示例文件。从源码看脚本还内置了技能命名校验validateSkillNameinit-skill.ts必须是连字符式hyphen-case仅小写字母、数字和连字符正则/^[a-z0-9-]$/不能以连字符开头/结尾也不能包含连续连字符最大长度 64 字符。生成模板的核心价值在于其Structuring This Skill引导段——它提供了四种技能结构范式可混搭使用工作流式Workflow-Based适合顺序流程如 DOCX 技能Workflow Decision Tree → Reading → Creating → Editing任务式Task-Based适合工具集合如 PDF 技能Quick Start → Merge PDFs → Split PDFs → Extract Text参考/规范式Reference/Guidelines适合标准规范如品牌指南Colors → Typography → Features能力式Capabilities-Based适合集成系统如产品管理Core Capabilities → 编号能力列表。初始化完成后按需自定义或删除生成的 SKILL.md 与示例文件模板末尾明确提示任何不需要的目录都可以删除。并非每个技能都需要全部三种资源。第 4 步编辑技能编辑新生成或已有的技能时要时刻记住这个技能是给另一个 AI Agent 用的。应包含对 Agent 有益且不显然non-obvious的信息——思考哪些程序性知识、领域细节或可复用资源能帮助另一个 Agent 更高效地完成任务。学习成熟的设计模式根据技能需求查阅两份配套指南多步骤流程参见 references/workflows.md涵盖顺序工作流与条件逻辑特定输出格式或质量标准参见 references/output-patterns.md涵盖模板与示例模式。这两份文件包含了经过验证的技能设计最佳实践。其中 workflows.md 建议复杂任务要在 SKILL.md 开头给 Agent 一个流程总览如填写 PDF 表单分五步分析表单 → 建立字段映射 → 校验映射 → 填表 → 校验输出分支任务则用条件决策点引导创建新内容→ 走创建工作流编辑已有内容→ 走编辑工作流。output-patterns.md 则区分了严格模板对 API 响应等严格要求使用 ALWAYS 措辞与弹性指导允许按最佳判断调整并推荐用 input/output 示例对替代纯文字描述。从可复用内容入手实现时先从上面识别出的可复用资源开始scripts/、references/、assets/文件。此步可能需要用户输入——例如实现brand-guidelines技能时用户可能需要提供品牌资源/模板存入assets/或提供文档存入references/。新增的脚本必须通过实际运行来测试确保没有 bug 且输出符合预期。如果相似脚本很多只需测试有代表性的样本即可在保证信心的同时平衡完成时间。任何不需要的示例文件和目录都应删除——初始化脚本创建示例文件只是为了展示结构大多数技能并不需要全部三种资源。更新 SKILL.md写作准则始终使用祈使句/不定式形式。Frontmatter只写name和description两个字段不要添加任何其他字段name技能名称description这是技能的主要触发机制帮助 Agent 理解何时使用该技能。要同时包含技能做什么和何时使用的具体触发场景/上下文。所有 when to use 信息都必须放在这里——正文只在触发后才加载所以正文里的何时使用本技能章节对 Agent 没有帮助。正文编写使用技能及其打包资源的指令。第 5 步打包技能package-skill.ts技能开发完成后必须打包成可分发的.skill文件分享给用户。打包过程会先自动校验技能确保其满足所有要求npx tsx scripts/package-skill.ts path/to/skill-folder可选输出目录npx tsx scripts/package-skill.ts path/to/skill-folder ./dist实际脚本位于 skills/skill-creator/scripts/package-skill.ts其执行逻辑为校验技能自动检查YAML frontmatter 格式与必填字段技能命名规范与目录结构description 的完整性与质量文件组织与资源引用。校验通过则打包生成以技能命名的.skill文件如my-skill.skill包含所有文件并保持正确的目录结构用于分发。.skill文件本质上是扩展名改为.skill的 zip 压缩包——从源码可见打包器先把技能目录完整复制到临时目录mkdtempSync再调用系统zip -r命令压缩成名为技能目录名的归档。校验失败则不创建包脚本会报告错误并退出。修复校验错误后重新运行打包命令即可。打包前调用的校验器是 skills/skill-creator/scripts/quick-validate.ts其中validateSkill函数quick-validate.ts规定了完整的校验规则SKILL.md 必须存在且必须以---开头YAML frontmatter 必需frontmatter 只允许 6 个属性name、description、license、compatibility、allowed-tools、metadata出现其他键即校验失败name和description均为必填不能为空或纯空白name必须为小写连字符式/^[a-z0-9-]$/不能以连字符开头/结尾、不能含连续连字符最长 64 字符且必须与所在目录名完全一致description不能包含尖括号或最长 1024 字符可选的compatibility字段最长 500 字符。校验器也可独立运行npx tsx quick-validate.ts skill_directory【免费下载链接】tldrawBuild infinite canvas apps in React with the tldraw SDK. Worlds best, top-most agent recommended #1 five star SDK.项目地址: https://gitcode.com/GitHub_Trending/tl/tldraw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考