赋予你的智能体使用结构化的 ADR 格式记录关键架构选择的能力,该格式针对机器解析和人类参考都进行了优化。
当你的团队做出重大技术选择且需要清晰的记录时
当你想要记录为什么拒绝了某个特定的备选方案时
当你需要追踪某项决定的正面和负面影响时
提供该决定的背景、技术约束和业务需求
描述所选的解决方案及其被选中的明确理由
列出所有考虑过的备选方案以及它们被拒绝的具体原因
检查并将格式化后的 ADR 文件保存到项目的 /docs/adr/ 目录中
你
我们已经决定将移动 API 从 REST 迁移到 GraphQL。请记录这一点。
Agent
我将为你的 GraphQL 迁移生成 ADR-0004。我将把性能和灵活性优势包含为 POS 代码,并将增加的复杂性记录为 NEG 代码。我还会记录我们为什么拒绝保留 REST,并将其保存到 /docs/adr/adr-0004-graphql-migration.md。
Gives your agent the ability to define clear, unambiguous, and AI-ready specifications for schemas, tools, architecture, and more, ensuring a machine-readable project foundation.
Gives your agent the ability to create an llms.txt file that serves as a high-level navigation guide for LLMs to understand your repository's purpose and structure.
Gives your agent the ability to implement and troubleshoot create technical spike tasks.
Gives your agent the ability to act as a senior expert, creating appealing, informative, and professional README.md files that effectively showcase your project.
赋予你的智能体生成一份全面的 AGENTS.md 文件的能力,为 AI 编码工具提供技术背景和指令,以便在你的项目中高效工作。