官方文档驱动开发
让框架与库的实现决策基于当前官方文档,而不是过时记忆。
技能要求使用官方文档、明确版本并向用户展示来源;在版本冲突时要求用户选择,降低误用风险。未规定敏感数据处理、权限边界、外部请求的数据流、回滚或依赖安全,因此扣分。
流程 DETECT→FETCH→IMPLEMENT→CITE 一致,包含版本缺失、文档冲突和未验证模式的处理。未提供可执行脚本、异常输入测试或详细失败反馈,且静态审查无法复现关键路径,因此限制为8分。
触发场景和不适用场景较清楚,覆盖框架特定实现、审查和版本相关正确性。范围仍较宽,未说明中文交互或中国大陆网络可达性;核心流程依赖在线官方文档,故扣分。
文档结构清晰,包含概览、触发条件、分步流程、反合理化、红旗和验证清单;仓库上下文提供 MIT 许可、维护者和 CI。技能自身没有版本、变更记录、安装说明、维护责任或故障排查路径,故扣分。
对于需要当前框架模式和可审计引用的代码任务,流程能直接改善决策透明度并减少过时 API。没有代表性产出、实际运行验证或与手工查阅的成本收益证据,且输出仍需用户审阅,因此按静态上限评为6分。
技能定义了官方来源层级、深链接、引用规则和未验证声明,具备一定可审计性。提供的 CI 主要验证仓库结构和通用评估,未显示覆盖该技能关键路径的测试或第三方复核,因此扣分。
- 该评估仅基于源文件,未执行流程、抓取文档或验证生成代码。
- 使用技能时应确认依赖版本、官方文档页面的可访问性及其与项目实际版本的一致性。
- 官方文档引用不等于代码已测试;仍需项目测试、兼容性检查和安全审查。
这个 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 有哪些优点和局限?
- 强制先确认依赖版本,降低使用过时 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 引用。
当任务不依赖特定版本、只需修正拼写或用户明确要求优先速度时,不应使用它。