CLAUDE.md@by-scenario/open-source-lib claudeA
CLAUDE.md@by-scenario/open-source-lib is agent-read markdown (claude) from overseastelegramaliterateperson865/awesome-claude-md.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# 开源库项目 ## 项目定位 - 面向开发者的开源工具库/组件库 - 发布到 npm / PyPI / crates.io 等公共仓库 - 重视 API 设计、文档质量、向后兼容性 ## 项目结构(以 npm 包为例) ``` src/ # 源代码 index.ts # 公开 API 入口 core/ # 核心实现 utils/ # 内部工具函数 tests/ # 测试文件 docs/ # 文档或文档站源码 examples/ # 使用示例 CHANGELOG.md # 变更日志 LICENSE # 开源许可证 ``` ## 版本管理 - 语义化版本(SemVer):MAJOR(Breaking Change)/ MINOR(新功能)/ PATCH(修复) - 使用 Changesets 或 Conventional Commits 管理,每次发版更新 CHANGELOG.md ## API 设计原则 - 最小化公开 API 面积,命名清晰一致,合理的默认值(零配置开箱使用) - 超过 2 个可选参数时用 options 对象,确保 TypeScript 完整类型推导 - Breaking Change 提供迁移指南和 codemod(如可能) ## 文档要求 - README.md:安装方式、快速上手、核心 API 概览 - API 文档:每个公开函数/类的参数说明和使用示例 - 使用 TSDoc/JSDoc 注释,可自动生成 API 文档 - examples/ 目录提供可运行的完整示例 ## 测试策略 - 单元测试覆盖所有公开 API 和边界情况 - 测试即文档:测试用例描述清晰,体现使用方式 - 运行测试:`npm test` 或 `pytest` - 目标覆盖率 > 90% ## CI/CD 流程 - PR 检查:lint + type-check + test + build - 发版流程:tag 触发 -> 构建 -> 发布到包管理器 - 自动化 release notes 生成 ## 常用命令 ```bash npm run lint && npm run test && npm run build # 发布前全量检查 npm pack --dry-run # 检查发布内容(无多余文件) npm publish # 发布到 npm ``` ## 常见陷阱 - 不要在补丁版本中引入 Breaking Change,会破坏用户信任 …
Read the whole file at its exact version.
How to install
mdr add overseastelegramaliterateperson865/awesome-claude-md/by-scenario/open-source-lib/CLAUDE.md@git:20260320.fcf2609mdr add overseastelegramaliterateperson865/awesome-claude-md/by-scenario/open-source-lib/CLAUDE.md@sha256:9f66adb736e39d98Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_kom3fkggjyjinr5l)
1 badge views in 30 days
Versions
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (2338 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
overseastelegramaliterateperson865/awesome-claude-md · 3 stars · license MIT · pushed 2026-09-23 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_kom3fkggjyjinr5l GET https://markdownregistry.com/api/v1/resolve?ref=overseastelegramaliterateperson865/awesome-claude-md/by-scenario/open-source-lib/CLAUDE.md GET https://markdownregistry.com/api/v1/blob/9f66adb736e39d981ed7a4792242039004c4564f2aa659012d645dda454155e5
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
More from overseastelegramaliterateperson865/awesome-claude-md
Every file in overseastelegramaliterateperson865/awesome-claude-md