SuperAPI AI 工具集

fcode-code-validation

通用与其它

查看项目

更新于 10-16 08:37

技能介绍

用途:Factorial Code 应用的发布前(pre-production)静态审查,在申请正式发布前本地运行,补充人工审核会关注的维度:表单与生命周期、i18n、日志卫生、安全、邮件滥用。同一流程面向两类使用者:申请发布前自检的开发者和把关发布的平台审核者。输入为工作区(team)slug,输出为克隆工作区中的 APP_VALIDATION_REPORT.md 以及聊天中的 ✅/❌ 结论。

主要能力:本技能只负责流程、检查目录、严重级别和报告格式;每条被检查的规则由其他技能拥有并在目录行中标注,需要上下文时去读规则所有者。检查类别包括 STRUCT、LANG、FORM、I18N、SEC、MAIL、REUSE、LOG、LIFE、REL,完整目录与逐项严重级别见 references/checks.md。

严重级别:Blocker(运行时破坏、凭据处理不当、平台邮件域被滥用、或未通过平台发布门槛标准)——任一条即 ❌;Warning——违反已文档化规则,预期会收到审核反馈或未来出问题,属建议性;Suggestion——符合平台约定的改进,属建议性。Warning 与 Suggestion 不影响结论。

使用方式:先确认工作区 slug 是编码的 dev-… token(不是浏览器 URL 里的应用 UUID),从应用 Development 标签页的 “How to build locally” 指南复制;确认工作区类型,必要时向用户澄清(dev- 是常规审查目标)。缺失 CLI 时询问用户,然后执行 pnpm install -g @factorialco/fcode-cli(唯一允许的安装)。新副本使用 fcode clone <workspace-slug> --skipSkillsSetup;已克隆则 fcode pull,出现分叉时绝不 --force,而应询问是否按现状审查并在报告头记录答案。随后只读清点各进程语言、进程/模块/appRoles/表单 webhook 设置、settings.json、三个变量文件、variables.meta.json 和 i18n/,并运行 fcode status、fcode variables:status、fcode settings:status、fcode i18n:status;再依据 references/checks.md 评估每项检查并记录 file:line 证据,分类,按 references/report-template.md 覆写报告,最后在聊天中打印结论、各级别计数和 Blocker 标题。

限制:审查为只读——仅允许克隆本身和写 APP_VALIDATION_REPORT.md;禁止 fcode push、--force、settings:versions:create / settings:aliases:set,禁止编辑工作区文件,禁止 fcode add 报告,审查期间禁止 fcode run。这是对代码与配置的静态审查。拉取变量中的 ******** 占位符属正常,掩码密钥不算发现,审查无需真实密钥值,也绝不索要。只审查工作区自有的内容;继承资源(parentTeams 的模块、进程、变量,variables.inherited.env,i18n/<locale>.inherited.yaml)已在拥有者发布时验证,不审计其内容,发现只能涉及本工作区如何使用它们。混合 JS/Python 工作区可行,按各自语言规则审查并在报告头注明。克隆失败通常意味着 UUID 混淆或缺少权限,应指向 fcode-ama 中的访问流程而不是盲目重试。存在歧义时(同名开发团队有多个应用,或不清楚审查哪个工作区)先列出候选并询问再克隆。暂未提供具体价格信息。