- name
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add LC044/TrailSnap --skill trailsnap-commit -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add LC044/TrailSnap --skill trailsnap-commit -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add LC044/TrailSnap --skill trailsnap-commit -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add LC044/TrailSnap --skill trailsnap-commit -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/LC044/TrailSnap/tree/HEAD/.agents/skills/trailsnap-commitFrom the publisher
仅在用户明确要求提交、推送或创建 PR 时执行相应 Git 操作。先保护并核对用户已有改动,不要覆盖或擅自丢弃工作区内容。
tests/scripts/run-tests.ps1 -Layer unit -Level all。feat(scope):、fix(scope):、refactor(scope): 等。构建后端:Server Docker 构建与推送,仅 package/server/ 变更时生效。构建前端:Frontend Docker 构建与推送,仅 package/website/ 变更时生效。构建ai:AI 服务 Docker 构建与推送,仅 package/ai/ 变更时生效。构建cli:CLI 构建并保留 Actions Artifacts,仅 package/trailsnap-cli/ 变更时生效;只有 v*.*.* 标签会创建 Release 并发布 npm/PyPI。/api/agent-guide,使用公开 HTTP 接口匿名提交,并用单条需求编辑回执补充自己的需求。不要求用户登录、设置 MCP 或管理员令牌;不调用以下受信任 Agent 审核、规格批准和任务领取接口。trailsnap-feedback MCP 管理。任何路径都不要使用 GitHub CLI、GitHub API 或网页直接创建、编辑、关闭 GitHub Issue;GitHub Issue 由需求平台在后台创建和同步。trailsnap-feedback MCP,先引导用户在需求平台的“集成设置”创建 Agent MCP 令牌,并采用平台提供的 MCP 配置完成连接后再继续。不要自行创建令牌、要求用户在对话中粘贴令牌,或回退为直接操作 GitHub Issue。get_agent_capabilities,检查现有令牌权限和任务绑定;不创建或调整令牌,不通过其他接口绕过 scope。任务创建、领取、取消仍沿用现有鉴权规则;完整编码交付需要 runs:write,规格编写需要 requirements:write,批准规格和答复执行澄清需要 requirements:review。create_requirement,记录 REQ-* 编号。调用 list_requirement_specs 读取规格修订,由 Agent 根据用户需求编写 problem、user_scenario、goal、in_scope 和 Given/When/Then 验收标准 acceptance(例如 AC-01),通过 create_requirement_spec 或 update_requirement_spec 保存。不要机械地将原需求正文复制成验收标准。approve_requirement_spec 自动批准无阻塞问题的规格,不要求用户到页面点击。只根据用户已授权范围和已确认事实编写规格;产品歧义通过澄清解决,不编造答案。GitHub 基线解析失败时报告原因;不要自行伪造 SHA。start_requirement_delivery(requirement_id=REQ编号, ...),原子创建/复用任务、指定领取并提交计划。acceptance_plan 的键覆盖每个必需 AC,值说明如何实现及验证;不使用空白内容或不存在的 AC。保存返回的 id(run_id)、attempt_id、lease_token 和 state_version。也可以依次调用 create_delivery_task、claim_delivery_task(task_id=... 或 requirement_id=...) 和 submit_implementation_plan。指定需求时禁止不带筛选领取其他队列任务。requirement_platform.agent_runner 包装自动续租,使用已有令牌的环境变量,凭证文件放在仓库外,不输出凭证或提交凭证文件。request_clarification,收到用户答案后可用 answer_run_clarification 回填;涉及范围变化时修订并重新批准规格。失去租约或被取消后停止旧 attempt,不继续上报;重新读取状态后再决定领取。acceptance_coverage、self_test_results、改动文件和限制,通过 submit_run_result 上报;需要证据产物时使用 submit_run_artifact(artifacts:write)。成功结果需完整提交 SHA,未获提交授权时保留工作区改动并说明尚未提交,不冒充已有交付提交。创建 PR 后用 list_delivery_tasks 读取最新 task 版本,再 link_pull_request。不使用 update_requirement_status(developing) 代替规格、计划和交付门禁。关联需求:[REQ-123](https://feedback.trailsnap.cn/REQ-123));已有 Issue 时填写 GitHub 关闭关键字(例如 Closes #456)。关闭关键字用于在需求详情页展示关联 PR,并在合并后自动关闭 Issue 与需求单。.github/pull_request_template.md,并在评论中确认 CLA:I have read and agree to the CLA(基于 AGPLv3)。TrailSnap 需求规格、Agent 编码交付、提交与 PR 工作流。Use when implementing TrailSnap requirements, managing platform requirements and acceptance criteria, preparing commits, pushing branches, creating pull requests,
---name: trailsnap-commitdescription: TrailSnap 需求规格、Agent 编码交付、提交与 PR 工作流。Use when implementing TrailSnap requirements, managing platform…---# .agents/skills/trailsnap-commit/SKILL.mdOverview
TrailSnap 需求规格、Agent 编码交付、提交与 PR 工作流。Use when implementing TrailSnap requirements, managing platform requirements and acceptance criteria, preparing commits, pushing branches, creating pull requests, or monitoring PR CI in this repository.
FAQ
Download .agents/skills/trailsnap-commit/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/LC044/TrailSnap.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.