技能 architecture-documenter

📦

architecture-documenter

內容修訂 r1 安全 ⚙️ 外部命令🌐 網路存取🔑 環境變數

清楚記錄軟體架構

團隊經常失去系統設計與技術決策的脈絡。此技能可建立結構化架構文件、ADR、圖表與審查指引。

支援: Claude Codex Code(CC)

Maintain this Skill? Claim it 🥉 77 銅級

使用我的智慧代理安裝

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

智能體請求

Review the Skillstore skill "architecture-documenter" from https://skillstore.io/skills/curiouslearner-architecture-documenter.md and its manifest at https://skillstore.io/api/skills/curiouslearner-architecture-documenter/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

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

Agent 可讀資源

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

Markdown 詳情 GET /skills/curiouslearner-architecture-documenter.md 已簽名 manifest GET /api/skills/curiouslearner-architecture-documenter/manifest 已簽名 lockfile GET /api/skills/curiouslearner-architecture-documenter/lockfile

測試它

正在使用「architecture-documenter」。記錄一個使用 web app、API gateway、payment provider、database 和 webhook processor 的 payments service。

預期結果:

一份結構化架構文件，包含系統脈絡、元件職責、webhook 流程、付款安全性備註、失敗處理與建議圖表。

正在使用「architecture-documenter」。為從 server sessions 遷移到 JWT authentication 撰寫 ADR。

預期結果:

一份狀態為 accepted 的 ADR，包含脈絡、決策、替代方案、後果、token 安全性考量、推出計畫與回復指引。

正在使用「architecture-documenter」。在 microservices migration review 前更新架構文件。

預期結果:

一份可供審查的大綱，涵蓋目前相依性、目標服務邊界、資料所有權、部署變更、可觀測性、風險與決策缺口。

安全審計

安全

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

The static findings are all false positives after contextual review of SKILL.md. They come from Markdown code fences, documentation examples, reference URLs, private CIDR examples, and illustrative JWT snippets rather than executable skill behavior.

1

已掃描檔案

1,457

分析行數

0

複核項目

0

已忽略的誤報

風險因素

⚙️ 外部命令 (65)

SKILL.md:56-136 SKILL.md:136-162 SKILL.md:162-180 SKILL.md:180-219 SKILL.md:219-249 SKILL.md:249-257 SKILL.md:257-291 SKILL.md:291-313 SKILL.md:313-316 SKILL.md:316 SKILL.md:335-362 SKILL.md:362-382 SKILL.md:382-410 SKILL.md:410-433 SKILL.md:433-464 SKILL.md:464-467 SKILL.md:467-471 SKILL.md:471-489 SKILL.md:489-502 SKILL.md:502-511 SKILL.md:511-533 SKILL.md:533-549 SKILL.md:549-557 SKILL.md:557-576 SKILL.md:576-579 SKILL.md:579-586 SKILL.md:586-591 SKILL.md:591-594 SKILL.md:594-600 SKILL.md:600-604 SKILL.md:604-607 SKILL.md:607-609 SKILL.md:609-610 SKILL.md:610-611 SKILL.md:611-614 SKILL.md:614-615 SKILL.md:615-638 SKILL.md:638-649 SKILL.md:649-660 SKILL.md:660-669 SKILL.md:669-675 SKILL.md:675-680 SKILL.md:680-703 SKILL.md:703-725 SKILL.md:725-729 SKILL.md:729-736 SKILL.md:736-786 SKILL.md:786-795 SKILL.md:795-899 SKILL.md:899-906 SKILL.md:906-917 SKILL.md:917-937 SKILL.md:937-944 SKILL.md:944-954 SKILL.md:954-1046 SKILL.md:1046-1050 SKILL.md:1050-1067 SKILL.md:1067-1082 SKILL.md:1082-1107 SKILL.md:1107-1138 SKILL.md:1138-1143 SKILL.md:1143-1148 SKILL.md:1148-1367 SKILL.md:1367-1371 SKILL.md:1371-1379

🌐 網路存取 (6)

SKILL.md:1347 SKILL.md:1348 SKILL.md:1349 SKILL.md:661 SKILL.md:662 SKILL.md:665

🔑 環境變數 (6)

SKILL.md:1114 SKILL.md:1120 SKILL.md:1132 SKILL.md:1114 SKILL.md:1120 SKILL.md:1132

最近一次完成的靜態與語意稽核未偵測到已確認的安全發現。這並不能證明該 Skill 沒有副作用。

審計單位: codex 檢視審計紀錄 →

分享與引用此報告

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

開啟版本化報告

安全評估

複製報告連結

https://skillstore.io/skills/curiouslearner-architecture-documenter/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/curiouslearner-architecture-documenter/security.svg)](https://skillstore.io/skills/curiouslearner-architecture-documenter?utm_source=security_passport_badge)

HTML 徽章

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

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/curiouslearner-architecture-documenter.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 引用

CuriousLearner. (2026). architecture-documenter security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/curiouslearner-architecture-documenter/audits/9

BibTeX 引用

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

Skillstore 評分

評分依據證據置信度: 高

55

架構

85

可維護性

87

內容

73

社群

70

規範符合度

你可以打造什麼

建立系統架構文件

將系統脈絡、服務、資料儲存、整合與部署備註轉換為清楚的架構參考文件。

記錄技術決策

記錄選擇某項技術、模式或遷移路徑的原因，包括替代方案與取捨。

準備入職文件

為新團隊成員摘要系統邊界、工作流程、圖表與營運考量。

試試這些提示

初學者架構概覽

為此專案建立系統架構概覽。包含目的、使用者、主要元件、資料儲存、整合與待釐清問題。

元件與資料流程文件

記錄這些元件與資料流程的架構。包含職責、相依性、失敗模式、要建立的圖表與假設。

架構決策紀錄

為此決策撰寫 ADR。包含脈絡、決策、已考慮的替代方案、後果、風險、緩解措施、推出計畫與審查日期。

進階架構審查套件

建立架構審查套件。涵蓋目前狀態、目標狀態、圖表、擴展性、安全性、可觀測性、遷移步驟、風險與尚未解決的決策。

最佳實務

在要求建立文件前，提供真實的系統脈絡、限制與已知取捨。
先要求以描述形式產生圖表，再轉換成團隊偏好的圖表格式。
與工程、安全性、產品與營運利害關係人一起審查產生的 ADR。

避免

不要在未與實際系統核對的情況下發布產生的架構文件。
不要隱藏不確定性；標明假設、未知事項與仍需審查的決策。
不要將架構文件當作威脅建模或合規審查的替代品。

常見問題

此技能可以協助建立什麼？

它有助於建立系統架構文件、ADR、圖表計畫、部署備註與文件維護指引。

它可以自動分析我的儲存庫嗎？

當助理有存取權時，它可以使用儲存庫檔案，但此技能本身是文件指引，不是掃描器。

它會產生圖表嗎？

它會建議圖表類型與內容。你可以要求助理以 Mermaid、PlantUML 或其他工具格式化圖表。

它對架構決策紀錄有幫助嗎？

是。它包含 ADR 結構，涵蓋脈絡、決策、替代方案、後果、風險與推出規劃。

誰應該審查輸出內容？

技術主管、系統負責人、安全性審查人員、營運團隊與產品利害關係人應審查相關章節。

我應該提供哪些資訊？

提供元件、資料儲存、整合、部署詳細資訊、限制、已知風險，以及文件的目標讀者。

開發者詳細資訊

作者

授權

MIT

Skillstore 修訂

r1

版本提示

作者未聲明版本。

儲存庫

https://github.com/CuriousLearner/devkit/tree/main/skills/architecture-documenter

引用

d11af420e07cd866fe39cfa937efef3223896c06

維護新鮮度

2026/7/18

使用量

5 次下載 · 377 次瀏覽

檔案結構

CuriousLearner 的更多技能

dead-code-detector

清理前找出死碼

未使用的程式碼會拖慢審查並增加維護風險。此技能可協助 Claude、Codex 和 Claude Code 識別移除候選項，並提供審查指引。

程式開發查看

code-reviewer

審查程式碼品質與安全性

當審查者時間不足時，程式碼審查可能會遺漏安全性、測試與可維護性問題。此技能會引導 Claude、Codex 和 Claude Code 進行結構化審查，並產出按優先順序排列的發現項目。

程式開發查看

dependency-updater

安全地稽核相依套件更新

相依套件更新可能隱藏重大變更與緊急安全需求。此技能會檢閱專案 manifest、摘要更新風險，並建議安全升級的順序。

DevOps 與基礎設施查看

refactor-assistant

透過結構化指引安全地重構程式碼

當變更範圍很廣或說明不清時，重構可能會引入錯誤。此技能可協助 Claude、Codex 和 Claude Code 規劃並套用更安全的漸進式改善。

程式開發查看

performance-profiler

分析應用程式效能瓶頸

緩慢的程式碼可能隱藏在演算法、渲染、資料庫查詢和 bundles 之中。此技能會檢視原始碼模式，並產出依優先順序排列的最佳化建議。

程式開發查看

log-analyzer

更快速地分析應用程式日誌

日誌檔案中隱藏著服務故障、錯誤激增和緩慢請求。此技能會將原始日誌轉換為結構化發現、時間軸和實用的修復建議。

DevOps 與基礎設施查看

arch-view

視覺化服務架構

由 AstraBit-CPT

當中繼資料分散在多個儲存庫中時，分散式服務很難理解。此技能會彙整目錄中繼資料，並建立圖表、表格與摘要，以供架構審查使用。

architecture-decision-record

建立架構決策紀錄

由 ArieGoldkin

團隊成員流動後，架構決策很難被保存下來。此技能提供範本、範例與審查檢查項目，協助撰寫清晰的 ADR。

project-planner

使用結構化文件規劃軟體專案

由 Dwsy

當需求、設計選擇和任務不清楚時，軟體專案往往會失敗。此技能會將專案想法轉化為適用於 Claude、Codex 和 Claude Code 工作流程的結構化規劃文件。

github-release-assistant

產生雙語 GitHub 發行版 README

由 ZhanlinCui

當團隊需要英文與中文 README 時，發行文件的撰寫會很耗時。此技能會根據儲存庫中繼資料與引導式設定產生結構化的雙語 README。

human-docs

建立適合人類閱讀的 AI 文件

由 Brownbull

詳細的 AI 脈絡檔案通常太長，不便快速人工審閱。這項技能會將它們轉換為摘要、快速入門指南和 Mermaid 視覺指南。

skill-creation-guide

建立有效的 AI 技能

由 notedit

團隊需要可重複使用的指引，以建立實用的 AI 技能，同時避免加入不必要的上下文。此技能提供一套結構化流程，用於規劃、撰寫、驗證與封裝技能。