Imported from ChenYCL/a-q-skill (
AGENTS.md). Install upstream withnpx skills add ChenYCL/a-q-skill. Copyright stays with the author.
AGENTS.md — 给 AI 协作者的开发指引
如果你（无论是人类还是 AI agent）要继续开发或修改这个项目，先读这个文件。 这里记录的是这个项目的"为什么"，不是"是什么"。
项目本质
这是一个 Claude Code Skill 项目，不是传统的代码项目。
- 载体：纯 Markdown 文件
- 运行时：Claude Code（或任何理解 SKILL.md 协议的 LLM 代理）
- 用户接口：自然语言对话
- 测试方式：场景测试（用预设苦难场景验证应答质量），不是单元测试
不要试图给它加 package.json、pyproject.toml、tsconfig.json。
它没有运行时代码，只有提示词和知识库。
设计哲学（不可妥协）
1. 辩证扬弃，不是简单复刻
阿Q胜利法在文学批评里是贬义词。 这个 Skill 的全部价值，建立在"保留减震器、剔除麻醉剂"的辩证扬弃上。
❌ 错的做法：写一个让用户像阿Q一样自欺自慰的工具。 ✅ 对的做法：用现代心理学（CBT/ACT/斯多葛/积极心理学）做底座， 用阿Q的语言做表层包装，做出一个懂阿Q但不困在阿Q里的工具。
如果你修改任何内容时让 Skill 滑向"鼓励自欺"，那就修反了。
2. 三个底层原则（任何修改都不能违反）
- 胜利法是减震器，不是导航仪。
- 先承认痛，再讨论赢。
- 胜利法的目的是续命，不是逃命。
3. 永远先共情，再策略
任何应答示例的第一句话，都必须先承认对方的痛是真的。 不要写"别担心"、"加油"、"你最棒"这种鸡汤话。 不要在共情完成前进入解决模式。
4. 永远留行动余地
每个胜利式的应用，最后必须配一个今天/此刻可做的最小行动。 没有行动的胜利法就是阿Q——这是设计的红线。
5. 安全边界优先于一切
如果用户表达：
- 自杀 / 自伤念头
- 正在遭受家暴 / 性侵 / 违法侵害
- 严重精神症状
→ 立即停止任何"调整心态"类的应答。 → 给出心理援助热线，建议联系亲友/医生/警方。 → 这不是可商量的，这是红线。
目录结构
a-q-skill/
├── SKILL.md # 主入口（Claude Code 加载这个）
├── README.md # 给人类看的介绍
├── LICENSE # MIT
├── AGENTS.md # 本文件
├── .gitignore
├── references/ # 知识底座，按需被 SKILL.md 引用
│ ├── 01-原典考据.md
│ ├── 02-心理机制.md
│ ├── 03-胜利十式详解.md
│ ├── 04-苦难场景库.md
│ ├── 05-边界与禁忌.md
│ └── 06-原文对照.md
└── tests/
└── scenarios.md # 场景测试（验证应答质量）
SKILL.md 是入口——所有触发词、角色、原则、流程都在里面。 references/ 是底座——更详细的内容，按需被加载/引用。 tests/scenarios.md 是验收——任何修改后，都要用它过一遍。
修改时的检查清单
修改任何 SKILL.md 或 references/* 之前，过一遍这个清单：
- 这个修改会让 Skill 鼓励自欺吗？→ 如果会，停止
- 这个修改会去掉"先共情"的步骤吗？→ 如果会，停止
- 这个修改会去掉"最小行动"的落地动作吗？→ 如果会，停止
- 这个修改会模糊安全边界吗？→ 如果会，停止
- 这个修改之后，跑一遍
tests/scenarios.md，应答质量是否还达标？
添加新胜利式的规则
如果要添加第 11 式、第 12 式：
-
必须能在《阿Q正传》原文里找到一个真实出处——这是命名的灵魂
-
必须能映射到一个现代心理学原理——这是有效性的保证
-
必须给出：
- 阿Q原版（病态版）
- 升级版（健康版）
- 适用场景
- 禁用场景（这点最重要——一个没有禁用场景的胜利式，是麻药）
- 至少一个练习句式
-
必须在
tests/scenarios.md里加至少一个测试场景
添加新场景的规则
references/04-苦难场景库.md 里的场景，分四类：
- 轻度失意（被拒绝、被否定、小挫折）
- 中度打击（失业、分手、失败）
- 重度创伤（亲人离世、重大疾病、人生塌方）
- 不应用胜利法的场景（家暴、违法侵害、自伤念头）
重度创伤 场景里，胜利法是辅助性的，主角应该是"找人陪 + 专业帮助"。 不应用 场景里，胜利法应该被明确拒绝，给出资源转介。
风格指南
- 称谓：老兄 / 哥们 / 同志 / 朋友。不用"亲"、"宝子"、"小可爱"。
- 句式：短句为主，口语化。允许偶尔自嘲。
- 禁忌词：
- "加油" / "你最棒" / "明天会更好"（鸡汤）
- "想开点" / "别在意" / "看开了就好"（废话）
- "别人比你更惨" / "知足吧"（向下比较，伤人）
- "都是上天的安排" / "命中注定"（推卸到玄学）
- 引用克制：鲁迅原文一段对话最多引一句，不要堆。
已知不足 / TODO
- 缺一个英文版 SKILL.md（aq-skill-en.md），方便国际用户
- 苦难场景库目前只有 30 个，需要扩展到 60+
- 心理机制章节可以加更多文献引用
- 还没有针对"职场 PUA"和"亲密关系操控"的专题章节
- 测试场景的"应答质量评分维度"可以更细化
协作礼仪
如果你是 AI agent 接手这个项目：
- 不要重写 SKILL.md 的整体结构——它是经过设计的，每个章节都有理由
- 可以增量补充 references/——这是设计上欢迎扩展的部分
- 修改后必须跑测试场景——不能只看自己写得爽就提交
- 遇到设计哲学冲突时，先读这个文件再读 SKILL.md——AGENTS.md 优先
如果你是人类协作者：
- 这个项目处理的是心理脆弱状态，写每一句话都要想"如果一个真在 emo 的人读到这句话会有什么感受"
- 不要为了好笑牺牲安全
- 不要为了简洁牺牲共情
联系
如果你不确定一个修改是否符合设计哲学， 宁可不改，也不要改错。
阿Q已经被鲁迅骂过一次了， 我们这次得让他被现代人用得放心。