开发与工程

官方文档驱动开发

让框架与库的实现决策基于当前官方文档,而不是过时记忆。

51/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 107k
最近更新
13 天前
License
MIT
official-documentationframework-verificationsource-citationversion-awareness
+1api-correctness

这个 Skill 能做什么,适合哪些场景?

这是 addyosmani/agent-skills 仓库中的一个独立工程技能,专注于需要版本准确性和权威依据的框架或库代码。它要求代理先识别项目依赖及其版本,再获取相关官方文档,按照文档实现并提供来源引用。对于无法验证的模式,技能要求明确标注;对于文档与现有代码冲突的情况,要求向用户说明。它适合重视正确性和可追溯性的开发工作,不适合明确优先追求速度的简单任务。

指导代理读取 package.json、composer.json、requirements.txt、pyproject.toml、go.mod、Cargo.toml 或 Gemfile 等依赖文件,识别框架和库版本;获取具体功能对应的官方文档;依据文档中的 API 签名、推荐模式和迁移说明编写代码;为框架相关决策提供完整 URL 引用;标记无法验证的模式,并向用户报告文档与现有代码之间的冲突。

适合
  • 前端开发者使用 React、Vue、Angular 或 Svelte 的特定版本构建表单、路由或数据获取功能时,需要避免采用过时 API。
  • 后端开发者实现 Django、Flask、Laravel 或 Symfony 功能时,需要先确认当前版本的官方推荐方式。
  • 团队创建会被复制到多个项目中的脚手架、样板代码或框架模式时,需要让每项决策可追溯。
  • 维护者审查或改进包含框架特定代码的现有实现时,需要核对弃用信息和迁移建议。
  • 用户明确要求经过文档验证、遵循当前最佳实践的实现时,需要提供可检查的官方来源。

如何安装这个 Skill?

使用前请注意
  • 该评估仅基于源文件,未执行流程、抓取文档或验证生成代码。
  • 使用技能时应确认依赖版本、官方文档页面的可访问性及其与项目实际版本的一致性。
  • 官方文档引用不等于代码已测试;仍需项目测试、兼容性检查和安全审查。
开始前你需要
Agent 需要具备
  • 网络访问
  • 本地文件系统

使用 skills CLI 安装该独立技能:

npx skills add addyosmani/agent-skills --skill source-driven-development

仓库也支持安装完整的 24 个技能集合:

npx skills add addyosmani/agent-skills

README 未说明该单个技能在每种代理中的具体安装目录。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/addyosmani/agent-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/source-driven-development" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

在支持该技能的代理中处理框架或库相关开发任务时触发它。例如:

请使用 source-driven-development,先检查项目依赖版本,查找该版本对应的官方表单文档,按文档实现,并为每项框架相关决策提供完整 URL 引用。

当任务不依赖特定版本、只需修正拼写或用户明确要求优先速度时,不应使用它。

这个 Skill 有哪些优点和局限?

优点
  • 强制先确认依赖版本,降低使用过时 API 的风险。
  • 要求引用具体官方文档,便于用户核查实现依据。
  • 明确处理弃用信息、迁移指导、文档冲突和无法验证的模式。
  • 提供 DETECT、FETCH、IMPLEMENT、CITE 的清晰工作流程和验证清单。
局限
  • 依赖代理能够读取项目依赖文件并访问相关官方文档。
  • 技能本身不提供具体框架文档、测试脚本或自动化工具。
  • 会增加需要查阅文档和整理引用的工作量。
  • 不适合用户明确要求快速完成,或任务与特定框架版本无关的场景。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
官方文档驱动开发 本页 51 · 谨慎使用 ★ 107k 13 天前 MIT
Effect JSDoc 规范撰写技能 77 · 高度推荐 ★ 28k 12 天前 MIT
OpenAI 开发文档助手 ✓ OpenAI · 官方 55 · 谨慎使用 ★ 28k 4 个月前 —
step.parts 标准件检索技能 55 · 谨慎使用 ★ 20k 15 天前 MIT
NVIDIA DOCA 公共知识地图 ✓ NVIDIA · 官方 54 · 谨慎使用 ★ 3.6k 12 天前 Apache-2.0

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
51/ 100 五分制 2.6 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全16 / 25 · 3.2/5

技能要求使用官方文档、明确版本并向用户展示来源;在版本冲突时要求用户选择,降低误用风险。未规定敏感数据处理、权限边界、外部请求的数据流、回滚或依赖安全,因此扣分。

2可靠稳定8 / 20 · 2.0/5

流程 DETECT→FETCH→IMPLEMENT→CITE 一致,包含版本缺失、文档冲突和未验证模式的处理。未提供可执行脚本、异常输入测试或详细失败反馈,且静态审查无法复现关键路径,因此限制为8分。

3适用触发9 / 15 · 3.0/5

触发场景和不适用场景较清楚,覆盖框架特定实现、审查和版本相关正确性。范围仍较宽,未说明中文交互或中国大陆网络可达性;核心流程依赖在线官方文档,故扣分。

4规范维护8 / 15 · 2.7/5

文档结构清晰,包含概览、触发条件、分步流程、反合理化、红旗和验证清单;仓库上下文提供 MIT 许可、维护者和 CI。技能自身没有版本、变更记录、安装说明、维护责任或故障排查路径,故扣分。

5有效结果6 / 15 · 2.0/5

对于需要当前框架模式和可审计引用的代码任务,流程能直接改善决策透明度并减少过时 API。没有代表性产出、实际运行验证或与手工查阅的成本收益证据,且输出仍需用户审阅,因此按静态上限评为6分。

6证据核验4 / 10 · 2.0/5

技能定义了官方来源层级、深链接、引用规则和未验证声明,具备一定可审计性。提供的 CI 主要验证仓库结构和通用评估,未显示覆盖该技能关键路径的测试或第三方复核,因此扣分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 2fbfa004a019 评估证据[1][2][3][4][5]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能是否只适用于某一个框架?
不是。它面向任何需要版本准确性的框架或库,但要求先识别实际版本并查找对应的官方文档。
它会自动运行测试吗?
SKILL.md 没有规定运行测试命令;它主要负责版本识别、官方文档核验、实现依据和来源引用。
如果官方文档没有覆盖某个模式怎么办?
应明确将该模式标记为未验证,而不是把训练记忆当作可靠依据。
什么时候不应该使用它?
当正确性不依赖特定版本,或用户明确要求优先速度时,不应使用。

同仓库的其他 Skills

均来自 addyosmani/agent-skills

开发与工程

架构决策与工程文档助手

帮助工程团队记录决策依据、维护文档并保留长期代码上下文。

★ 107k FS 53 谨慎使用 13 天前
开发与工程

规划与任务拆解

将明确需求拆分为有依赖顺序、可实现且可验证的工程任务。

★ 107k FS 54 谨慎使用 13 天前
开发与工程

怀疑驱动开发

在非平凡决策落地前,用新上下文主动寻找错误。

★ 107k FS 52 谨慎使用 13 天前
开发与工程

增量实现

用可验证的小步迭代安全交付多文件工程变更。

★ 107k FS 52 谨慎使用 13 天前
开发与工程

稳定接口设计指南

帮助工程团队设计稳定、清晰且难以误用的 API 与模块接口。

★ 107k FS 50 谨慎使用 13 天前
开发与工程

上下文工程指南

帮助编码代理在正确时间获取正确项目上下文,减少臆测并保持开发规范一致。

★ 107k FS 49 谨慎使用 13 天前
开发与工程

工程技能导航器

根据任务阶段发现并调用合适的工程工作流技能。

★ 107k FS 46 谨慎使用 13 天前
开发与工程

浏览器 DevTools 测试

用真实浏览器运行数据验证、调试并测试网页应用。

★ 107k FS 59 推荐 13 天前
开发与工程

需求访谈助手

在规划或编码前,通过逐题访谈确认用户真正想解决的问题。

★ 107k FS 59 推荐 13 天前
开发与工程

测试驱动开发工作流

用可执行的测试先证明需求,再以最小改动实现、重构并验证行为。

★ 107k FS 57 谨慎使用 13 天前
开发与工程

代码简化审查

在不改变行为的前提下,降低代码复杂度并提升可读性与可维护性。

★ 107k FS 57 谨慎使用 13 天前
开发与工程

规范驱动开发

在编码前把模糊需求转化为可验证的开发规范。

★ 107k FS 55 谨慎使用 13 天前
开发与工程

Git 协作与版本发布规范

用可审查、可回滚的 Git 流程管理代码变更与版本发布。

★ 107k FS 54 谨慎使用 13 天前
开发与工程

性能优化工程技能

通过测量、定位和验证,系统解决前端、后端、查询与数据库性能瓶颈。

★ 107k FS 54 谨慎使用 13 天前
设计与前端

生产级前端界面工程

帮助 AI 编码代理构建可访问、响应式且符合设计系统的生产级用户界面。

★ 107k FS 53 谨慎使用 13 天前
自动化与运维

生产可观测性工程

为生产代码建立日志、指标、追踪与告警,让系统行为可见且便于诊断。

★ 107k FS 53 谨慎使用 13 天前
自动化与运维

安全加固工程技能

帮助编码代理在处理不可信输入、身份验证、敏感数据和外部服务时建立系统化安全防线。

★ 107k FS 52 谨慎使用 13 天前
开发与工程

Idea Refine 创意打磨

把模糊想法转化为经过验证、可执行的产品方向。

★ 107k FS 51 谨慎使用 13 天前
开发与工程

合并前代码质量审查

在合并前从正确性、可读性、架构、安全性和性能五个维度审查代码变更。

★ 107k FS 49 谨慎使用 13 天前
开发与工程

系统化调试与错误恢复

用结构化流程定位根因,修复错误并防止复发。

★ 107k FS 49 谨慎使用 13 天前

相关 Skills