Community
Contributing
Roles, triggers, flavors, and docs go in by pull request to linkerlin/PUAX.
A role
- At least two triggers
- At least two task types
- A five-step method
- A seven-item checklist
- A system prompt with a visible structure
A trigger
- A detection rule
- An example in and out
- A role mapping
There is also a local path that does not need a pull request: puax_register_custom_role writes ~/.puax/custom-roles.json and joins the recommender immediately.
Code sample
# 验证角色是否符合规范 # 验证单个角色 $ node scripts/validate-role.js military-commander # 验证所有角色 $ node scripts/validate-role.js --all # 输出示例： # 📊 验证结果: # 总计: 42 # 通过: 40 ✅ # 失败: 2 (预期中的v1.0风格角色)
Quiz
How many trigger conditions must a new role declare?