Engram 文化与协作规范
为 Engram 贡献者和代理提供统一的产品与文化协作准则,保证功能连贯、决策明晰。
评估的技能是文化规范文档,不涉及敏感数据处理或系统操作,风险较低。文档明确Apache-2.0许可证,但未提及权限、确认或数据流,信息有限,因此扣分。
技能为静态指南,无脚本或指令,主要依赖执行路径不可复制,但文档与仓库整体一致,无相互矛盾。静态评估上限为10分。
适用场景明确(开始功能、审查变更、定义规范),但缺少非适用范围的明确边界,触发条件清晰但不精确,环境适配未提及。
文档结构清晰,有元数据、触发条件,但缺少维护信息、版本更新路径和常见问题,许可证与仓库不一致,扣分。
文档提供协作规范,作为文化指南,可能促进项目一致性,但无直接输出,边际价值难以验证,静态评估上限为7分。
无测试或第三方证据,依赖仓库的整体可审计性,静态评估上限为5分。
- 技能文件与仓库许可证不一致(Apache-2.0 vs MIT),建议修正以避免混淆。
- 技能未提供具体操作指令,可能对自动化代理价值有限。
- 没有维护者和更新路径信息,长期可维护性存疑。
这个 Skill 能做什么,适合哪些场景?
该技能为 Engram 项目的贡献者和 AI 代理明确定义了文化和协作规范,强调产品连贯性高于局部取巧、避免通用企业 UI、推动显式决策和文档化规则。适用于开始新功能、审查实现方向或制定团队约定时。技能本身是纯文本指南,无脚本或外部依赖,任何支持 Agent Skills 的客户端均可直接使用。
该技能提供一组文化规则和协作规则,供代理在启动新功能或重构、审查实现方向、编写项目约定时参考。它不执行具体命令,而是指导行为:要求产品连贯、拒绝虚假 UI、将组织规则强制在服务端、将重复模式沉淀为技能或约定。
- Engram 贡献者开始实现新功能前,确保设计符合整体产品体验。
- 代理在审查代码时,用规则检查是否存在通用企业 UI 漂移或虚假交互。
- 团队在定义项目约定时,用此技能推动显式决策和文档化规则。
- 开发者在重构架构时,确认行为、命名、测试、文档和 UX 一致。
这个 Skill 有哪些优点和局限?
- 明确的文化和协作规则,降低歧义。
- 强调产品连贯性,减少通用 UI 漂移。
- 鼓励将重复模式沉淀为技能或约定,促进知识复用。
- 无外部依赖,易于集成。
- 规则为高级原则,缺乏具体可执行的检查清单。
- 未包含自动化验证或测试。
- 依赖代理对自然语言规则的理解,可能因解释不同产生偏差。
如何安装这个 Skill?
此技能属于 engram 仓库的 skills 集合。将整个仓库克隆或下载,并将 skills/cultural-norms 文件夹放入您的代理 Skills 目录(例如 Claude Code 的 ~/.claude/skills)。具体安装方法请参考仓库的 README 或文档。
如何使用这个 Skill?
在开始重要工作、审查变更或讨论团队规范时,在提示中提及该技能,例如:“根据 cultural-norms 技能审查此 PR 的实现方向。”或“在开始新功能前,应用 cultural-norms 规范。”代理将根据规则指导后续行为。