技能 technical-decision-record
📦

technical-decision-record

内容修订 r1 安全 ⚙️ 外部命令

清晰记录技术决策

当技术选择缺少持久记录时，团队会失去上下文。此技能可创建清晰的 ADR，用于捕获选项、理由、后果和回退成本。

支持: Claude Codex Code(CC)
🥉 78 青铜

使用我的智能体安装

将此请求复制给你的智能体，其中包含权威 Skill 页面和清单。

智能体请求
Review the Skillstore skill "technical-decision-record" from https://skillstore.io/skills/chaiwithjai-technical-decision-record.md and its manifest at https://skillstore.io/api/skills/chaiwithjai-technical-decision-record/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

你的智能体仍应展示其计划，并按安全策略请求必要确认。

Agent 可读资源

当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。

Markdown 详情 GET /skills/chaiwithjai-technical-decision-record.md 已签名 manifest GET /api/skills/chaiwithjai-technical-decision-record/manifest 已签名 lockfile GET /api/skills/chaiwithjai-technical-decision-record/lockfile

测试它

正在使用“technical-decision-record”。 我们需要为用户资料数据选择 PostgreSQL、DynamoDB 或 MongoDB。

预期结果:

一份完整的 ADR，包含背景、约束、三个选项、所选数据库、后果、风险和回退成本。

正在使用“technical-decision-record”。 我们的团队正在从同步服务调用迁移到事件驱动集成。

预期结果:

一份决策记录，解释触发原因，比较集成模式，并记录与可观测性和重试相关的运维风险。

正在使用“technical-decision-record”。 审查这份关于采用第三方搜索服务的 ADR 草稿。

预期结果:

一份审查摘要，标记缺失的成本限制、数据驻留问题、回滚计划和所需的利益相关者批准。

安全审计

安全
v9 • 2026/7/6 打开版本化报告

The only static finding is a false positive: SKILL.md line 76 is a fenced Markdown template, not shell execution. No evidence found for prompt injection, data exfiltration intent, or business logic abuse in the reviewed skill content.

1
已扫描文件
189
分析行数
0
复核项
0
已忽略误报

风险因素

⚙️ 外部命令 (1)
SKILL.md:76-133
最新一次完成的静态与语义审计未检测到已确认的安全发现。这并不能证明该 Skill 没有副作用。
审计者: codex 查看审计历史 →
分享与引用此报告

分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。

打开版本化报告
安全评估

复制报告链接

https://skillstore.io/skills/chaiwithjai-technical-decision-record/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/chaiwithjai-technical-decision-record/security.svg)](https://skillstore.io/skills/chaiwithjai-technical-decision-record?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/chaiwithjai-technical-decision-record?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/chaiwithjai-technical-decision-record/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/chaiwithjai-technical-decision-record.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
学术引用 (APA · BibTeX · CFF)

APA 引用

ChaiWithJai. (2026). technical-decision-record security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/chaiwithjai-technical-decision-record/audits/9

BibTeX 引用

@techreport{chaiwithjai-chaiwithjai-technical-decision-record-2026, author = {ChaiWithJai}, title = {technical-decision-record security audit report (audit version 9)}, institution = {Skillstore}, year = {2026}, number = {9}, url = {https://skillstore.io/skills/chaiwithjai-technical-decision-record/audits/9}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "technical-decision-record security audit report (audit version 9)" version: "unspecified" type: report authors: - name: "ChaiWithJai" date-released: "2026-07-06" url: "https://skillstore.io/skills/chaiwithjai-technical-decision-record/audits/9" identifiers: - type: other value: "skillstore:chaiwithjai-technical-decision-record:audit:9" description: "Skillstore immutable audit report identifier"

Skillstore 评分

评分依据 证据置信度: 高
55
架构
85
可维护性
87
内容
71
社区
83
规范符合性

你能构建什么

选择数据库

比较候选数据库，并记录最终选择及其约束、权衡、风险和迁移影响。

记录架构变更

捕获服务边界、集成模式或基础设施方案发生变化的原因，包括对未来团队的影响。

对齐利益相关者

准备一份清晰的决策记录，帮助产品、安全和工程团队审查相同的权衡取舍。

试试这些提示

创建基础 ADR 
帮助我为 [decision] 创建一份 ADR。在起草记录之前，先向我询问缺失的上下文。
将笔记转换为 ADR 
将这些笔记转换为 ADR：[notes]。包括背景、约束、选项、决策、后果、风险和可逆性。
比较技术选项 
比较这些关于 [decision] 的选项：[options]。构建一份 ADR，突出权衡、利益相关者影响和回退成本。
审查现有 ADR 
审查这份 ADR 是否存在缺口：[ADR text]。识别缺失的约束、薄弱的推理、未处理的风险和利益相关者问题。

最佳实践

  • 在要求最终建议之前，提供真实约束。
  • 列出至少两个可行选项，包括相关情况下的当前方案。
  • 将已接受的 ADR 视为历史记录，并通过新的 ADR 取代它们，而不是重写它们。

避免

  • 不要在团队已经忽略所有替代方案之后才要求创建 ADR。
  • 不要在决策记录中隐藏受影响的利益相关者。
  • 不要在容易逆转的决策上投入大量评审时间。

常见问题

此技能会创建架构决策记录吗？
是。它会引导用户梳理背景、约束、选项、决策、后果、风险和可逆性。
它能自行选择最佳技术吗？
不能。它可以帮助比较选项，但需要用户提供准确的约束和团队上下文。
它可以审查现有 ADR 吗？
可以。它可以识别缺失的上下文、薄弱的推理、未处理的风险和不清晰的利益相关者参与情况。
它会运行命令或检查项目文件吗？
不能。该技能仅基于提示，并提供一个文档框架。
哪些决策最适合此技能？
它适用于技术选择、架构变更、服务选型、流程变更，以及具有长期权衡的决策。
应如何更新旧 ADR？
旧 ADR 应保持不变。创建一份新的 ADR 来取代早期记录，并解释变更原因。

开发者详情

许可证

MIT

Skillstore 修订

r1

版本提示

作者未声明版本。

仓库

https://github.com/ChaiWithJai/claude-code-mastery/tree/main/exercises/05-domain-expertise/solution

引用

dd4a3ef9f20ddf38830950b4bb713df96b431fd6

维护新鲜度

2026/7/18

使用量

6 次下载 · 250 次浏览

文件结构

📄 SKILL.md

ChaiWithJai 的更多技能

查看全部

相关技能

查看全部