xin-lai-codespirit-cs-rule.ocm.json json Copy{
"ocm": "1",
"id": "xin-lai-codespirit-cs-rule",
"kind": "skill",
"name": "cs",
"description": "1. **所有公共成员必须添加 XML 文档注释** - 使用 `<summary>`、`<param>`、`<returns>`、`<exception>` 标签 - 注释应清晰描述功能、参数和返回值",
"publisher": "xin-lai",
"version": "1.0.0",
"capabilities": {
"domains": [
"coding"
],
"tags": [
"skill-md",
"github-cursor-rules"
],
"languages": [
"en"
]
},
"quality_prior": 0.6,
"examples": [
"1. **所有公共成员必须添加 XML 文档注释** - 使用 `<summary>`、`<param>`、`<returns>`、`<exception>` 标签 - 注释应清晰描述功能、参数和返回值"
],
"primary": false,
"metadata": {
"source": {
"provider": "github-cursor-rules",
"repository": "https://github.com/xin-lai/CodeSpirit",
"path": ".cursor/rules/cs.mdc",
"ref": "361837cde1bd6ef23e301c73d41bb5b54434abb0",
"url": "https://github.com/xin-lai/CodeSpirit/blob/361837cde1bd6ef23e301c73d41bb5b54434abb0/.cursor/rules/cs.mdc",
"key": "xin-lai/CodeSpirit/.cursor/rules/cs.mdc"
}
},
"instructions": "---\ndescription: CodeSpirit C# 通用开发规范 - XML注释、时间格式、序列化等通用要求\nglobs: *.cs\nalwaysApply: true\n---\n# 通用要求\n\n1. **所有公共成员必须添加 XML 文档注释**\n - 使用 `<summary>`、`<param>`、`<returns>`、`<exception>` 标签\n - 注释应清晰描述功能、参数和返回值\n\n2. **复杂业务逻辑必须添加行内注释**\n - 解释关键算法和业务规则\n - 说明特殊处理的原因\n\n3. **优先使用 UTC 时间**\n - 数据库存储使用 UTC 时间\n - 前端显示时转换为本地时间\n\n4. **序列化和反序列化请使用 Newtonsoft.Json**\n - 统一使用 `Newtonsoft.Json` 而非 `System.Text.Json`\n - 配置使用 `JsonConvert.SerializeObject` 和 `JsonConvert.DeserializeObject`\n\n## 专项规范\n\n- **DTO 规范**: 参考 [dto.mdc](mdc:.cursor/rules/dto.mdc)\n- **控制器规范**: 参考 [controller.mdc](mdc:.cursor/rules/co",
"cost": {
"context_tokens": 182
}
}