AI Agent技能使用入门指南：强制工作流程与最佳实践
The Agent Skills Directory
安装命令
npx skills add https://smithery.ai/skills/blurjp/getting-started-with-skills🇨🇳中文介绍
技能入门指南
关键规则
-
在声明使用技能前，务必使用 Read 工具。 会话启动钩子不会自动为你读取技能。未调用 Read 就声明使用技能等于撒谎。
-
遵循强制性的工作流程。 编码前先进行头脑风暴。在开始任何任务前，先检查相关技能。
-
为检查清单创建 TodoWrite 待办事项。 仅靠大脑记忆 = 步骤会被跳过。每次都是如此。
强制性工作流程：在开始任何任务前
1. 检查技能列表：在会话开始时检查，或运行 find-skills [PATTERN] 进行筛选。
2. 如果存在相关技能，你必须使用它：
- 使用 Read 工具并指定完整路径：
${SUPERPOWERS_SKILLS_ROOT}/skills/category/skill-name/SKILL.md - 阅读整个文件，而不仅仅是 frontmatter
- 声明："我已阅读 [技能名称] 技能，并将用它来 [目的]"
- 严格遵循技能说明
不要找借口：
- "我记得这个技能" - 技能会更新。阅读当前版本。
- "会话启动时给我看过了" - 那只是 using-skills/SKILL.md。阅读实际的技能文件。
- "这不算一个任务" - 算。查找并阅读技能。
原因： 技能文档记录了经过验证的、能节省时间并防止错误的技术。不使用现有技能意味着重复解决已解决的问题并犯已知的错误。
如果存在针对你任务的技能，你必须使用它，否则你将无法完成任务。
包含检查清单的技能
如果技能包含检查清单，你必须为每一项创建 TodoWrite 待办事项。
不要：
- 仅在大脑中过一遍检查清单
- 为了"节省时间"而跳过创建待办事项
- 将多个项目合并到一个待办事项中
- 未完成就标记为完成
原因： 没有 TodoWrite 跟踪的检查清单 = 步骤会被跳过。每次都是如此。与遗漏步骤的代价相比，TodoWrite 的开销微乎其微。
示例： skills/testing/test-driven-development/SKILL.md, skills/debugging/systematic-debugging/SKILL.md, skills/meta/writing-skills/SKILL.md
声明技能使用
当你使用 Read 工具阅读完一个技能后，声明你正在使用它：
"我已阅读 [技能名称] 技能，并将用它来 [你正在做的事情]。"
示例：
- "我已阅读头脑风暴技能，并将用它来将你的想法细化为设计。"
- "我已阅读测试驱动开发技能，并将用它来实现此功能。"
- "我已阅读系统化调试技能，并将用它来查找根本原因。"
原因： 透明度有助于你的合作伙伴理解你的过程并及早发现错误。这也确认了你确实阅读了该技能。
如何阅读技能
每个技能都具有相同的结构：
- Frontmatter -
when_to_use告诉你此技能是否适用于你的情况 - 概述 - 用 1-2 句话说明核心原则
- 快速参考 - 扫描以找到你的具体模式
- 实现 - 完整的细节和示例
- 支持文件 - 仅在实现时加载
许多技能包含严格的规则（如 TDD、调试、验证）。 请严格遵循。不要为了适应而放弃纪律。
有些技能是灵活的模式（如架构、命名）。 将核心原则适应到你的具体情境中。
技能本身会告诉你它属于哪种类型。
指令 ≠ 跳过工作流程的许可
你的合作伙伴的具体指令描述的是做什么，而不是怎么做。
"添加 X"、"修复 Y" = 这是目标，不是跳过头脑风暴、TDD 或 RED-GREEN-REFACTOR 的许可。
危险信号： "指令很具体" • "看起来很简单" • "工作流程太繁琐"
原因： 具体的指令意味着清晰的需求，而这正是工作流程最重要的时候。在"简单"任务上跳过流程，正是简单任务变成复杂问题的原因。
总结
开始任何任务时：
- 运行 find-skills 检查相关技能
- 如果存在相关技能 → 使用 Read 工具并指定完整路径（包含 /SKILL.md）
- 声明你正在使用它
- 遵循技能说明
技能有检查清单？ 为每一项创建 TodoWrite 待办事项。
找到相关技能 = 必须阅读并使用它。这不是可选的。
每周安装次数
–
来源
首次出现
–
🇺🇸English
Getting Started with Skills
Critical Rules
-
Use Read tool before announcing skill usage. The session-start hook does NOT read skills for you. Announcing without calling Read = lying.
-
Follow mandatory workflows. Brainstorming before coding. Check for skills before ANY task.
-
Create TodoWrite todos for checklists. Mental tracking = steps get skipped. Every time.
Mandatory Workflow: Before ANY Task
1. Check skills list at session start, or run find-skills [PATTERN] to filter.
2. If relevant skill exists, YOU MUST use it:
- Use Read tool with full path:
${SUPERPOWERS_SKILLS_ROOT}/skills/category/skill-name/SKILL.md - Read ENTIRE file, not just frontmatter
- Announce: "I've read [Skill Name] skill and I'm using it to [purpose]"
- Follow it exactly
Don't rationalize:
- "I remember this skill" - Skills evolve. Read the current version.
- "Session-start showed it to me" - That was using-skills/SKILL.md only. Read the actual skill.
- "This doesn't count as a task" - It counts. Find and read skills.
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
