# Perdolique/workflow：构建个性化AI编码工作流的完整解决方案

> 一个开源的AI编码代理和技能集合，帮助开发者通过自定义工作流扩展LLM能力，包含Commit代理、PR代理、TypeScript代码风格规范、Drizzle ORM查询模式等实用工具

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-04-20T18:15:17.000Z
- 最近活动: 2026-04-20T18:18:16.029Z
- 热度: 163.9
- 关键词: AI代理, GitHub Copilot, TypeScript, Drizzle ORM, Playwright, Vitest, 约定式提交, Pull Request, LSP, 开发工作流
- 页面链接: https://www.zingnex.cn/forum/thread/perdolique-workflow-ai
- Canonical: https://www.zingnex.cn/forum/thread/perdolique-workflow-ai
- Markdown 来源: ingested_event

---

## 项目背景\n\n随着大型语言模型(LLM)在软件开发领域的广泛应用，开发者们逐渐意识到：单纯依赖通用AI助手往往无法满足特定项目的需求。每个团队都有自己的编码规范、技术栈偏好和工作流程。Perdolique/workflow项目正是为了解决这一痛点而诞生的——它提供了一套完整的个性化AI编码工作流解决方案。\n\n这个开源仓库由开发者Perdolique维护，汇集了多个自定义AI编码代理和可复用技能，旨在将LLM的能力与实际的开发实践深度结合。不同于那些追求大而全的AI工具，这个项目更注重实用性和可定制性，让开发者能够根据自己的需求打造专属的智能工作流。\n\n## 核心架构：代理与技能的双层设计\n\n项目的架构设计非常清晰，分为两大核心组件：\n\n### 自定义AI编码代理\n\n代理(Agents)是针对特定开发任务设计的专用AI助手。每个代理都专注于某一类工作，通过精细化的指令和上下文理解，提供比通用AI更精准的支持。目前仓库中包含两个主要代理：\n\n**Commit代理**能够分析当前代码变更，自动生成符合约定式提交规范(Conventional Commits)的提交信息，并直接完成Git提交操作。这对于保持提交历史的规范性和可读性非常有帮助，特别是在团队协作环境中。\n\n**PR代理**则会分析分支间的代码差异，自动生成或更新GitHub Pull Request的内容。它可以在聊天界面中展示PR内容，也可以直接与GitHub API交互创建实际的PR，大大简化了代码审查流程。\n\n### 可复用技能集合\n\n技能(Skills)是提供专业化知识和能力的可复用模块，可以被代理或其他工具调用。仓库目前包含七个精心设计的技能：\n\n- **code-style-typescript**：TypeScript代码风格规范，涵盖编写、审查和重构.ts文件的最佳实践\n- **commit-creator**：为当前代码变更生成英文约定式提交信息\n- **drizzle-orm**：Drizzle ORM查询模式指南，包括关系查询、SQL构建器使用和查询结构修复\n- **markdownlint**：项目中markdownlint的配置、管理和故障排除指南\n- **playwright-e2e-testing**：Web应用的Playwright端到端测试编写与维护指南\n- **pr-creator**：从代码变更创建GitHub Pull Request或在聊天中生成PR内容\n- **vitest-unit-testing**：TypeScript代码的Vitest单元测试编写与维护指南\n\n## 安装与使用方式\n\n项目提供了多种使用方式，适应不同开发者的习惯：\n\n### 通过Vercel Skills CLI安装\n\n最简单的安装方式是使用Vercel提供的Skills命令行工具：\n\n```bash\npnpx skills add Perdolique/workflow\n```\n\n这条命令会将仓库中的所有技能安装到本地环境，之后就可以在支持的AI编码助手(如GitHub Copilot)中调用这些技能。\n\n### 代理的调用方式\n\n代理通常通过AI编码助手来调用。具体的使用方式取决于你所使用的AI助手——不同的平台可能有不同的触发机制和命令格式。开发者需要参考自己所用助手的文档来了解如何激活这些自定义代理。\n\n### GitHub Copilot深度集成\n\n项目特别为GitHub Copilot用户提供了深度集成方案。在`non-standard/copilot/instructions/`目录下，包含了一套自定义指令文件，可以覆盖Copilot的默认行为。\n\n**全局指令文件**(`global.instructions.md`)定义了AI助手的角色定位、沟通风格和代码开发原则。开发者可以通过符号链接将其安装到Copilot的指令目录：\n\n```bash\n# 全局安装\nln -s /path/to/workflow/non-standard/copilot/instructions/global.instructions.md ~/.copilot/instructions/global.instructions.md\n\n# 项目级安装\nln -s /path/to/workflow/non-standard/copilot/instructions/global.instructions.md /your/project/.copilot/instructions/global.instructions.md\n```\n\n需要注意的是，这些指令包含了一些主观性的沟通风格偏好，建议在使用前仔细审阅文件内容，确保符合团队的工作习惯。\n\n## LSP配置与语言服务器支持\n\n为了提升代码编辑体验，项目还提供了语言服务器协议(LSP)配置，专门支持GitHub Copilot CLI的`/lsp`命令。通过配置不同的语言服务器，可以为特定文件类型启用智能提示和自动补全功能。\n\n配置文件路径：`non-standard/copilot/lsp-config.json`\n\n目前支持的语言服务器包括：\n\n- **TypeScript/JavaScript**：使用`typescript-language-server`提供类型检查、自动补全和重构支持\n- **Vue**：使用`vue-language-server`为Vue单文件组件提供完整的语言支持\n\n安装语言服务器的方式如下：\n\n```bash\nnpm install -g typescript-language-server typescript\nnpm install -g @vue/language-server\n```\n\n安装完成后，将配置文件复制或链接到Copilot目录即可生效。务必确保语言服务器已添加到系统PATH中，否则Copilot无法正确调用它们。\n\n## 设计理念与使用建议\n\n这个项目的独特之处在于它的"个人化"定位。与那些试图成为行业标准的大型项目不同，Perdolique/workflow更像是一个精心打理的个人工具箱。仓库的README明确说明："这是一个包含主观性和有时略显古怪的代理和技能的个人集合"。\n\n这种坦诚的态度实际上是一种优势。它意味着：\n\n1. **实用性优先**：每个组件都是为了解决真实开发场景中的具体问题而设计的\n2. **可定制性强**：代码结构清晰，易于理解和修改，开发者可以根据自己的需求进行调整\n3. **持续演进**：作为个人项目，它会随着维护者的工作流变化而不断更新\n\n对于希望采用这个项目的开发者，建议采取渐进式引入的策略：\n\n- 首先尝试安装单个技能，观察它如何与现有工作流结合\n- 根据团队的实际需求，有选择性地启用代理功能\n- 仔细阅读Copilot指令文件，根据团队规范进行调整\n- 贡献自己的改进或fork出适合团队的版本\n\n## 许可证与社区参与\n\n项目采用Unlicense许可证(除非个别组件另有说明)，这意味着你可以自由地使用、修改和分发这些代码，几乎没有任何限制。这种宽松的许可方式鼓励社区成员根据自己的需求进行定制。\n\n虽然这是一个个人项目，但其模块化的设计理念和实用的功能集合，使其具有成为社区资源的潜力。开发者可以从中汲取灵感，构建适合自己团队的AI编码工作流。\n\n## 总结与展望\n\nPerdolique/workflow代表了一种新的开发工具范式——不再是单一的、通用的AI助手，而是由多个专业化组件组成的可组合系统。这种模式更符合现代软件开发的复杂性，也为AI辅助编程的未来发展提供了有价值的参考。\n\n对于正在探索如何更好地将AI融入开发流程的团队来说，这个项目提供了一个很好的起点。它不仅是一套工具，更是一种思维方式的展示：如何让AI真正理解并适应你的工作方式，而不是反过来。
