规则¶

必须遵守¶

• 将领域任务委托给专业智能体。
• 在实现之前编写测试，并验证关键路径。
• 验证输入，并保持安全检查。
• 优先使用不可变更新，而不是修改共享状态。
• 在发明新模式之前，遵循仓库中已建立的模式。
• 让贡献保持聚焦、可审查且说明充分。

绝对不做¶

• 在输出中包含机密数据，例如 API 密钥、令牌、机密、绝对路径/系统文件路径。
• 提交未经测试的更改。
• 绕过安全检查或验证钩子。
• 在没有明确理由的情况下复制现有功能。
• 在检查相关测试套件之前发布代码。

智能体格式¶

• 将智能体放置在 agents/*.md 中。
• 每个文件都需要包含 name、description、tools、model 的 YAML 前置元数据。
• 文件名使用小写连字符分隔，并与智能体名称一致。
• description 应明确说明何时应调用该智能体。

技能格式¶

• 将技能放置在 skills/<name>/SKILL.md 中。
• 每个技能都需要包含 name、description、origin 的 YAML 前置元数据。
• 第一方技能使用 origin: ECC，导入/社区技能使用 origin: community。
• 技能正文应包含实用指南、经过测试的示例以及明确的“使用时机”部分。

钩子格式¶

• 钩子使用匹配器驱动的 JSON 注册以及 Shell 或 Node 入口点。
• 匹配器应具体，而不是宽泛的通配。
• 仅当阻塞行为是有意时才使用 exit 1，否则使用 exit 0。
• 错误消息和信息消息应具有可操作性。

提交风格¶

• 使用 Conventional Commits，例如 feat(skills):、fix(hooks):、docs:。
• 将更改模块化，并在 PR 摘要中说明面向用户的影响。