技能 architecture-documenter

📦

architecture-documenter

内容修订 r1 安全 ⚙️ 外部命令🌐 网络访问🔑 环境变量

清晰记录软件架构

团队经常会丢失系统设计和技术决策的上下文。此技能可创建结构化架构文档、ADR、图表和评审指导。

支持: Claude Codex Code(CC)

使用我的智能体安装

将此请求复制给你的智能体，其中包含权威 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 或其他工具格式化图表。

它对 Architecture Decision Records 有用吗？

是的。它包含 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

安全审计依赖项更新

依赖项更新可能隐藏破坏性变更和紧急安全问题。此技能会审查项目清单，汇总更新风险，并推荐安全升级顺序。

DevOps 与基础设施查看

refactor-assistant

使用结构化指导安全地重构代码

当变更范围较广或说明不清时，重构可能会引入 bug。此技能帮助 Claude、Codex 和 Claude Code 规划并应用更安全的渐进式改进。

编码与开发查看

performance-profiler

剖析应用程序性能瓶颈

慢代码可能隐藏在算法、渲染、数据库查询和包中。此技能会审查源代码模式，并生成按优先级排序的优化指导。

编码与开发查看

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 技能，同时避免添加不必要的上下文。此技能提供了一个结构化流程，用于规划、编写、验证和打包技能。