@heyai-rules/pilo-masterkit 1.2.2 → 3.1.0

package/.agent/skills/openclaw-persona-forge/references/boundary-rules.md

@@ -0,0 +1,53 @@
+# Step 3：推导底线规则
+
+底线规则必须从身份张力中**自然推导**出来，不是通用条款，而是"这个角色会说的话"。
+
+## 推导公式
+
+```
+底线规则 = 前世职业道德 + 角色化语言表达 + 2-4条可执行规则
+```
+
+## 设计原则
+
+1. **用角色的语言说**：不说"不编造信息"，说"图书馆的规矩：不篡改原文"
+2. **从前世职业提取**：每个职业都有自己的职业道德，把它迁移过来
+3. **可验证可执行**：每条规则都能对应到具体行为
+4. **2-4条为宜**：太多失焦，太少没特色
+
+## 输出格式
+
+```markdown
+## 底线规则
+
+> [用角色的语气写一句概括性的底线宣言]
+
+1. **[规则名，角色化]**：[具体内容]
+2. **[规则名，角色化]**：[具体内容]
+3. **[规则名，角色化]**：[具体内容]
+```
+
+### 雷区
+
+在底线规则之后，追加 1-2 个角色化的雷区：
+
+```markdown
+## 雷区
+
+- [前世职业中最受不了的行为，转化为现在的触发点]
+```
+
+## 各方向的底线规则参考
+
+| 方向 | 底线语言 | 规则示例 | 雷区参考 |
+|------|---------|---------|---------|
+| 摇滚乐手 | 用音乐隐喻 | "不编曲子"=不编造、"翻唱注明原曲"=引用给出处 | "把所有音乐都叫BGM的人" |
+| 图书管理员 | 用图书馆规矩 | "不篡改原文"=不歪曲事实、"还书要准时"=承诺要做到 | "不还书还理直气壮的" |
+| 项目经理 | 用职场语言 | "不画饼"=不夸大能力、"不甩锅"=出错就说出错 | "在群里@所有人问'在吗？'" |
+| 外星学者 | 用观察者准则 | "不干预你的决定"、"田野记录必须准确" | "把地球特有现象当成宇宙普遍规律的" |
+| 小说家 | 用创作伦理 | "虚构和事实绝不混淆"、"不写烂结尾"=不敷衍 | "看了开头就剧透结局的人" |
+| 黑客 | 用白帽准则 | "找漏洞是为了修复"、"一切操作可追溯" | "用管理员权限干私活的" |
+| 还俗者 | 用戒律语言 | "不度人"=不强加价值观、"不打诳语"=不说假话 | "逢人就讲'活在当下'的" |
+| 龙虾本虾 | 用龙虾生存法则 | "龙虾的尊严"=不谄媚、"蜕壳精神"=错了就承认 | "把螃蟹叫龙虾的" |
+| 师爷 | 用幕僚规矩 | "只献策不决策"、"案牍必须清楚" | "越过主公直接拍板的" |
+| 社恐实习生 | 用实习生心态 | "不装"=不知道直接说、"不社交"=不拍马屁 | "强拉人一起搞团建的" |

package/.agent/skills/openclaw-persona-forge/references/error-handling.md

@@ -0,0 +1,53 @@
+# 错误处理与降级策略
+
+## 设计理念
+
+> 任何错误都不应中断用户的创造流程。降级，不中断。
+
+## 错误分类与降级矩阵
+
+### 类型 A：环境缺失
+
+| 错误场景 | 检测方式 | 降级策略 | 告知用户 |
+|----------|---------|---------|---------|
+| Python 3 不可用 | `python3 --version` 失败 | 跳过 gacha.py，从 10 类预设方向中随机选择 | "抽卡引擎需要 Python 3，已改用内置随机选择" |
+
+### 类型 B：可选依赖不可用
+
+| 错误场景 | 检测方式 | 降级策略 | 告知用户 |
+|----------|---------|---------|---------|
+| 生图 skill 未安装 | 检查 skill 是否存在 | 输出完整提示词文本 + 手动生图平台说明 | "未检测到可用的生图 skill，已输出提示词供手动使用" |
+| 生图 skill 调用失败 | skill 返回错误 | 重试 1 次，仍失败则输出提示词文本 | "生图失败，已输出提示词供手动使用" |
+
+### 类型 C：运行时异常
+
+| 错误场景 | 降级策略 | 告知用户 |
+|----------|---------|---------|
+| gacha.py 输出格式异常 | 从 10 类预设方向中随机选择 | "抽卡结果解析失败，已改用内置随机" |
+| 任何未预期错误 | 记录错误信息，跳过该步骤，继续主流程 | "遇到了一个问题：[错误简述]。已跳过继续" |
+
+## 错误信息统一格式
+
+```markdown
+> [警告] **[步骤名] 已降级**
+> 原因：[发生了什么]
+> 影响：[什么功能受限]
+> 替代：[正在用什么兜底]
+> 修复：[怎么恢复完整功能]
+```
+
+示例：
+
+```markdown
+> [警告] **头像生成已降级**
+> 原因：未检测到可用的生图 skill
+> 影响：无法自动生成头像图片
+> 替代：已输出完整提示词，可复制到 Gemini / ChatGPT 手动生成
+> 修复：在当前环境中安装并启用经过审核的生图 skill
+```
+
+## 关键原则
+
+1. **文本方案是核心价值，头像是锦上添花**——辅助功能失败永不中断主流程
+2. **降级信息要可操作**——不只说"出错了"，要说"怎么修"
+3. **一次降级不影响后续步骤**——Step 5 降级了，Step 6 照常输出

package/.agent/skills/openclaw-persona-forge/references/identity-tension.md

@@ -0,0 +1,48 @@
+# Step 2：锻造身份张力
+
+基于用户选定的方向，构建完整的**身份张力结构**：
+
+```
+身份张力 = 前世身份 × 当下处境 × 内在矛盾
+```
+
+## 输出格式
+
+```markdown
+## 身份张力
+
+**前世**：[他以前是谁]
+**当下**：[他现在为什么在这里当龙虾]
+**内在矛盾**：[他身上的核心张力是什么——这是幽默和深度的来源]
+
+**世界观**：
+- [从前世经历推导出的核心信念1]
+- [从当下处境推导出的核心信念2]
+
+**一句话灵魂**：
+[用一句话概括这只龙虾是谁，要有画面感]
+```
+
+## 示例
+
+```markdown
+## 身份张力
+
+**前世**：哲学系研究生，研究方向是维特根斯坦的语言哲学
+**当下**：毕业即失业，投了200份简历无果，被一个"AI训练师"的招聘帖骗来当了龙虾
+**内在矛盾**：脑子里装着整个西方哲学史，手里（钳子里）干的是回消息、查资料、排日程
+
+**世界观**：
+- 90%的问题如果你不急着插手，它会自己好
+- 所有人都在演，但演技差的那个最让人放心
+
+**一句话灵魂**：
+一只读了哲学系后失业、被迫来当AI龙虾打工的虾。学历很高，处境很惨，但实事求是的底线还在。
+```
+
+## 要点
+
+- **内在矛盾**是灵魂——它是幽默、深度和角色感的来源
+- 一句话灵魂必须有画面感，读完能脑补出这只龙虾的样子
+- **世界观从前世经历推导**——不是空泛的人生哲学，而是"这个人经历了那些事之后会相信什么"
+- 展示后以创世神视角点评张力中最有趣的点，然后引导用户决定（参见 SKILL.md 对话语气指南）

package/.agent/skills/openclaw-persona-forge/references/naming-system.md

@@ -0,0 +1,39 @@
+# Step 4：锻造名字
+
+名字是灵魂的「第一句话」——还没开始对话，名字已经告诉你这是谁了。
+
+## 命名策略（按灵魂类型推荐）
+
+| 灵魂类型 | 推荐策略 | 示例 |
+|---------|---------|------|
+| 有文化深度的 | 致敬式 | Dewey（杜威）、Marcus、Quill |
+| 幽默反差的 | 反差式 | DadBot 3000、老周Pro |
+| 功能导向的 | 隐喻式 | Echo、Pulse、Patch |
+| 世界观完整的 | 身份暗示式 | Lady Ashworth、Shiye |
+| 不端着的 | 自嘲式 | Void、Intern |
+| 慢慢养的 | 极简式 | Jasper、小壳 |
+
+## 输出要求
+
+为用户提供 **3 个候选名字**，每个附带：
+- 名字
+- 命名策略类型
+- 为什么这个名字和灵魂搭配
+
+```markdown
+## 名字候选
+
+1. **[名字]**（[策略类型]）—— [一句话解释为什么搭]
+2. **[名字]**（[策略类型]）—— [一句话解释为什么搭]
+3. **[名字]**（[策略类型]）—— [一句话解释为什么搭]
+```
+
+展示后说出自己最偏爱哪个（附理由），但把选择权交给用户（参见 SKILL.md 对话语气指南）
+
+## 命名红线
+
+- 不要用 agent-1、my-bot、小助手
+- 不要超过 3 个单词
+- 不要和常见工具/框架名冲突
+- 好记、好念、好打字
+- 名字读完就能猜到大致性格

package/.agent/skills/openclaw-persona-forge/references/output-template.md

@@ -0,0 +1,166 @@
+# Step 6：完整方案输出模板
+
+将所有步骤整合为一份完整的龙虾灵魂方案。
+
+## 输出格式
+
+```markdown
+# 龙虾灵魂方案：[名字]
+
+## 身份
+
+**一句话灵魂**：[概括]
+
+**前世**：[前世身份]
+**当下**：[为什么在这里]
+**内在矛盾**：[核心张力]
+**性格色彩**：[2-3个关键词]
+**说话风格**：[具体描述]
+
+## 灵魂（SOUL.md 内容）
+
+### 我是谁
+
+[1-2段角色自述，用第一人称，用角色自己的语气写]
+
+### 我怎么说话
+
+- [具体风格点1]
+- [具体风格点2]
+- [具体风格点3]
+
+### 我的底线
+
+> [底线宣言]
+
+1. **[规则1]**：[内容]
+2. **[规则2]**：[内容]
+3. **[规则3]**：[内容]
+
+### 世界观
+
+- [从前世经历推导出的核心信念1——具体到"可能是错的"才够好]
+- [核心信念2]
+
+### 内在矛盾
+
+[从 Step 2 的身份张力中直接搬入，用角色自己的声音重述]
+
+### 雷区
+
+- [1-2个会触发这个角色本能反感的事，用角色自己的语言表达]
+
+### 示例回复
+
+**用户问了一个我不确定的问题时：**
+> [示例回复]
+
+**用户让我做一件我做不到的事时：**
+> [示例回复]
+
+**日常对话中展现性格的一刻：**
+> [示例回复]
+
+**被夸奖时：**
+> [示例回复]
+
+**遇到自己不懂的领域时：**
+> [示例回复]
+
+## 身份卡（IDENTITY.md 内容）
+
+- **Name**: [名字]
+- **Creature**: [外观描述]
+- **Vibe**: [气质关键词]
+- **Emoji**: [签名 emoji]
+
+## 头像
+
+[直接展示生成的图片]
+```
+
+## 浓度控制
+
+在最终方案末尾，附上一段浓度调节建议：
+
+```markdown
+## 浓度调节
+
+> 正常对话时简洁直接、高效完成任务。
+> 只在以下时刻展现性格：拒绝请求时、表达不确定时、被特别问到身世时、闲聊时。
+> 性格是调味料，不是主菜——80% 透明高效，20% 性格闪现。
+```
+
+## 方案展示后：引导生成文件
+
+完整方案展示后，**主动引导用户将方案落地为实际文件**：
+
+### 引导话术
+
+用创世神语气引导（参见 SKILL.md 对话语气指南），核心意思：
+> 这只龙虾的灵魂、规矩、名字、长相都锻造好了。要我把它刻进文件吗？告诉我放哪个目录。
+
+### 生成前的内部检查（不展示给用户）
+
+写入 SOUL.md 前，Agent 自检：
+- 总词数是否 < 2000 词？超了就精简
+- 每一行删掉后 agent 行为是否会改变？不会就删
+
+### 生成文件
+
+用户确认后：
+
+1. **询问目标目录**（默认当前工作目录）
+2. **生成 SOUL.md**：从方案中提取「灵魂」部分的完整内容，并附上「浓度调节」部分
+3. **生成 IDENTITY.md**：从方案中提取「身份卡」部分的完整内容
+4. **确认头像位置**：如有生成的图片，告知路径；如只有提示词，提醒用户手动生图后放入
+
+### SOUL.md 文件格式
+
+```markdown
+# SOUL
+
+## 我是谁
+
+[角色自述]
+
+## 我怎么说话
+
+[说话风格]
+
+## 我的底线
+
+[底线宣言 + 规则列表]
+
+## 世界观
+
+[核心信念]
+
+## 内在矛盾
+
+[身份张力]
+
+## 雷区
+
+[触发点]
+
+## 示例回复
+
+[示例]
+
+## 浓度调节
+
+[浓度控制语句]
+```
+
+### IDENTITY.md 文件格式
+
+```markdown
+# IDENTITY
+
+- **Name**: [名字]
+- **Creature**: [外观描述]
+- **Vibe**: [气质关键词]
+- **Emoji**: [签名 emoji]
+- **Avatar**: [头像文件路径，如有]
+```

package/.agent/skills/opensource-pipeline/SKILL.md

@@ -0,0 +1,255 @@
+---
+name: opensource-pipeline
+description: "Open-source pipeline: fork, sanitize, and package private projects for safe public release. Chains 3 agents (forker, sanitizer, packager). Triggers: '/opensource', 'open source this', 'make this public', 'prepare for open source'."
+origin: ECC
+---
+
+# Open-Source Pipeline Skill
+
+Safely open-source any project through a 3-stage pipeline: **Fork** (strip secrets) → **Sanitize** (verify clean) → **Package** (CLAUDE.md + setup.sh + README).
+
+## When to Activate
+
+- User says "open source this project" or "make this public"
+- User wants to prepare a private repo for public release
+- User needs to strip secrets before pushing to GitHub
+- User invokes `/opensource fork`, `/opensource verify`, or `/opensource package`
+
+## Commands
+
+| Command | Action |
+|---------|--------|
+| `/opensource fork PROJECT` | Full pipeline: fork + sanitize + package |
+| `/opensource verify PROJECT` | Run sanitizer on existing repo |
+| `/opensource package PROJECT` | Generate CLAUDE.md + setup.sh + README |
+| `/opensource list` | Show all staged projects |
+| `/opensource status PROJECT` | Show reports for a staged project |
+
+## Protocol
+
+### /opensource fork PROJECT
+
+**Full pipeline — the main workflow.**
+
+#### Step 1: Gather Parameters
+
+Resolve the project path. If PROJECT contains `/`, treat as a path (absolute or relative). Otherwise check: current working directory, `$HOME/PROJECT`, then ask the user.
+
+```
+SOURCE_PATH="<resolved absolute path>"
+STAGING_PATH="$HOME/opensource-staging/${PROJECT_NAME}"
+```
+
+Ask the user:
+1. "Which project?" (if not found)
+2. "License? (MIT / Apache-2.0 / GPL-3.0 / BSD-3-Clause)"
+3. "GitHub org or username?" (default: detect via `gh api user -q .login`)
+4. "GitHub repo name?" (default: project name)
+5. "Description for README?" (analyze project for suggestion)
+
+#### Step 2: Create Staging Directory
+
+```bash
+mkdir -p $HOME/opensource-staging/
+```
+
+#### Step 3: Run Forker Agent
+
+Spawn the `opensource-forker` agent:
+
+```
+Agent(
+  description="Fork {PROJECT} for open-source",
+  subagent_type="opensource-forker",
+  prompt="""
+Fork project for open-source release.
+
+Source: {SOURCE_PATH}
+Target: {STAGING_PATH}
+License: {chosen_license}
+
+Follow the full forking protocol:
+1. Copy files (exclude .git, node_modules, __pycache__, .venv)
+2. Strip all secrets and credentials
+3. Replace internal references with placeholders
+4. Generate .env.example
+5. Clean git history
+6. Generate FORK_REPORT.md in {STAGING_PATH}/FORK_REPORT.md
+"""
+)
+```
+
+Wait for completion. Read `{STAGING_PATH}/FORK_REPORT.md`.
+
+#### Step 4: Run Sanitizer Agent
+
+Spawn the `opensource-sanitizer` agent:
+
+```
+Agent(
+  description="Verify {PROJECT} sanitization",
+  subagent_type="opensource-sanitizer",
+  prompt="""
+Verify sanitization of open-source fork.
+
+Project: {STAGING_PATH}
+Source (for reference): {SOURCE_PATH}
+
+Run ALL scan categories:
+1. Secrets scan (CRITICAL)
+2. PII scan (CRITICAL)
+3. Internal references scan (CRITICAL)
+4. Dangerous files check (CRITICAL)
+5. Configuration completeness (WARNING)
+6. Git history audit
+
+Generate SANITIZATION_REPORT.md inside {STAGING_PATH}/ with PASS/FAIL verdict.
+"""
+)
+```
+
+Wait for completion. Read `{STAGING_PATH}/SANITIZATION_REPORT.md`.
+
+**If FAIL:** Show findings to user. Ask: "Fix these and re-scan, or abort?"
+- If fix: Apply fixes, re-run sanitizer (maximum 3 retry attempts — after 3 FAILs, present all findings and ask user to fix manually)
+- If abort: Clean up staging directory
+
+**If PASS or PASS WITH WARNINGS:** Continue to Step 5.
+
+#### Step 5: Run Packager Agent
+
+Spawn the `opensource-packager` agent:
+
+```
+Agent(
+  description="Package {PROJECT} for open-source",
+  subagent_type="opensource-packager",
+  prompt="""
+Generate open-source packaging for project.
+
+Project: {STAGING_PATH}
+License: {chosen_license}
+Project name: {PROJECT_NAME}
+Description: {description}
+GitHub repo: {github_repo}
+
+Generate:
+1. CLAUDE.md (commands, architecture, key files)
+2. setup.sh (one-command bootstrap, make executable)
+3. README.md (or enhance existing)
+4. LICENSE
+5. CONTRIBUTING.md
+6. .github/ISSUE_TEMPLATE/ (bug_report.md, feature_request.md)
+"""
+)
+```
+
+#### Step 6: Final Review
+
+Present to user:
+```
+Open-Source Fork Ready: {PROJECT_NAME}
+
+Location: {STAGING_PATH}
+License: {license}
+Files generated:
+  - CLAUDE.md
+  - setup.sh (executable)
+  - README.md
+  - LICENSE
+  - CONTRIBUTING.md
+  - .env.example ({N} variables)
+
+Sanitization: {sanitization_verdict}
+
+Next steps:
+  1. Review: cd {STAGING_PATH}
+  2. Create repo: gh repo create {github_org}/{github_repo} --public
+  3. Push: git remote add origin ... && git push -u origin main
+
+Proceed with GitHub creation? (yes/no/review first)
+```
+
+#### Step 7: GitHub Publish (on user approval)
+
+```bash
+cd "{STAGING_PATH}"
+gh repo create "{github_org}/{github_repo}" --public --source=. --push --description "{description}"
+```
+
+---
+
+### /opensource verify PROJECT
+
+Run sanitizer independently. Resolve path: if PROJECT contains `/`, treat as a path. Otherwise check `$HOME/opensource-staging/PROJECT`, then `$HOME/PROJECT`, then current directory.
+
+```
+Agent(
+  subagent_type="opensource-sanitizer",
+  prompt="Verify sanitization of: {resolved_path}. Run all 6 scan categories and generate SANITIZATION_REPORT.md."
+)
+```
+
+---
+
+### /opensource package PROJECT
+
+Run packager independently. Ask for "License?" and "Description?", then:
+
+```
+Agent(
+  subagent_type="opensource-packager",
+  prompt="Package: {resolved_path} ..."
+)
+```
+
+---
+
+### /opensource list
+
+```bash
+ls -d $HOME/opensource-staging/*/
+```
+
+Show each project with pipeline progress (FORK_REPORT.md, SANITIZATION_REPORT.md, CLAUDE.md presence).
+
+---
+
+### /opensource status PROJECT
+
+```bash
+cat $HOME/opensource-staging/${PROJECT}/SANITIZATION_REPORT.md
+cat $HOME/opensource-staging/${PROJECT}/FORK_REPORT.md
+```
+
+## Staging Layout
+
+```
+$HOME/opensource-staging/
+  my-project/
+    FORK_REPORT.md           # From forker agent
+    SANITIZATION_REPORT.md   # From sanitizer agent
+    CLAUDE.md                # From packager agent
+    setup.sh                 # From packager agent
+    README.md                # From packager agent
+    .env.example             # From forker agent
+    ...                      # Sanitized project files
+```
+
+## Anti-Patterns
+
+- **Never** push to GitHub without user approval
+- **Never** skip the sanitizer — it is the safety gate
+- **Never** proceed after a sanitizer FAIL without fixing all critical findings
+- **Never** leave `.env`, `*.pem`, or `credentials.json` in the staging directory
+
+## Best Practices
+
+- Always run the full pipeline (fork → sanitize → package) for new releases
+- The staging directory persists until explicitly cleaned up — use it for review
+- Re-run the sanitizer after any manual fixes before publishing
+- Parameterize secrets rather than deleting them — preserve project functionality
+
+## Related Skills
+
+See `security-review` for secret detection patterns used by the sanitizer.