---

作品简介

GitLink Submission Guardian CLI 面向 GitLink CLI 贡献和 CCF 开源项目贡献赛提交场景，提供一套本地可运行、Agent 可调用、结果可复现的提交质量检查流程。

它将 README、License、CI、测试、Agent Skill、工作流、GitLink remote、提交包证据和敏感信息风险等检查项整合为统一 CLI 输出，帮助参赛作品在提交前形成清晰、量化、可验证的材料闭环。

赛题对应

赛题方向	本仓库交付物	位置
子赛题二：编写和丰富 GitLink Skills	gitlink-submission-guardian Agent Skill	skills/gitlink-submission-guardian/
子赛题三：构建端到端自动化工作流	提交质量看门人自动化工作流	examples/workflows/submission-guardian/
GitLink CLI 主线扩展路径	Go/Cobra 原型与 patch sketch	shortcuts/workflow/、patches/

主交付物聚焦 Agent Skill + 端到端工作流。Go/Cobra 内容用于展示后续接入官方 gitlink-cli 命令体系的接口设计和迁移路径。

交付要求导航

子赛题二：编写和丰富 GitLink Skills

官方交付要求	本仓库证据
遵循 gitlink-cli Skills 规范	skills/README.md、skills/gitlink-submission-guardian/
Skill 本体：SKILL.md	skills/gitlink-submission-guardian/SKILL.md
使用示例	skills/gitlink-submission-guardian/examples/README.md、skills/gitlink-submission-guardian/examples/agent-session.md
Agent 平台验证结果	docs/submission-check/agent_platform_validation.md、examples/workflows/submission-guardian/examples/agent-platform-compatibility.md
兼容主流 AI Agent	examples/workflows/submission-guardian/examples/agent-skill-validation.md、examples/workflows/submission-guardian/examples/agent-skill-validation.json
演示截图 / 录制脚本	docs/submission-check/demo_capture.md、docs/submission-check/demo_recording_script.md、examples/workflows/submission-guardian/docs/assets/demo-screenshot.png

子赛题三：构建端到端自动化工作流

官方交付要求	本仓库证据
串联 ≥3 个 CLI 命令或 Skill 调用	examples/workflows/submission-guardian/README.md、examples/workflows/submission-guardian/scripts/gitlink_cli_command_chain.js
可复现执行脚本	examples/workflows/submission-guardian/scripts/run_workflow.js、examples/workflows/submission-guardian/examples/demo-output.json
Agent 对话记录	examples/workflows/submission-guardian/examples/demo-transcript.md
真实 GitLink 项目验证效果	examples/workflows/submission-guardian/examples/real-gitlink-project-validation.md、examples/workflows/submission-guardian/examples/real-gitlink-project-validation.json
工作流说明文档	examples/workflows/submission-guardian/README.md、examples/workflows/submission-guardian/docs/verification.md
架构图	examples/workflows/submission-guardian/docs/architecture.md、examples/workflows/submission-guardian/docs/assets/submission-guardian-workflow.svg

核心交付

模块	内容	价值
CLI 检查器	gitlink-submission-check	本地扫描仓库和提交材料，输出 table / JSON / Markdown
Agent Skill	SKILL.md、示例、验证输出	支持 Codex、Claude Code、Cursor、OpenClaw 等 shell 型 Agent 调用
自动化工作流	规则目录、严格扫描、PR 摘要、敏感信息负例、命令链证据	串联多个检查步骤，形成可复现演示
题面对齐材料	要求矩阵、最终报告、技术方案、测试说明	将官方要求映射到具体文件和验证结果
安全边界	敏感信息扫描、只读工作流、提交包边界说明	降低误提交凭证、日志、历史包等风险

工作流概览

GitLink CLI 贡献 / CCF 提交材料
        |
        v
gitlink-submission-check
        |
        +-- 文档完整性：README / 使用说明 / 技术方案 / final report
        +-- 工程质量：License / CI / 测试 / 样例输出
        +-- Skill 规范：SKILL.md / 输入输出 / Agent 使用步骤
        +-- 工作流证据：命令链 / transcript / 演示材料
        +-- 提交风险：GitLink remote / SHA256 / 敏感信息
        |
        v
结构化结果：table / JSON / Markdown
        |
        v
本地复核、Agent 调用、提交材料生成

快速运行

node npm/bin/submission-check.js --path . --format table --strict
npm test --prefix npm
node examples/workflows/submission-guardian/scripts/gitlink_cli_command_chain.js

常用输出格式：

node npm/bin/submission-check.js --path . --format json
node npm/bin/submission-check.js --path . --format markdown
node npm/bin/submission-check.js --list-rules --format table

验证结果

指标	结果
确定性检查规则	61 条
npm 测试套件	4 组通过
本地工作流调用	4 步
GitLink CLI 命令链规划	5 条
CLI fail 级问题	0
官方 scorecard / subtopic / source / traceability 校验	通过

项目结构

路径	说明
npm/bin/submission-check.js	CLI 主程序
npm/test/	自动化测试和 fixture
skills/gitlink-submission-guardian/	Agent Skill 交付物
examples/workflows/submission-guardian/	端到端工作流和演示证据
docs/submission-check/	使用、测试、架构、演示和验证文档
docs/submission-check/reports/	正式报告和赛题对齐材料
shortcuts/workflow/	Go/Cobra 接入原型
patches/	官方 CLI patch sketch
docs/upstream/	上游 gitlink-cli README 备份资料

交付材料

材料	文件
中文总览	docs/submission-check/README.zh-CN.md
技术方案	docs/submission-check/technical_solution.md
测试说明	docs/submission-check/testing.md
使用说明	docs/submission-check/usage.md
题面对齐	docs/submission-check/reports/OFFICIAL_TOPIC_ALIGNMENT.md
要求矩阵	docs/submission-check/reports/OFFICIAL_REQUIREMENTS_MATRIX.md
最终报告	docs/submission-check/reports/final_report.md
展示 PPT	docs/submission-check/gitlink-submission-guardian-subtopic2-3-status.pptx

License

本仓库沿用上游 gitlink-cli 许可证，见 LICENSE。