2026/9/10 16:44:02
FEATURED · 精选文章 
Decision Title【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composioDecisionState the accepted direction in one or two paragraphs.ContextDescribe the problem, constraints, and alternatives that matter.ConsequencesList operational rules, tradeoffs, and follow-up work.VerificationName commands, generated artifacts, or review checks that prove future changes still honor the decision.四个小节各有明确职责 | 小节 | 职责 | 仓库实例 | |---|---|---| | **Decision** | 用一两段话陈述被采纳的方向 | [docs/decisions/feedback.md](https://link.gitcode.com/i/87f10f5940717d31860f93531e8e88b7) 的Use Slack webhooks for collecting documentation feedback | | **Context** | 描述问题、约束与值得记录的备选方案 | [docs/decisions/feedback.md](https://link.gitcode.com/i/87f10f5940717d31860f93531e8e88b7) 用一张表对比了 GitHub Issues、Slack webhook、Vercel KV、Email、Google Sheets 五种方案 | | **Consequences** | 列出操作规则、权衡与后续工作 | [docs/decisions/toolkit-page-availability.md](https://link.gitcode.com/i/54cda707d6761cfc82c275d309bd2cee) 用 bullet 列出回退行为的边界与回滚方式 | | **Verification** | 给出命令、生成产物或评审检查证明未来变更仍然遵循该决策 | [docs/decisions/toolkit-page-availability.md](https://link.gitcode.com/i/54cda707d6761cfc82c275d309bd2cee) 要求运行 bun run lint:links用 workflow_dispatch 在精确评审头运行验证 | 值得注意的是模板中 Decision 与 Context 的顺序**决策在前、背景在后**。这延续了先陈述决策的风格准则——读者先看到结论需要深入时再读背景与备选方案分析。Verification 小节是模板中最具工程价值的部分它把决策是否仍然成立从口头承诺变成了可执行的检查项例如 [docs/decisions/kb-freshness-verification.md](https://link.gitcode.com/i/6a41d8c86fdef73fc65f0e4ee8824ecf) 的验证小节直接给出从 docs/ 目录运行的命令序列 bun run test、bun run types:check、bun run lint、bun run lint:links、bun run build。 ## 更新已有决策四步流程与链接验证 当一次文档变更影响到既有决策时规范给出了明确的更新流程 1. **读取当前记录**Read the current record——先完整理解既有决策内容与理由避免凭印象修改 2. **修补决策或添加带日期的说明**Patch the decision or add a dated note——小幅变更直接修补正文若决策方向发生重大调整则保留历史并追加带日期的说明维持可审计性 3. **更新 docs/decisions/README.md**——保持索引与实际记录一致若记录被新增、更名或删除都必须同步 4. **当内容链接发生变化时运行 bun run lint:links 验证链接**Verify links with bun run lint:links when content links changed。 第 4 步与仓库的链接校验机制衔接文档仓库把站内链接完整性作为质量门禁之一。在 [.agents/skills/docs-decisions/references/docs-workflow.md](https://link.gitcode.com/i/8f40b4d25b11a8244f92f316aa40475c) 中可以看到完整命令清单决策记录引用的 lint:links 正是其中之一。决策记录之间也会互相引用例如 [docs/decisions/toolkit-page-availability.md](https://link.gitcode.com/i/54cda707d6761cfc82c275d309bd2cee) 引用了 ./toolkits.md 与 ./kb-freshness-verification.md一旦相对路径失效lint:links 即可在合并前拦截问题。 ## 实战剖析从真实记录看模板如何落地 下面以仓库中两份代表性记录为例展示四段式模板在复杂决策上的实际运用。 ### 案例一LLM 护栏llm-guardrails.md [docs/decisions/llm-guardrails.md](https://link.gitcode.com/i/0e4019f82237dd0892e1fbffbbffa992) 解决的是一个典型的文档被 LLM 消费问题爬取或接收 Composio 文档的 LLM 倾向于生成旧的直接工具执行代码composio.tools.get()、composio.provider.handle_tool_calls()而不是当前的会话模式composio.create()、session.tools()。该记录在 Context 之后给出了完整的架构lib/llm-guardrails/ ├── index.ts ← getGuardrails(type), module-private GuardrailType ├── session.ts ← SESSION_GUARDRAILS constant (default) └── direct-execution.ts ← DIRECT_EXECUTION_GUARDRAILS constant【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Decision Title
Decision Title【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composioDecisionState the accepted direction in one or two paragraphs.ContextDescribe the problem, constraints, and alternatives that matter.ConsequencesList operational rules, tradeoffs, and follow-up work.VerificationName commands, generated artifacts, or review checks that prove future changes still honor the decision.四个小节各有明确职责 | 小节 | 职责 | 仓库实例 | |---|---|---| | **Decision** | 用一两段话陈述被采纳的方向 | [docs/decisions/feedback.md](https://link.gitcode.com/i/87f10f5940717d31860f93531e8e88b7) 的Use Slack webhooks for collecting documentation feedback | | **Context** | 描述问题、约束与值得记录的备选方案 | [docs/decisions/feedback.md](https://link.gitcode.com/i/87f10f5940717d31860f93531e8e88b7) 用一张表对比了 GitHub Issues、Slack webhook、Vercel KV、Email、Google Sheets 五种方案 | | **Consequences** | 列出操作规则、权衡与后续工作 | [docs/decisions/toolkit-page-availability.md](https://link.gitcode.com/i/54cda707d6761cfc82c275d309bd2cee) 用 bullet 列出回退行为的边界与回滚方式 | | **Verification** | 给出命令、生成产物或评审检查证明未来变更仍然遵循该决策 | [docs/decisions/toolkit-page-availability.md](https://link.gitcode.com/i/54cda707d6761cfc82c275d309bd2cee) 要求运行 bun run lint:links用 workflow_dispatch 在精确评审头运行验证 | 值得注意的是模板中 Decision 与 Context 的顺序**决策在前、背景在后**。这延续了先陈述决策的风格准则——读者先看到结论需要深入时再读背景与备选方案分析。Verification 小节是模板中最具工程价值的部分它把决策是否仍然成立从口头承诺变成了可执行的检查项例如 [docs/decisions/kb-freshness-verification.md](https://link.gitcode.com/i/6a41d8c86fdef73fc65f0e4ee8824ecf) 的验证小节直接给出从 docs/ 目录运行的命令序列 bun run test、bun run types:check、bun run lint、bun run lint:links、bun run build。 ## 更新已有决策四步流程与链接验证 当一次文档变更影响到既有决策时规范给出了明确的更新流程 1. **读取当前记录**Read the current record——先完整理解既有决策内容与理由避免凭印象修改 2. **修补决策或添加带日期的说明**Patch the decision or add a dated note——小幅变更直接修补正文若决策方向发生重大调整则保留历史并追加带日期的说明维持可审计性 3. **更新 docs/decisions/README.md**——保持索引与实际记录一致若记录被新增、更名或删除都必须同步 4. **当内容链接发生变化时运行 bun run lint:links 验证链接**Verify links with bun run lint:links when content links changed。 第 4 步与仓库的链接校验机制衔接文档仓库把站内链接完整性作为质量门禁之一。在 [.agents/skills/docs-decisions/references/docs-workflow.md](https://link.gitcode.com/i/8f40b4d25b11a8244f92f316aa40475c) 中可以看到完整命令清单决策记录引用的 lint:links 正是其中之一。决策记录之间也会互相引用例如 [docs/decisions/toolkit-page-availability.md](https://link.gitcode.com/i/54cda707d6761cfc82c275d309bd2cee) 引用了 ./toolkits.md 与 ./kb-freshness-verification.md一旦相对路径失效lint:links 即可在合并前拦截问题。 ## 实战剖析从真实记录看模板如何落地 下面以仓库中两份代表性记录为例展示四段式模板在复杂决策上的实际运用。 ### 案例一LLM 护栏llm-guardrails.md [docs/decisions/llm-guardrails.md](https://link.gitcode.com/i/0e4019f82237dd0892e1fbffbbffa992) 解决的是一个典型的文档被 LLM 消费问题爬取或接收 Composio 文档的 LLM 倾向于生成旧的直接工具执行代码composio.tools.get()、composio.provider.handle_tool_calls()而不是当前的会话模式composio.create()、session.tools()。该记录在 Context 之后给出了完整的架构lib/llm-guardrails/ ├── index.ts ← getGuardrails(type), module-private GuardrailType ├── session.ts ← SESSION_GUARDRAILS constant (default) └── direct-execution.ts ← DIRECT_EXECUTION_GUARDRAILS constant【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
