技能 the-archivist
📦

the-archivist

內容修訂 r1 安全 ⚙️ 外部命令🌐 網路存取

記錄工程決策

當選擇只停留在程式碼審查中時，工程團隊會失去決策依據。The Archivist 幫助 Claude、Codex 和 Claude Code 建立 ADR、決策記錄和行內決策理由。

支援: Claude Codex Code(CC)
Maintain this Skill? Claim it 📊 75 尚可

使用我的智慧代理安裝

將此請求複製給你的智慧代理，其中包含權威 Skill 頁面和清單。

智能體請求
Review the Skillstore skill "the-archivist" from https://skillstore.io/skills/cygnusfear-the-archivist.md and its manifest at https://skillstore.io/api/skills/cygnusfear-the-archivist/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

你的智慧代理仍應顯示其計畫，並依安全政策請求必要確認。

Agent 可讀資源

當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時，請使用這些連結。

Markdown 詳情 GET /skills/cygnusfear-the-archivist.md 已簽名 manifest GET /api/skills/cygnusfear-the-archivist/manifest 已簽名 lockfile GET /api/skills/cygnusfear-the-archivist/lockfile

測試它

正在使用「the-archivist」。 我為了報表查詢選擇 PostgreSQL 而不是 MongoDB。

預期結果:

此技能會建議建立完整 ADR，包含背景、選定選項、被拒絕的替代方案、查詢需求、營運影響和後果。

正在使用「the-archivist」。 審查者看到自訂重試邏輯，但沒有任何說明。

預期結果:

此技能會標記缺失的決策理由，並建議加入行內註解或簡短決策項目，說明為何沒有使用函式庫。

正在使用「the-archivist」。 團隊為背景處理新增工作佇列相依套件。

預期結果:

此技能會將其分類為重大決策，並要求在實作繼續之前完成完整 ADR。

安全審計

安全
v9 • 2026/7/6 開啟版本化報告

AI review found no evidence that the flagged Markdown backticks are executable code; they are documentation fences, templates, or inline file references. The only shell commands shown are local read-only audit examples, and the axios-retry mention is an example dependency name. No prompt injection, data exfiltration, or autonomous network behavior was found in SKILL.md.

3
已掃描檔案
734
分析行數
0
複核項目
0
已忽略的誤報

風險因素

⚙️ 外部命令 (57)
SKILL.md:72-75 SKILL.md:75-78 SKILL.md:78-82 SKILL.md:82-84 SKILL.md:84-88 SKILL.md:88-90 SKILL.md:90-94 SKILL.md:94-104 SKILL.md:104-107 SKILL.md:107-115 SKILL.md:115-118 SKILL.md:118-125 SKILL.md:125-126 SKILL.md:126-137 SKILL.md:137-139 SKILL.md:139-147 SKILL.md:147-152 SKILL.md:152-155 SKILL.md:155-157 SKILL.md:157-161 SKILL.md:161-163 SKILL.md:163-182 SKILL.md:182-186 SKILL.md:186-188 SKILL.md:188-274 SKILL.md:274-280 SKILL.md:280-287 SKILL.md:287-290 SKILL.md:290-297 SKILL.md:297-301 SKILL.md:301-310 SKILL.md:310-329 SKILL.md:329-338 SKILL.md:338-350 SKILL.md:350-353 SKILL.md:353-355 SKILL.md:355-358 SKILL.md:358-372 SKILL.md:372-378 SKILL.md:378-384 SKILL.md:384-393 SKILL.md:393-401 SKILL.md:401-406 SKILL.md:406-412 SKILL.md:412-417 SKILL.md:417-421 SKILL.md:421-459 SKILL.md:459-461 SKILL.md:461-465 SKILL.md:465-468 SKILL.md:468-472 SKILL.md:472-474 SKILL.md:474-505 SKILL.md:505-535 SKILL.md:535-552 SKILL.md:552-556 SKILL.md:556-559
🌐 網路存取 (1)
SKILL.md:376
最近一次完成的靜態與語意稽核未偵測到已確認的安全發現。這並不能證明該 Skill 沒有副作用。
審計單位: codex 檢視審計紀錄 →
分享與引用此報告

分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據，不判斷該 Skill 是否安全。

開啟版本化報告
安全評估

複製報告連結

https://skillstore.io/skills/cygnusfear-the-archivist/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/cygnusfear-the-archivist/security.svg)](https://skillstore.io/skills/cygnusfear-the-archivist?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/cygnusfear-the-archivist?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/cygnusfear-the-archivist/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/cygnusfear-the-archivist.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 引用

Cygnusfear. (2026). the-archivist security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/cygnusfear-the-archivist/audits/9

BibTeX 引用

@techreport{cygnusfear-cygnusfear-the-archivist-2026, author = {Cygnusfear}, title = {the-archivist security audit report (audit version 9)}, institution = {Skillstore}, year = {2026}, number = {9}, url = {https://skillstore.io/skills/cygnusfear-the-archivist/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: "the-archivist security audit report (audit version 9)" version: "unspecified" type: report authors: - name: "Cygnusfear" date-released: "2026-07-06" url: "https://skillstore.io/skills/cygnusfear-the-archivist/audits/9" identifiers: - type: other value: "skillstore:cygnusfear-the-archivist:audit:9" description: "Skillstore immutable audit report identifier"

Skillstore 評分

評分依據 證據置信度: 高
41
架構
85
可維護性
87
內容
70
社群
87
規範符合度

你可以打造什麼

捕捉架構選擇

記錄團隊為何在合理替代方案之中選擇某項技術、模式或相依套件。

審查缺失的決策理由

檢查 pull requests 中是否有需要行內註解或 ADR 連結的非顯而易見決策。

標準化專案記憶

建立一致的決策記錄，讓未來維護者理解歷史取捨。

試試這些提示

記錄一項選擇 
幫我記錄這個工程選擇。識別決策、理由、一個被拒絕的替代方案，以及合適的文件層級。
建立簡短 ADR 
將這個實作選擇轉換成簡短的 ADR 項目，包含背景、決策、理由、被拒絕的替代方案、後果和狀態。
審查 Pull Request 
審查這些變更中未記錄的工程決策。列出每個缺失的理由項目，並建議使用行內註解、決策記錄或完整 ADR。
稽核決策歷史 
稽核這個專案歷史中需要 ADR 的決策。依文件層級分組結果，並建議決策記錄的更新內容。

最佳實務

  • 當選擇會影響未來維護時，在實作之前記錄該決策。
  • 納入被拒絕的替代方案和後果，而不只是選定選項。
  • 連結程式碼、計畫和 ADR，讓未來讀者可以追溯決策理由。

避免

  • 在實作之後才建立 ADR，只為了合理化已經做出的選擇。
  • 撰寫含糊註解，只陳述偏好卻沒有說明替代方案。
  • 記錄不影響可維護性或架構的瑣碎選擇。

常見問題

The Archivist 幫助記錄什麼？
它幫助記錄工程決策、被拒絕的替代方案、取捨，以及程式碼與 ADR 之間的連結。
它會建立完整的 Architecture Decision Records 嗎？
是。它包含完整的 ADR 範本，以及何時適合使用完整記錄的指引。
它可以在程式碼審查期間使用嗎？
可以。它提供用於缺失決策文件的清單項目和審查回應。
它會記錄每個小選擇嗎？
不會。它包含規則，用於避免對瑣碎或慣例性選擇進行不必要的文件化。
它會取代技術判斷嗎？
不會。它記錄決策理由，但不會證明該決策是正確的。
哪些助理可以使用這項技能？
報告列出支援 Claude、Codex 和 Claude Code。

開發者詳細資訊

作者

Cygnusfear

授權

MIT

Skillstore 修訂

r1

版本提示

作者未聲明版本。

儲存庫

https://github.com/Cygnusfear/claude-stuff/tree/main/skills/the-archivist

引用

34f316ba14ef36c7a620fc09f2676d2429997a77

維護新鮮度

2026/7/18

使用量

5 次下載 · 194 次瀏覽

檔案結構

📁 references/

📄 adr-template.md

📄 decisions-log-template.md

📄 SKILL.md

Cygnusfear 的更多技能

查看全部

相關技能

查看全部