[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72XZJ6DSC4F1DS79CW7G4EB":3,"skill-same:01M72XZJ6DSC4F1DS79CW7G4EB":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M72XZJ6DSC4F1DS79CW7G4EB","architecture-decision-records",null,"在Claude Code会话期间，将做出的架构决策捕获为结构化的架构决策记录（ADR）。自动检测决策时刻，记录上下文、考虑的替代方案和理由。维护一个ADR日志，以便未来的开发人员理解代码库为何以当前方式构建。","SriramGandhiS\u002FSkills","SriramGandhiS","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211849986?v=4","01M72WQCW12BYX71C6WN584TTA","Sriram S","01M72WQCWTJ2RD0ET1X31AF1RC",1,"MIT","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Feverything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Farchitecture-decision-records\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: architecture-decision-records\ndescription: 在Claude Code会话期间，将做出的架构决策捕获为结构化的架构决策记录（ADR）。自动检测决策时刻，记录上下文、考虑的替代方案和理由。维护一个ADR日志，以便未来的开发人员理解代码库为何以当前方式构建。\norigin: ECC\n---\n\n# 架构决策记录\n\n在编码会话期间捕捉架构决策。让决策不仅存在于 Slack 线程、PR 评论或某人的记忆中，此技能将生成结构化的 ADR 文档，并与代码并存。\n\n## 何时激活\n\n* 用户明确说\"让我们记录这个决定\"或\"为这个做 ADR\"\n* 用户在重要的备选方案（框架、库、模式、数据库、API 设计）之间做出选择\n* 用户说\"我们决定...\"或\"我们选择 X 而不是 Y 的原因是...\"\n* 用户询问\"我们为什么选择了 X？\"（读取现有 ADR）\n* 在讨论架构权衡的规划阶段\n\n## ADR 格式\n\n使用 Michael Nygard 提出的轻量级 ADR 格式，并针对 AI 辅助开发进行调整：\n\n```markdown\n# ADR-NNNN: [决策标题]\n\n**日期**: YYYY-MM-DD\n**状态**: 提议中 | 已接受 | 已弃用 | 被 ADR-NNNN 取代\n**决策者**: [相关人员]\n\n## 背景\n\n我们观察到的促使做出此决策或变更的问题是什么？\n\n[用 2-5 句话描述当前情况、约束条件和影响因素]\n\n## 决策\n\n我们提议和\u002F或正在进行的变更是什么？\n\n[用 1-3 句话清晰地陈述决策]\n\n## 考虑的备选方案\n\n### 备选方案 1: [名称]\n- **优点**: [益处]\n- **缺点**: [弊端]\n- **为何不选**: [被拒绝的具体原因]\n\n### 备选方案 2: [名称]\n- **优点**: [益处]\n- **缺点**: [弊端]\n- **为何不选**: [被拒绝的具体原因]\n\n## 影响\n\n由于此变更，哪些事情会变得更容易或更困难？\n\n### 积极影响\n- [益处 1]\n- [益处 2]\n\n### 消极影响\n- [权衡 1]\n- [权衡 2]\n\n### 风险\n- [风险及缓解措施]\n```\n\n## 工作流程\n\n### 捕捉新的 ADR\n\n当检测到决策时刻时：\n\n1. **初始化（仅首次）** — 如果 `docs\u002Fadr\u002F` 不存在，在创建目录、一个包含索引表头（见下方 ADR 索引格式）的 `README.md` 以及一个供手动使用的空白 `template.md` 之前，询问用户进行确认。未经明确同意，不要创建文件。\n2. **识别决策** — 提取正在做出的核心架构选择\n3. **收集上下文** — 是什么问题引发了此决策？存在哪些约束？\n4. **记录备选方案** — 考虑了哪些其他选项？为什么拒绝了它们？\n5. **陈述后果** — 权衡是什么？什么变得更容易\u002F更难？\n6. **分配编号** — 扫描 `docs\u002Fadr\u002F` 中的现有 ADR 并递增\n7. **确认并写入** — 向用户展示 ADR 草稿以供审查。仅在获得明确批准后写入 `docs\u002Fadr\u002FNNNN-decision-title.md`。如果用户拒绝，则丢弃草稿，不写入任何文件。\n8. **更新索引** — 追加到 `docs\u002Fadr\u002FREADME.md`\n\n### 读取现有 ADR\n\n当用户询问\"我们为什么选择了 X？\"时：\n\n1. 检查 `docs\u002Fadr\u002F` 是否存在 — 如果不存在，回复：\"在此项目中未找到 ADR。您想开始记录架构决策吗？\"\n2. 如果存在，扫描 `docs\u002Fadr\u002FREADME.md` 索引以查找相关条目\n3. 读取匹配的 ADR 文件并呈现上下文和决策部分\n4. 如果未找到匹配项，回复：\"未找到关于该决策的 ADR。您现在想记录一个吗？\"\n\n### ADR 目录结构\n\n```\ndocs\u002F\n└── adr\u002F\n    ├── README.md              ← 所有 ADR 的索引\n    ├── 0001-use-nextjs.md\n    ├── 0002-postgres-over-mongo.md\n    ├── 0003-rest-over-graphql.md\n    └── template.md            ← 供手动使用的空白模板\n```\n\n### ADR 索引格式\n\n```markdown\n# 架构决策记录\n\n| ADR | 标题 | 状态 | 日期 |\n|-----|-------|--------|------|\n| [0001](0001-use-nextjs.md) | 使用 Next.js 作为前端框架 | 已采纳 | 2026-01-15 |\n| [0002](0002-postgres-over-mongo.md) | 主数据存储选用 PostgreSQL 而非 MongoDB | 已采纳 | 2026-01-20 |\n| [0003](0003-rest-over-graphql.md) | 选用 REST API 而非 GraphQL | 已采纳 | 2026-02-01 |\n```\n\n## 决策检测信号\n\n留意对话中指示架构决策的以下模式：\n\n**显式信号**\n\n* \"让我们选择 X\"\n* \"我们应该使用 X 而不是 Y\"\n* \"权衡是值得的，因为...\"\n* \"将此记录为 ADR\"\n\n**隐式信号**（建议记录 ADR — 未经用户确认不要自动创建）\n\n* 比较两个框架或库并得出结论\n* 做出数据库模式设计选择并陈述理由\n* 在架构模式之间选择（单体 vs 微服务，REST vs GraphQL）\n* 决定身份验证\u002F授权策略\n* 评估备选方案后选择部署基础设施\n\n## 优秀 ADR 的要素\n\n### 应该做\n\n* **具体明确** — \"使用 Prisma ORM\"，而不是\"使用一个 ORM\"\n* **记录原因** — 理由比内容更重要\n* **包含被拒绝的备选方案** — 未来的开发者需要知道考虑了哪些选项\n* **诚实地陈述后果** — 每个决策都有权衡\n* **保持简短** — 一份 ADR 应在 2 分钟内可读完\n* **使用现在时态** — \"我们使用 X\"，而不是\"我们将使用 X\"\n\n### 不应该做\n\n* 记录琐碎的决定 — 变量命名或格式化选择不需要 ADR\n* 写成论文 — 如果上下文部分超过 10 行，就太长了\n* 省略备选方案 — \"我们只是选了它\"不是一个有效的理由\n* 追溯记录而不加标记 — 如果记录过去的决定，请注明原始日期\n* 让 ADR 过时 — 被取代的决策应引用其替代品\n\n## ADR 生命周期\n\n```\nproposed → accepted → [deprecated | superseded by ADR-NNNN]\n```\n\n* **proposed**：决策正在讨论中，尚未确定\n* **accepted**：决策已生效并正在遵循\n* **deprecated**：决策不再相关（例如，功能已移除）\n* **superseded**：更新的 ADR 取代了此决策（始终链接替代品）\n\n## 值得记录的决策类别\n\n| 类别 | 示例 |\n|----------|---------|\n| **技术选择** | 框架、语言、数据库、云提供商 |\n| **架构模式** | 单体 vs 微服务、事件驱动、CQRS |\n| **API 设计** | REST vs GraphQL、版本控制策略、认证机制 |\n| **数据建模** | 模式设计、规范化决策、缓存策略 |\n| **基础设施** | 部署模型、CI\u002FCD 流水线、监控堆栈 |\n| **安全** | 认证策略、加密方法、密钥管理 |\n| **测试** | 测试框架、覆盖率目标、E2E 与集成测试的平衡 |\n| **流程** | 分支策略、评审流程、发布节奏 |\n\n## 与其他技能的集成\n\n* **规划代理**：当规划者提出架构变更时，建议创建 ADR\n* **代码审查代理**：标记引入架构变更但未附带相应 ADR 的 PR\n","# 架构决策记录\n\n在编码会话期间捕捉架构决策。让决策不仅存在于 Slack 线程、PR 评论或某人的记忆中，此技能将生成结构化的 ADR 文档，并与代码并存。\n\n## 何时激活\n\n* 用户明确说\"让我们记录这个决定\"或\"为这个做 ADR\"\n* 用户在重要的备选方案（框架、库、模式、数据库、API 设计）之间做出选择\n* 用户说\"我们决定...\"或\"我们选择 X 而不是 Y 的原因是...\"\n* 用户询问\"我们为什么选择了 X？\"（读取现有 ADR）\n* 在讨论架构权衡的规划阶段\n\n## ADR 格式\n\n使用 Michael Nygard 提出的轻量级 ADR 格式，并针对 AI 辅助开发进行调整：\n\n```markdown\n# ADR-NNNN: [决策标题]\n\n**日期**: YYYY-MM-DD\n**状态**: 提议中 | 已接受 | 已弃用 | 被 ADR-NNNN 取代\n**决策者**: [相关人员]\n\n## 背景\n\n我们观察到的促使做出此决策或变更的问题是什么？\n\n[用 2-5 句话描述当前情况、约束条件和影响因素]\n\n## 决策\n\n我们提议和\u002F或正在进行的变更是什么？\n\n[用 1-3 句话清晰地陈述决策]\n\n## 考虑的备选方案\n\n### 备选方案 1: [名称]\n- **优点**: [益处]\n- **缺点**: [弊端]\n- **为何不选**: [被拒绝的具体原因]\n\n### 备选方案 2: [名称]\n- **优点**: [益处]\n- **缺点**: [弊端]\n- **为何不选**: [被拒绝的具体原因]\n\n## 影响\n\n由于此变更，哪些事情会变得更容易或更困难？\n\n### 积极影响\n- [益处 1]\n- [益处 2]\n\n### 消极影响\n- [权衡 1]\n- [权衡 2]\n\n### 风险\n- [风险及缓解措施]\n```\n\n## 工作流程\n\n### 捕捉新的 ADR\n\n当检测到决策时刻时：\n\n1. **初始化（仅首次）** — 如果 `docs\u002Fadr\u002F` 不存在，在创建目录、一个包含索引表头（见下方 ADR 索引格式）的 `README.md` 以及一个供手动使用的空白 `template.md` 之前，询问用户进行确认。未经明确同意，不要创建文件。\n2. **识别决策** — 提取正在做出的核心架构选择\n3. **收集上下文** — 是什么问题引发了此决策？存在哪些约束？\n4. **记录备选方案** — 考虑了哪些其他选项？为什么拒绝了它们？\n5. **陈述后果** — 权衡是什么？什么变得更容易\u002F更难？\n6. **分配编号** — 扫描 `docs\u002Fadr\u002F` 中的现有 ADR 并递增\n7. **确认并写入** — 向用户展示 ADR 草稿以供审查。仅在获得明确批准后写入 `docs\u002Fadr\u002FNNNN-decision-title.md`。如果用户拒绝，则丢弃草稿，不写入任何文件。\n8. **更新索引** — 追加到 `docs\u002Fadr\u002FREADME.md`\n\n### 读取现有 ADR\n\n当用户询问\"我们为什么选择了 X？\"时：\n\n1. 检查 `docs\u002Fadr\u002F` 是否存在 — 如果不存在，回复：\"在此项目中未找到 ADR。您想开始记录架构决策吗？\"\n2. 如果存在，扫描 `docs\u002Fadr\u002FREADME.md` 索引以查找相关条目\n3. 读取匹配的 ADR 文件并呈现上下文和决策部分\n4. 如果未找到匹配项，回复：\"未找到关于该决策的 ADR。您现在想记录一个吗？\"\n\n### ADR 目录结构\n\n```\ndocs\u002F\n└── adr\u002F\n    ├── README.md              ← 所有 ADR 的索引\n    ├── 0001-use-nextjs.md\n    ├── 0002-postgres-over-mongo.md\n    ├── 0003-rest-over-graphql.md\n    └── template.md            ← 供手动使用的空白模板\n```\n\n### ADR 索引格式\n\n```markdown\n# 架构决策记录\n\n| ADR | 标题 | 状态 | 日期 |\n|-----|-------|--------|------|\n| [0001](0001-use-nextjs.md) | 使用 Next.js 作为前端框架 | 已采纳 | 2026-01-15 |\n| [0002](0002-postgres-over-mongo.md) | 主数据存储选用 PostgreSQL 而非 MongoDB | 已采纳 | 2026-01-20 |\n| [0003](0003-rest-over-graphql.md) | 选用 REST API 而非 GraphQL | 已采纳 | 2026-02-01 |\n```\n\n## 决策检测信号\n\n留意对话中指示架构决策的以下模式：\n\n**显式信号**\n\n* \"让我们选择 X\"\n* \"我们应该使用 X 而不是 Y\"\n* \"权衡是值得的，因为...\"\n* \"将此记录为 ADR\"\n\n**隐式信号**（建议记录 ADR — 未经用户确认不要自动创建）\n\n* 比较两个框架或库并得出结论\n* 做出数据库模式设计选择并陈述理由\n* 在架构模式之间选择（单体 vs 微服务，REST vs GraphQL）\n* 决定身份验证\u002F授权策略\n* 评估备选方案后选择部署基础设施\n\n## 优秀 ADR 的要素\n\n### 应该做\n\n* **具体明确** — \"使用 Prisma ORM\"，而不是\"使用一个 ORM\"\n* **记录原因** — 理由比内容更重要\n* **包含被拒绝的备选方案** — 未来的开发者需要知道考虑了哪些选项\n* **诚实地陈述后果** — 每个决策都有权衡\n* **保持简短** — 一份 ADR 应在 2 分钟内可读完\n* **使用现在时态** — \"我们使用 X\"，而不是\"我们将使用 X\"\n\n### 不应该做\n\n* 记录琐碎的决定 — 变量命名或格式化选择不需要 ADR\n* 写成论文 — 如果上下文部分超过 10 行，就太长了\n* 省略备选方案 — \"我们只是选了它\"不是一个有效的理由\n* 追溯记录而不加标记 — 如果记录过去的决定，请注明原始日期\n* 让 ADR 过时 — 被取代的决策应引用其替代品\n\n## ADR 生命周期\n\n```\nproposed → accepted → [deprecated | superseded by ADR-NNNN]\n```\n\n* **proposed**：决策正在讨论中，尚未确定\n* **accepted**：决策已生效并正在遵循\n* **deprecated**：决策不再相关（例如，功能已移除）\n* **superseded**：更新的 ADR 取代了此决策（始终链接替代品）\n\n## 值得记录的决策类别\n\n| 类别 | 示例 |\n|----------|---------|\n| **技术选择** | 框架、语言、数据库、云提供商 |\n| **架构模式** | 单体 vs 微服务、事件驱动、CQRS |\n| **API 设计** | REST vs GraphQL、版本控制策略、认证机制 |\n| **数据建模** | 模式设计、规范化决策、缓存策略 |\n| **基础设施** | 部署模型、CI\u002FCD 流水线、监控堆栈 |\n| **安全** | 认证策略、加密方法、密钥管理 |\n| **测试** | 测试框架、覆盖率目标、E2E 与集成测试的平衡 |\n| **流程** | 分支策略、评审流程、发布节奏 |\n\n## 与其他技能的集成\n\n* **规划代理**：当规划者提出架构变更时，建议创建 ADR\n* **代码审查代理**：标记引入架构变更但未附带相应 ADR 的 PR\n",{"name":5,"origin":24,"description":7},"ECC","master","d6ca01da0f24a3b0e26e4a8b7b66cbd25d429f5d","everything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Farchitecture-decision-records",0,"https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills","https:\u002F\u002Fgithub.com\u002FSriramGandhiS","https:\u002F\u002Fsriram.website\u002F","Curious guy who keeps tinkering until something works","2026-05-20 16:21:34",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add SriramGandhiS\u002FSkills --skill architecture-decision-records",{"tool":40,"command":41},"bunx","bunx skills add SriramGandhiS\u002FSkills --skill architecture-decision-records",{"tool":43,"command":44},"pnpm","pnpm dlx skills add SriramGandhiS\u002FSkills --skill architecture-decision-records","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Feverything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Farchitecture-decision-records\u002FSKILL.md",true,[],[49,57,62,68,75,82],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":56},"01M732609EPJWV13PVTX3GT4TM","webgpu-threejs-tsl","Comprehensive guide for developing WebGPU-enabled Three.js applications using TSL (Three.js Shading Language). Covers WebGPU renderer setup, TSL syntax and node materials, compute shaders, post-processing effects, and WGSL integration. Use this skill when working with Three.js WebGPU, TSL shaders, node materials, or GPU compute in Three.js.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fwebgpu-threejs-tsl\u002Fskills\u002Fwebgpu-threejs-tsl\u002FSKILL.md",[],[],"2026-11-11 15:11:14",{"skillNo":58,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":56},"01M7325XM47AGWB6K6C4VXKE6B","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fwebgpu-threejs-tsl\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":56},"01M7325WP6DES69JKC840VMFEP","verification-loop","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fverification-loop\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":56},"01M7325TFQF1DZTQ6J3WGQQ1VR","tdd-workflow","Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Ftdd-workflow\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":56},"01M7325RGV9AY9PK92D2V8KKPW","strategic-compact","Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fstrategic-compact\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":56},"01M7325MZC28SE86E7NMCNEFS4","security-review","Use this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment\u002Fsensitive features. Provides comprehensive security checklist and patterns.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fsecurity-review\u002FSKILL.md",[],[]]