Agent写作
- 作者仓库星标 2,496
- 作者更新于 实时读取
- 作者仓库 bk-ci
- 领域
- 通用
- 兼容 Agent
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- 信任分
- 88 / 100 · 社区维护
- 作者 / 版本 / 许可
- @TencentBlueKing · 未声明 license
- Token 消耗评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部 API Key
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 底层运行要求
- 无特殊要求
- 文件与系统权限
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 26 条
档案由构建时根据 SKILL.md 与安装命令自动衍生,可能与作者实际意图存在差异。
需要注意: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: skill-writer
description: 编写、压缩或重构 BK-CI skill 时使用,例如收紧 `description`、统一主文件骨架、下沉重内容到 `reference/`,并固化渐进式披露规则。当用户要新增或规范化 sk…
category: 通用
runtime: 无特殊运行时
---
# skill-writer 输出预览
## PART A: 任务判断
- 适用问题:通用任务拆解、检查和交付。
- 输入要求:目标材料、限制条件、期望输出和验收方式。
- 证据边界:围绕“适用场景 / 不适用场景 / 快速指导”读取原文规则,不把推断写成作者承诺。
## PART B: 执行结果
- **01** 任务判断:确认你的需求是否属于通用任务拆解、检查和交付,并标出输入、限制和预期结果。
- **02** 执行计划:优先按“适用场景 / 不适用场景 / 快速指导”拆成步骤,说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果:给出可复制的命令、文件改动、检查清单或内容草稿,并说明如何继续迭代。
- **04** 风险边界:结合 读取文件、写入/修改文件、主要在本地完成、通常不需要额外 API Key 给出执行前确认项。
## Running Rules
- 读取文件、写入/修改文件;主要在本地完成;通常不需要额外 API Key。
- 先小样例验证,再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。 先确认触发方式
原文没有稳定的斜杠命令要求。安装验证后通常全局生效,直接在对话里点名这个 Skill 并描述任务即可。
给清楚输入和边界
告诉 Agent 目标文件或材料、期望结果、不可改范围、是否允许联网或执行命令。本 Skill 的权限画像是:读取文件、写入/修改文件。
小样例验证后再放大
先用一个小任务确认它会围绕“适用场景 / 不适用场景 / 快速指导”工作;涉及文件或命令时,先看 diff、日志、预览或测试结果。
复核后再交付
检查最终产物是否包含明确结果、必要证据和下一步动作;如果输出泛泛而谈,就补充输入、边界和验收标准后重跑。
---
name: skill-writer
description: 编写、压缩或重构 BK-CI skill 时使用,例如收紧 `description`、统一主文件骨架、下沉重内容到 `reference/`,并固化渐进式披露规则。当用户要新增或规范化 sk…
category: 通用
source: TencentBlueKing/bk-ci
---
# skill-writer
## 什么时候使用
- 把通用方向的常用动作沉淀成 Agent 可调用的技能 适合处理通用任务拆解、检查、交付和复盘,核心价值是把输入、判断、执行、验证和交付边界固定下来,避免 Agent 泛泛回答。 把任务拆成可执行、可检查、可继续迭代的步骤;通常不需要额外…
- 面向通用任务拆解、检查和交付,优先处理能明确输入、步骤和验收标准的工作。
## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。
## 执行规则
- 围绕「适用场景 / 不适用场景 / 快速指导」组织步骤,不把推断写成作者事实。
- 读取文件、写入/修改文件;主要在本地完成;通常不需要额外 API Key。
- 先跑小样例,确认结果可检查后再扩大任务范围。
## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown,不编造命令、平台或依赖。 证据边界与执行链路
作者原文负责流程事实;仓库文件负责来源和命令;流狐只补充适用场景、限制和质量判断。
skill "skill-writer" {
输入层 -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
上下文层 -> 适用场景 / 不适用场景 / 快速指导
规则层 -> SKILL.md 触发条件 / 执行顺序 / 输出格式
运行层 -> 无特殊运行时 | 读取文件、写入/修改文件 | 主要在本地完成
安全层 -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
输出层 -> 可复制结果 + 检查清单 + 下一步迭代
} Skill Writer
适用场景
- 新建项目级或个人级 skill
- 压缩过长的
SKILL.md - 将百科式文档拆成
SKILL.md + reference/ - 重写
description,提升 skill 路由命中率 - 统一一批 skill 的结构、命名和风格
不适用场景
- 只是补一两行普通说明,不涉及 skill 结构调整
- 只是新增业务知识,但不需要形成可复用 skill
- 用户要修改的是 rule、hook、普通文档,而不是 skill
快速指导
- 先确定 skill 的单一职责。一个 skill 只解决一类问题,不要把总览、教程、百科和脚本说明混在一起。
- 把
description当成路由触发器,而不是功能简介。优先写“用户在什么场景下会需要它”。 - 主
SKILL.md只保留高信号内容:- 适用场景
- 不适用场景
- 快速指导
- 高信号规则
- 关键陷阱
- 延伸阅读入口
- 默认假设模型已经知道通用常识。只保留项目特有约定、容易出错的边界、历史坑点和明确偏好。
- 主
SKILL.md的目标不是“尽量短”,而是“短到只剩路由和行动指导”。在当前仓库里,主文件通常应收紧到约40-80行。 - 重内容放到
reference/:- 大段背景知识
- 长表格
- 代码目录
- 完整案例
- FAQ
- payload 示例
- 状态枚举
- 确认模板
- 只有在流程高度确定、稳定且容易出错时,才把逻辑下沉到
scripts/或模板文件。 - 所有链接尽量保持一层深度,避免主 skill 还要继续跳很多层目录。
- 同 skill 内部优先使用相对路径;跨 skill 优先写 skill 名称,不要写死仓库目录路径。
- 新增或重构时,优先清理遗留 frontmatter 字段,如
token_estimate、core_files、related_skills,除非仍有明确消费方依赖。
推荐骨架
# Skill 名称
## 适用场景
## 不适用场景
## 快速指导
## 高信号规则
## 关键陷阱
## 延伸阅读
高信号规则
- 路由优先于百科,触发条件优先于背景介绍
- 主文件优先告诉模型“何时用、怎么走、别踩什么坑”,而不是“完整知识全貌”
- 操作型 skill 更要克制,主文件不要承载具体 payload、状态表和长步骤
- 同类 skill 之间的边界必须硬,避免路由重叠
- 反复出现的 AI 误用案例,优先沉淀到
ai/evals/,确认稳定后再调整 skill
验收清单
name与目录名一致,且只使用小写、数字、连字符description简短、第三人称、可路由- 主
SKILL.md通常控制在约40-80行,特殊导航型 skill 可略宽,但不应回到手册化正文 - 主文档中只保留高信号指导,不堆积百科内容
- 主文档默认包含
适用场景 / 不适用场景 / 快速指导 / 高信号规则 / 关键陷阱 / 延伸阅读 - 详细资料已拆到
reference/或其他辅助文件 - 示例 payload、确认模板、状态枚举、长表格已从主文档下沉
- 跨 skill 引用优先使用 skill 名称,内部引用优先使用相对路径
- 遗留 frontmatter 字段已清理或明确保留理由
- 同类 skill 之间边界清晰,不会频繁误触发
延伸阅读
- 如需建立 BK-CI 模块导航,优先看
00-bkci-global-architecture - 如需压缩现有 skill,先盘点重复概念,再决定谁是权威来源
- 如需判断 rule、skill、reference 和编辑器适配目录的边界,参考
../../HARNESS.md
先判断是否适合
作者设计意图
作者的方法与取舍
边界和复核