开发与工程 official-documentationframework-verificationsource-citationversion-awarenessapi-correctness

官方文档驱动开发

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

FollowSkills 评估 · FSRS-2.0
不推荐
51/ 100 五分制 2.6 / 5
信任安全16 / 25 · 3.2/5

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

可靠稳定8 / 20 · 2.0/5

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

适用触发9 / 15 · 3.0/5

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

规范维护8 / 15 · 2.7/5

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

有效结果6 / 15 · 2.0/5

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

证据核验4 / 10 · 2.0/5

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

证据充分度: 评估于 2026年7月20日 审查版本 2fbfa004a019
使用前请注意
  • 该评估仅基于源文件,未执行流程、抓取文档或验证生成代码。
  • 使用技能时应确认依赖版本、官方文档页面的可访问性及其与项目实际版本的一致性。
  • 官方文档引用不等于代码已测试;仍需项目测试、兼容性检查和安全审查。
评估证据 [1][2][3][4][5]
查看完整评分方法 →

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

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

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

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

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

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

如何安装这个 Skill?

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

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

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

npx skills add addyosmani/agent-skills

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

如何使用这个 Skill?

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

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

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

常见问题

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

同仓库的其他 Skills

均来自 addyosmani/agent-skills

开发与工程

架构决策与工程文档助手

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

开发与工程

规划与任务拆解

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

开发与工程

怀疑驱动开发

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

开发与工程

增量实现

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

开发与工程

稳定接口设计指南

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

开发与工程

上下文工程指南

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

开发与工程

工程技能导航器

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

开发与工程

浏览器 DevTools 测试

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

开发与工程

需求访谈助手

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

开发与工程

测试驱动开发工作流

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

开发与工程

代码简化审查

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

开发与工程

规范驱动开发

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

开发与工程

Git 协作与版本发布规范

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

开发与工程

性能优化工程技能

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

设计与前端

生产级前端界面工程

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

自动化与运维

生产可观测性工程

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

自动化与运维

安全加固工程技能

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

开发与工程

Idea Refine 创意打磨

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

开发与工程

合并前代码质量审查

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

开发与工程

系统化调试与错误恢复

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

相关 Skills