documentation-and-adrs
Document Decisions and Architecture Clearly
Teams lose context when important technical decisions remain in chat, code comments, or individual memory. This skill turns architectural reasoning, API guidance, project instructions, and release changes into structured documentation.
使用我的智慧代理安裝
將此請求複製給你的智慧代理，其中包含權威 Skill 頁面和清單。
Review the Skillstore skill "documentation-and-adrs" from https://skillstore.io/skills/addyosmani-documentation-and-adrs.md and its manifest at https://skillstore.io/api/skills/addyosmani-documentation-and-adrs/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.你的智慧代理仍應顯示其計畫，並依安全政策請求必要確認。
Agent 可讀資源
當 AI Agent、爬蟲或腳本需要乾淨脈絡、而不是讀取完整頁面時，請使用這些連結。
測試它
正在使用「documentation-and-adrs」。 We chose PostgreSQL over SQLite and MongoDB for a multi-user task application.
預期結果:
An ADR outline with status, context, relational data requirements, alternatives considered, the PostgreSQL decision, and operational consequences.
正在使用「documentation-and-adrs」。 Document a task creation endpoint that requires a title and returns an identifier.
預期結果:
API reference guidance covering the request fields, validation errors, authentication expectations, response details, and a short usage example.
正在使用「documentation-and-adrs」。 Create onboarding documentation for a project with a development server and test suite.
預期結果:
- A README structure covering project purpose, setup, commands, architecture, and contribution practices.
- A verification checklist for setup instructions, API documentation, known gotchas, and current agent rules.
安全審計
安全All 28 external-command detections are Markdown examples or inline command references in SKILL.md, not executable behavior. The environment-file and system-reconnaissance detections also point to documentation examples, and no prompt injection or data-exfiltration intent was found.
風險因素
⚙️ 外部命令 (28)
分享與引用此報告
分享版本化評估報告、中性徽章、嵌入卡片與引用。Skillstore 只報告證據，不判斷該 Skill 是否安全。
複製報告連結
https://skillstore.io/skills/addyosmani-documentation-and-adrs/audits/2?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown 徽章
[](https://skillstore.io/skills/addyosmani-documentation-and-adrs?utm_source=security_passport_badge)HTML 徽章
<a href="https://skillstore.io/skills/addyosmani-documentation-and-adrs?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/addyosmani-documentation-and-adrs/security.svg" alt="Skillstore security assessment" loading="lazy"></a>嵌入卡片
<iframe src="https://skillstore.io/embed/skills/addyosmani-documentation-and-adrs.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 引用
addyosmani. (2026). documentation-and-adrs security audit report (audit version 2) [Author version unspecified]. Skillstore. https://skillstore.io/skills/addyosmani-documentation-and-adrs/audits/2BibTeX 引用
@techreport{addyosmani-addyosmani-documentation-and-adrs-2026,
author = {addyosmani},
title = {documentation-and-adrs security audit report (audit version 2)},
institution = {Skillstore},
year = {2026},
number = {2},
url = {https://skillstore.io/skills/addyosmani-documentation-and-adrs/audits/2},
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: "documentation-and-adrs security audit report (audit version 2)"
version: "unspecified"
type: report
authors:
- name: "addyosmani"
date-released: "2026-09-19"
url: "https://skillstore.io/skills/addyosmani-documentation-and-adrs/audits/2"
identifiers:
- type: other
value: "skillstore:addyosmani-documentation-and-adrs:audit:2"
description: "Skillstore immutable audit report identifier"
Skillstore 評分
評分依據 證據置信度: 高你可以打造什麼
Record an architecture decision
Create an ADR that compares options, explains trade-offs, records the selected approach, and preserves consequences for future maintainers.
Document a public API
Draft consistent API documentation covering inputs, outputs, errors, authentication expectations, and representative usage guidance.
Improve project onboarding
Build a practical README, changelog structure, and agent guidance so contributors can understand setup, architecture, conventions, and recent changes.
試試這些提示
Create a concise ADR for this decision: [decision]. Include context, selected approach, two alternatives, consequences, status, and date. Use clear headings.
Review the repository context I provide and identify its ADR location, file format, numbering pattern, and headings. Then draft an ADR for [decision] that follows those conventions.
Write documentation for this public API: [API details]. Cover parameters, return values, validation, authentication, errors, and one realistic example. State unknowns instead of inventing behavior.
Design a documentation update for [project]. Propose ADRs for durable decisions, README sections for onboarding, API reference coverage, changelog entries, agent guidance, and a verification checklist. Preserve existing conventions and identify missing evidence.
最佳實務
- Provide repository conventions and factual project context before requesting documentation.
- Document the reasoning, constraints, alternatives, and consequences instead of restating implementation details.
- Review every generated command, example, link, and security statement against the current project.
避免
- Do not invent repository conventions, API behavior, commands, or architectural constraints.
- Do not create duplicate ADR numbering schemes or replace established project formats without evidence.
- Do not use documentation as a substitute for implementation, testing, access control, or operational validation.
常見問題
What does this skill create?
Can it find the correct ADR format?
Does it write files automatically?
Can it validate API behavior?
Who benefits most from this skill?
How should generated documentation be reviewed?
開發者詳細資訊
作者
addyosmani授權
MIT
Skillstore 修訂
r2
版本提示
作者未聲明版本。
引用
5d5054f8a23586f9b500fece1cb613a9dffc787b
維護新鮮度
2026/9/19
使用量
2 次下載 · 0 次瀏覽
檔案結構
📄 SKILL.md