技能创作
- 作者仓库星标 1,017
- 作者仓库 CloudBase-MCP
- 领域
- 安全
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @TencentCloudBase · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Skill Authoring
Create and refine reusable agent skills with better trigger quality, cleaner structure, stronger behavioral guidance, and more reliable evaluation.
## When to use this skill
Use this skill when you need to:
- Create a new `SKILL.md`
- Improve an existing skill's `name` or `description`
- Review whether a skill is too broad, too narrow, or poorly structured
- Audit a local skill collection such as `config/source/skills` for redundancy, trigger overlap, or weak boundaries
- Split a large skill into `SKILL.md` plus `references/`, `assets/`, or `scripts/`
- Design evaluation prompts and review whether a skill triggers and behaves correctly
## Repo-managed CloudBase skill review
When the task targets `config/source/skills`, apply these guardrails in addition to the normal skill-authoring workflow:
This section is the repo-managed CloudBase skill review baseline for this repository.
- Keep frontmatter complete and normalized, including `version`
- Keep examples inside the skill's declared platform and scope
- Keep shared operational rules in one canonical source instead of copying large blocks across neighboring skills
- If the skill claims a rule is mandatory, show that rule in at least one example
- When giving a recommended default, also explain the tradeoff behind it
- Do not infer public CNB / OpenClaw / ClawHub paths from the source tree; verify the actual published structure before writing fallback links or marketplace-facing URLs
- If a skill mentions raw URLs, blob URLs, or marketplace-consumed paths, check live reachability before finalizing the text
- Put standalone-install fallback guidance where the user needs it: keep the top-level note short, and place sibling-skill fallback links next to the actual cross-skill reference
**Do NOT use for:**
- General documentation writing that is not about skills
- README polish or marketing copy
- Prompt tweaks that do not affect skill structure or behavior
- Rule files unrelated to `SKILL.md`
## How to use this skill (for a coding agent)
1. **Identify the task class first**
- Determine whether the request is about creating a new skill, reviewing an existing skill, or improving trigger quality, structure, or evaluation
2. **Optimize the trigger surface early**
- Draft `name` and especially `description` before expanding the body
- Put realistic trigger language into `description`, not only into the body
3. **Design behavior, not just documentation**
- Make the main `SKILL.md` tell the agent what to do after the skill triggers
- Use references for deeper guidance, not as a substitute for behavioral rules
4. **Load supporting materials only when needed**
- Use the routing table to decide which reference file to read
- Avoid loading every reference file by default
5. **Use collection-level review when the request is about many skills**
- When reviewing `config/source/skills`, check overlap, duplication, trigger boundaries, and progressive disclosure across neighboring skills
- Prefer evidence-based findings with concrete file references and rewrite guidance
- Treat source layout, published skills-repo layout, and marketplace-consumed layout as different surfaces until you verify they are the same
6. **Evaluate before considering the skill complete**
- Create should-trigger and should-not-trigger prompts
- Run them, review the results, and iterate on the skill
## Routing
| Task | Read |
| --- | --- |
| Write or improve `name` and `description` | `references/frontmatter-patterns.md` |
| Design skill anatomy and progressive disclosure | `references/structure-patterns.md` |
| Draft a new skill or review an existing one | `references/templates.md` |
| Audit `config/source/skills` for quality, redundancy, and overlap | `references/repo-skill-review.md` |
| Review repo-managed CloudBase source skills | `references/cloudbase-skill-review.md` |
| Build evaluation prompts and review outcomes | `references/evaluation.md` |
| Compare good examples, weak examples, and rewrites | `references/examples.md` |
## Quick workflow
1. Identify the skill's job, boundary, and closest neighboring skills.
2. Draft `name` and `description` with realistic trigger language.
3. If the task targets `config/source/skills`, read `references/repo-skill-review.md`, then load `references/cloudbase-skill-review.md` for CloudBase-specific standards before proposing rewrites.
4. If the skill text will mention published URLs or fallback paths, verify the public structure and at least one real URL before writing.
5. Write the main `SKILL.md` so it changes agent behavior after trigger.
6. Move deep detail into `references/`, `assets/`, or `scripts/` as needed.
7. Run evaluation prompts and revise until trigger quality and behavior are stable.
## Minimum self-check
- Is the `name` short, intentional, and stable?
- Does the `description` explain both capability and trigger conditions?
- Does the main `SKILL.md` change agent behavior after trigger?
- Are non-applicable scenarios explicit?
- Does routing point to the right reference file for each task?
- If the skill references public URLs or standalone-install fallback paths, were those URLs verified against the actual published surface instead of guessed from local directories?
- Are evaluation prompts present for both should-trigger and should-not-trigger cases?
- Can you explain why this skill stays distinct from its nearest neighbors?
- If reviewing a skill collection, can you point to redundancy, overlap, and missing boundaries with concrete evidence?
章节与文件索引
按说明文件中的顺序排列。
何时使用该技能
回购管理的 CloudBase 技能审查
如何使用此技能(针对编码代理)
路由
快速的工作流程
文件/命令 -> name · description · config/source/skills · references/ · assets/ · scripts/ · version · references/frontmatter-patterns.md
内容校验值 -> a3a07a90a9f0
当前原文的自动摘译,尚未人工审校。
何时使用该技能
当您需要执行以下操作时,请使用此技能: 创建新的
SKILL.md改进现有技能的name或description检查技能是否太宽泛、太窄或结构不良 审核本地技能集合(例如config/source/skills)是否有冗余、触发重叠或边界薄弱回购管理的 CloudBase 技能审查
当任务目标为
config/source/skills时,除了正常的技能创作工作流程之外,还应应用这些护栏:此部分是此存储库的存储库管理的 CloudBase 技能审查基线。保持前题完整和规范化,包括version将示例保留在技能声明的平台和范围内 将共享的操作规则保留在一个规范源中,而不是在相邻技能之间复制大块如何使用此技能(针对编码代理)
首先确定任务类别 确定请求是关于创建新技能、审查现有技能还是改进触发质量、结构或评估 在扩展正文之前优化触发界面早期草稿
name,尤其是description将真实的触发语言放入description,而不仅仅是正文中路由
任务·阅读、写作或改进
name和description·references/frontmatter-patterns.md设计技能剖析和逐步披露·references/structure-patterns.md起草一项新技能或审查现有技能·references/templates.md审计config/source/skills质量、冗余和重叠·references/repo-skill-review.md快速的工作流程
确定技能的工作、边界和最邻近的技能。草稿
name和description具有现实的触发语言。如果任务目标为config/source/skills,请阅读references/repo-skill-review.md,然后在建议重写之前加载references/cloudbase-skill-review.md以获取CloudBase特定标准。如果技能文本将提及已发布的 URL 或后备路径,请在编写之前验证公共结构和至少一个真实 URL。