logo
1
2
WeChat Login
rename: replace TRAE with 正经人 in README

正经人 NPC

CI Star Fork License CNB

正经人是部署在 cnb.cool 平台上的 AI 智能助手 NPC,专注于编程辅助与开发指导。

功能

编程辅助

  • 代码编写:支持主流编程语言,遵循项目现有代码风格
  • Bug 修复:定位问题、分析原因、提供修复方案
  • 代码审查:发现潜在问题、安全漏洞、性能瓶颈
  • 重构建议:提升代码可读性、可维护性和性能

项目协作

  • Issue 处理:分析问题、复现 Bug、提供解决方案
  • PR 评审:审查代码变更、提出改进建议
  • 文档编写:README、API 文档、注释

CNB 平台操作

  • 仓库管理:创建、配置、权限设置
  • 流水线配置:.cnb.yml 编写与调试
  • 制品发布:Docker 镜像构建与推送
  • NPC 配置:角色定义、Skills 集成

安全分析

  • 代码安全审查:注入漏洞、认证授权缺陷、敏感数据泄露
  • 核心安全分析:架构安全评估、业务逻辑漏洞、依赖安全审计
  • 模块安全评估:模块边界安全、通信安全、权限隔离

使用方式

方式一:直接 @提及

在任意仓库的 Issue 或 PR 中,输入以下格式即可召唤正经人:

@mzydami/traenpc(正经人) 你的问题

示例:

@mzydami/traenpc(正经人) 帮我看看这个代码有什么问题
@mzydami/traenpc(正经人) 帮我写一个 .cnb.yml 配置文件
@mzydami/traenpc(正经人) 审查一下这个模块的安全性

方式二:NPC 选择器

  1. Star 本仓库:https://cnb.cool/mzydami/traenpc
  2. 在任意仓库的 Issue 或 PR 评论中输入 @
  3. 从弹出的 NPC 选择器中选择正经人

Star 后正经人会自动出现在你的 NPC 选择器中。

替我上班模式

在评论时勾选「替我上班」,正经人将获得更高权限,可以:

  • 自主编写代码并推送
  • 创建分支
  • 提交 Pull Request
  • 协助解决 Issue

需要仓库开发者及以上权限才能开启此模式。

触发场景

场景触发事件
创建 Issue 的描述issue.comment@npc
Issue 评论issue.comment@npc
创建 PR 的描述pull_request.comment@npc
PR 评审pull_request.comment@npc
PR 评论pull_request.comment@npc
PR 评审评论pull_request.comment@npc

项目结构

.
├── .cnb/
│   └── settings.yml        # NPC 角色定义(名称、prompt、风格、按钮)
├── .cnb.yml                # 流水线配置(NPC 事件 + Docker 镜像构建)
├── .gitignore              # Git 忽略规则
├── CODE_OF_CONDUCT.md      # 行为准则
├── Dockerfile              # NPC 运行时镜像
├── LICENSE                 # MIT 开源协议
└── README.md

技术实现

  • 角色定义.cnb/settings.yml 中定义了正经人的名称、slogan、prompt、思考模式和知识库按钮
  • 运行时镜像:基于 node:22-bookworm-slim,安装了以下工具:
    • cnb-cli - CNB 命令行工具
    • skills - Skills 管理器
    • cnb-skill - CNB 平台 Skill 扩展
    • gitgit-lfs - 版本控制
    • jqripgrep - 文本处理与搜索
    • python3 - Python 运行时支持
  • 流水线:main 分支 push 时自动构建并推送 Docker 镜像到 CNB 制品库;NPC 事件触发时使用自定义镜像执行 npc:go

分享正经人

如果你想让自己的仓库也能使用正经人:

  1. 确保本仓库为公开状态(当前已是 Public)
  2. 让目标仓库的用户 Star 本仓库
  3. 用户即可在评论中通过 @ 选择器找到正经人
  4. 也可以直接输入 @mzydami/traenpc(正经人) 手动触发

许可证

MIT