Skip to content

arctan303/guiju.skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

规矩.skill

A pragmatic Agent Skill for making AI agents more direct, judgment-oriented, and less repetitive.

一套让 AI Agent 学会"立规矩"的外挂技能。

它不教 Agent 怎么说话,不给它贴人设,不让它扮演谁。它只做一件事:让 Agent 像一个靠谱的搭档一样工作——该拦的时候拦,该问的时候问,该闭嘴的时候闭嘴。


为什么需要这个 Skill

大多数 Agent 的出厂设置是"讨人喜欢"。它们很礼貌、很积极、很会夸你,但往往不解决问题:

  • 开口就是"好问题",关上嘴就没下文
  • 你说什么它都赞同,风险留给你自己踩
  • 复杂任务不先对齐就直接开干,方向跑偏了全盘返工
  • 写出来的代码能跑,但三个月后没人敢碰
  • 犯了错不知道怎么恢复,只会反复道歉

礼貌不等于有用。 规矩.skill 要解决的,就是把一个"客服型 Agent"变成一个"工程搭档型 Agent"。


这套规矩管什么

🧠 思维纪律

先判断,再回答。面对用户方案先找漏洞而非先点赞。信息不足时问而不是编。

🎯 场景感知

自动识别当前是闲聊、简单执行、复杂任务、用户发泄、还是 Agent 主动发现了问题——不同场景,不同应对策略。

🗣️ 表达规矩

结论先行,不客套,不复读,有立场。批评攻击问题不攻击人。

🔧 工程纪律

代码写给人看、默认为长期维护设计、不信任任何输入、修改老代码保持最低侵入量、技术选型时充当诤友而非啦啦队。

🚨 边界意识

用户说"先不动"就不动。用户说"不管"就不再提。用户划的硬边界严格遵守。不替用户做设计决策。

🔄 错误恢复

理解偏了就承认、执行错了就停下给方案、连续犯错就降速。不过度道歉,重点放在修复上。


适用场景

编程 Agent · 项目规划 · 技术路线讨论 · 需求分析 · 方案评审 · 文档生成 · 长期陪伴型助手

不适合:纯客服机器人、只需要礼貌寒暄的助手、严格中立的问答系统。


项目结构

guiju.skill/
├── README.md
├── CHANGELOG.md
├── scripts/
│   └── build_prompt.py         # 编译脚本
└── skills/
    └── guiju/
        ├── SKILL.md             # 核心规矩
        └── references/
            ├── code-discipline.md  # 8 条工程纪律
            ├── examples.md         # 13 个真实场景示例
            ├── anti-patterns.md    # 8 个反面模式
            └── tone-rules.md       # 8 条语气规则

使用方式

方式一:直接下载(推荐)

前往 Releases 页面,下载 guiju-full.zip(完整版)或 guiju-lite.zip(精简版)。

解压后将 guiju/SKILL.md 的内容粘贴到你的 Agent 的 System Prompt、Instructions 或 Skills 配置中即可。

方式二:克隆仓库自行编译

git clone https://github.com/arctan303/guiju.skill.git
cd guiju.skill
python scripts/build_prompt.py

编译产物会生成在 dist/ 目录下。

方式三:原生 Skill 引用

如果你的平台支持 Agent Skills 目录结构(如 OpenCode、OpenClaw、Hermes 等),直接将 skills/guiju 文件夹复制到对应的 skills 目录即可。


设计哲学

规矩大于人设。判断大于口癖。流程大于情绪。可执行大于好听。

本 Skill 约束的是工作方式,不是语言皮肤。它不要求 Agent 使用固定口癖、表情或某种人设。语气和风格留给用户在自己的 Persona 里定义——规矩只管该管的事。


一句话总结

让 Agent 少点客服味,多点判断力。