System

自定义

执行前，请检查以下位置是否有用户自定义设置： ~/.claude/skills/CORE/USER/SKILLCUSTOMIZATIONS/System/

如果此目录存在，请加载并应用其中的任何 PREFERENCES.md、配置或资源。这些内容会覆盖默认行为。如果目录不存在，请使用技能默认设置。

系统技能

用于 PAI 系统的系统验证、完整性审计、文档跟踪和安全扫描。

可见性

此技能在前台运行，因此你可以看到所有输出和进度，并在工作进行时听到语音通知。文档更新、完整性检查和其他系统操作都应保持可见，以确保透明度。

---

语音通知

执行工作流时，必须同时执行以下两项：

1. 发送语音通知：

   curl -s -X POST http://localhost:8888/notify \
     -H "Content-Type: application/json" \
     -d '{"message": "Running WORKFLOWNAME workflow from System skill"}' \
     > /dev/null 2>&1 &
   

2. 输出文本通知：

   Running the **WorkflowName** workflow from the **System** skill...
   

---

工作流路由

核心操作（三项）

工作流	触发语	用途	文件
IntegrityCheck	“integrity check”、“audit system”、“check references”、“system health”	查找并修复系统中的失效引用	Workflows/IntegrityCheck.md
DocumentSession	“document session”、“document today”、“document this session”、“log session”	根据转录记录当前会话的工作	Workflows/DocumentSession.md
DocumentRecent	“document recent”、“catch up docs”、“what's undocumented”、“document since last update”	补充记录上次文档更新以来的变更	Workflows/DocumentRecent.md

组合规则：

• Integrity Check → 可能会产生修复 → Document Session
• 每次会话结束后 → Document Session
• 定期补充记录 → Document Recent

安全工作流

工作流	触发语	文件
SecretScanning	“check for secrets”、“scan for credentials”、“security scan”	Workflows/SecretScanning.md
PrivacyCheck	“privacy check”、“check for sensitive data”、“data isolation”	Workflows/PrivacyCheck.md

实用工作流

工作流	触发语	文件
WorkContextRecall	“we just worked on”、“what did we do with”、“remember when we”、“didn't we already”	Workflows/WorkContextRecall.md

注意： 对于公开 PAI 完整性（“check PAI integrity”、“audit PAI packs”），请使用 PAI 技能 → PAIIntegrityCheck.md

---

示例

核心操作

示例 1：完整性检查

User: "Run an integrity check"
→ Invokes IntegrityCheck workflow
→ Spawns parallel agents to audit ~/.claude
→ Finds broken references, missing files
→ Returns list of issues found/fixed

示例 2：记录当前会话

User: "Document this session"
→ Invokes DocumentSession workflow
→ Reads current session transcript
→ Uses AI to extract what changed and why
→ Creates entry in MEMORY/PAISYSTEMUPDATES/

示例 3：补充文档记录

User: "What's undocumented? Catch up the docs."
→ Invokes DocumentRecent workflow
→ Finds last documented update timestamp
→ Compares git history since then
→ Generates documentation for missed changes

安全工作流

示例 4：秘密扫描

User: "Check for secrets before I push"
→ Invokes SecretScanning workflow
→ Runs TruffleHog on specified directory
→ Reports any API keys, credentials found

实用工具

示例 5：回顾过去的工作

User: "We just worked on the status line - why broken again?"
→ Invokes WorkContextRecall workflow
→ Searches MEMORY/, git history for "status line"
→ Presents timeline of changes and possible regression

---

快速参考

三项核心操作

操作	输入	输出	时长
IntegrityCheck	代码库扫描	找到/修复的失效引用列表	~2-5 min
DocumentSession	会话转录	PAISYSTEMUPDATES 条目	~30s
DocumentRecent	上次更新以来的 Git 历史	多个 PAISYSTEMUPDATES 条目	~1-2 min

组合模式

End of Session:     DocumentSession
After Refactoring:  IntegrityCheck → DocumentSession
Catch-up:           DocumentRecent

安全审计

审计类型	工具	范围	时长
秘密扫描	TruffleHog	任意目录	~30s-2min
隐私检查	grep/模式	skills/（排除 USER/WORK）	~30s

文档格式

详细叙述结构：

• 故事背景（1-3 个段落）：背景、问题、解决方案
• 过去的工作方式：先前状态，使用项目符号列出
• 现在的工作方式：新状态及改进之处
• 后续计划：未来影响
• 验证：确认其正常工作的依据

---

适用场景

完整性检查

• 重大重构后
• 发布更新前
• 定期系统健康检查
• 感觉“哪里出了问题”时
• 推送到公开 PAI 仓库前

文档

• 重要工作阶段结束时
• 创建新技能／工作流／工具后
• 做出架构决策时
• 为维护系统历史记录

安全扫描

• 在向公共仓库提交任何 git 提交之前
• 审查是否存在凭据泄露时
• 定期进行安全卫生检查
• 收到外部代码／内容后

隐私验证

• 处理 USER/ 或 WORK/ 内容后
• 在向公共仓库提交之前
• 创建可能会引用个人数据的新技能时
• 定期审计，确保数据隔离

工作上下文回忆

• 用户询问过去的工作时（“我们刚修好了那个”）
• 询问做出决策的原因时
• 查找之前会话中的产物时
• 调试“已经修复过”的问题时
• 恢复跨多个会话的项目时

---

工具

工具	用途	位置
SecretScan.ts	用于凭据检测的 TruffleHog 封装器	CORE/Tools/SecretScan.ts
CreateUpdate.ts	创建新的系统更新条目	Tools/CreateUpdate.ts
UpdateIndex.ts	重新生成 index.json 和 CHANGELOG.md	Tools/UpdateIndex.ts
UpdateSearch.ts	搜索和查询系统更新	Tools/UpdateSearch.ts
ExtractArchitectureUpdates.ts	历史迁移工具（一次性使用）	Tools/ExtractArchitectureUpdates.ts

模板

模板	用途	位置
Update.md	系统更新条目模板	Templates/Update.md

---

输出位置

输出	位置
完整性报告	MEMORY/STATE/integrity/YYYY-MM-DD.md
系统更新	MEMORY/PAISYSTEMUPDATES/YYYY/MM/*.md
更新索引	MEMORY/PAISYSTEMUPDATES/index.json
更新日志	MEMORY/PAISYSTEMUPDATES/CHANGELOG.md

---

相关技能

• PAI - 公共 PAI 仓库管理（包括 PAIIntegrityCheck）
• CORE - 系统架构和记忆文档
• Evals - 回归测试和能力验证