507-skills

Git 提交：在用户明确要求提交时，轻量安全复核变更、精确暂存、运行相关验证并创建真实 Conventional Commit；只做本地提交，推送与对外发布由 507-release 承接。Use when user says commit, 提交, 提交一下, 提交这些改动, 提交代码, Git 提交, commit 一下, 生成并执行提交, 准备提交, 存个档。

对外发布：在用户明确要求发布、推送或发版时，定版本号、打 tag、推送远端，并按项目实际探测的发布渠道（npm、GitHub Release）发布。每个不可逆对外动作执行前都向用户显式确认。Use when user says release, publish, push, 发版, 发布, 推送, 发包, 打 tag, 升版本, 升级版本号, 发新版本, 上线, 发到 npm, 发 GitHub Release。默认只做用户明确点名的对外动作，不自动扩到全部渠道。

根因修复：已明确存在 bug、报错、崩溃、异常、回归或合并冲突时，先建立可重复反馈环，再以最小改动修复根因并验证。Use when user says fix, 修一下, 修 bug, 报错了, 崩了, 跑挂了, 有 bug, 修复报错, 合并冲突, 修复冲突, 修不通, debugging, error, crash, regression.

维护项目地图：以当前代码为证据，建立或校准 README、doc 组织、目录职责、入口与上下游，只修改地图文档。Use when user says map, project map, 梳理项目结构, 项目结构, 更新 README, 补 README, 校准 README, 整理 doc, 整理结构, 文档地图, 目录职责, 分层 README.

交付审查：围绕明确的 commit、branch、diff 或路径检查 Standards、Spec 与 Code Quality，只报告问题、证据和路由。Use when user says review this change, code review, review 一下, 检查, 审查, 审查改动, 审查这次改动, 检查提交, 检查分支, 过一遍代码, 把关, 需求符合度, 交付审查. 不用于主动寻找全库架构机会。

在保持公开契约与可观察行为不变的前提下，对指定代码范围或 507-inspect 报告逐项建立证据、修改并验证。可深入内部模块、抽象与接缝；若需要行为变化则停止并路由到需求实施。Use when user mentions simplify, simplify code, 简化, 简化代码, 行为不变重构, 内部简化, 按报告修改, 处理 inspect 报告, 局部重构, 降低复杂度, 收敛架构摩擦。

测试任务：测试本身是主要任务时，用现有框架补行为测试、运行测试、修正过时测试或缩小失败范围；真实生产 bug 转根因修复。Use when user says test, testing, 写测试, 加测试, 补测试, 跑测试, 运行测试, 测试挂了, 测试失败, 修失败测试, 缩小失败范围, coverage.

项目探索：面对尚未看清问题形状、无法安全规划或不知道从哪里开始的项目问题，先读取项目规则、既有共识与现实证据，在临时会话中区分已知、未知、当前 frontier 与证据边界；只读推进一个当前可解决问题，并路由到 explain、research、grill、prototype、规格或执行。Use when user mentions 探索一下, 先看看怎么回事, 先别做, 先理清, 梳理一下, 搞清楚状况, 摸清楚, 不知道从哪开始, 这个问题在哪, 帮我看懂这个项目, 上手这个项目, 这段代码怎么工作, explore, investigate this project, orient me, locate the problem, understand this codebase, explain this code.

会话移交：中断、换会话、压缩上下文或转交给另一 Agent 时，在对话中生成脱敏的临时交接摘要，不写文件。Use when user says handoff, 交接, 交接一下, 移交, 换会话, 换个会话, 转交, 压缩上下文, 上下文太长了, 给下一个 agent 摘要.

通用外部证据入口。研究外部项目、文章、文档、标准、竞品或当前事实，区分已核实事实、来源观点、本项目推断与未知，产出可追溯的 evidence handoff（证据交接）。可独立回答，也可把证据交给 explain、explore、mine、grill、PRD 或 issue；不挖碎片、不替用户做取舍、不直接实施。Use when user mentions 查一下, 搜一下, 帮我查, 调研一下, 研究一下, 调查一下, 查证, 核实, 搜资料, 找资料, 看看这个项目, 看看这篇文章, 外部证据, 竞品, 参考实现, benchmark, research, investigate, verify sources.

视频拉片 skill：将一个视频经 MiniMax-M3 整段理解、本地文本定位、受限视觉搜索、自适应抽帧与图片证据回写核验，产出可供 remix 消费的 video_* 拉片包。Use when user mentions 拉片, 拆视频, 视频拆解, 分析视频, 逐帧分析, 分镜, 视频取证, 怎么剪, 视频结构分析, breakdown, video breakdown, transcript extraction. 只需要普通视频总结时，选择当前环境可用的视频理解或总结能力，不走本 skill。

写作流的碎片挖掘入口。把用户想法、现有文章、研究证据或 video_completed 拉片包转成可复用碎片、观点与材料交接；先查既有知识库做去重和互链，不承担系统外部调研。证据不足时调用 research 补证后返回；不产选题、不写正文。Use when user mentions 挖一下, 挖碎片, 产碎片, 落碎片, 我有个想法, 记个想法, 这个观点记下来, 拆解吸收, 提取要点, 摘录, 整理观点, 从这篇文章提观点, 拉片后挖内容, content mining, extract fragments.

把已成立的书面作品改编并渲染成小红书 3:4 图片文章：锁定中心判断、论证链与原图去向，产逻辑 Copy Spec，按真实高度自动分页，从 18 套外观中选样式，导出 1500×2000 图卡、联系表并验收。Use when user mentions 做成小红书, 做成小红书图文, 小红书图片文章, 小红书图卡, 小红书文案, 小红书排版, 3:4竖图, 把文章转成小红书, rednote cards, xiaohongshu carousel.

视频借鉴重组 skill。只消费一个或多个 video_completed 的 507-breakdown 拉片包，提取可借鉴的结构、叙事、镜头、字幕与节奏模式，明确不借内容和身份，再重组为原创视频创作包与工具无关的 prompt-pack.json；不读取原视频、不做取证、不直接渲染成片。Use when user mentions 视频借鉴重组, 借鉴视频, 仿照这个视频, 视频二创, 二创, 视频重组, 原创创作包, 借这个视频的手法, remix, video remake, recombine.

为一个或多个代码项目做工作流初始化或全量规范巡检：核对 AGENTS、README、CHANGELOG、doc、术语、决策和代码目录现实，先报告再路由。Use when user says 项目初始化, 项目规范巡检, 工作流初始化, 校准 AGENTS, project setup, project bootstrap, scaffold. 不用于代码体检或架构 review；专项地图维护使用 507-map。

不围绕某次交付 diff，只读检查代码库的模块形状、接缝与架构摩擦，产出证据候选报告交给 507-simplify。Use when user says 架构审查, 代码体检, 找重构机会, 浅模块改深, 找接缝, inspect architecture, codebase architecture review, refactor opportunity. 明确变更范围的交付 review 使用 507-review。

测试驱动开发：仅在用户明确要求 test-first、TDD、先写测试或红绿重构时，以垂直切片完成行为测试、最小实现和全绿重构。Use when user says tdd, test-first, 先写测试, 测试驱动, 红绿重构, test driven development.

概念解释：把用户不理解的一个概念、术语、技术名词或相近概念差异讲清楚。先给最短白话定义，再按用户已知切换比喻、例子、反例与对比；当顺序、状态、层级或多方关系不易用纯文字理解时，优先选用表格、流程图、Mermaid 或 ASCII 示意。默认不落盘，不负责定位项目未知。Use when user mentions X 是什么意思, 这个概念是什么, 帮我理解一下, 用大白话讲讲, 我不懂这个词, 解释一下这个术语, X 和 Y 有什么区别, explain concept, explain in plain words, what is X, ELI5, break down a concept.

写作流的沉淀层（和 fuse 平行）。基于成熟碎片簇提出主题结构，涉及用户知识组织取舍时经 grill 确认，再浇铸成 04-知识库/ 下的系统化主题页。不挖碎片（归 mine）、不产选题候选（归 fuse）。Use when user mentions 沉淀成主题页, 这几个碎片够成知识库页了, 铸个主题页, 浇铸主题页, 系统化沉淀, 把这个主题沉淀一下, 这个主题值得有个页, 知识库页生长, 成熟簇成页, 讨论主题结构, 组织主题页, cast, casting, knowledge base page, topic page, crystallize topic.

写作流的书面成文与共创收敛 skill。把已成立、且已比较核心争点材料的创意、碎片和证据写成可发布长文，也可在不改变中心判断与论证链的前提下改编为其他书面平台文案；已有草稿时负责结构重组与统一重写。外部事实缺口交给 research，碎片缺口交给 mine，竞争解释交给 fuse，用户取舍统一经 grill 后返回。不负责讲稿/PPT、正式方案或视觉排版渲染。Use when user mentions 写篇文章, 写成长文, 把创意写出来, 把这些材料写成文, 改这篇文章, 重组这篇稿, 收紧全文, 改编成小红书文案, 写博客, 写公众号文章, 写技术文章, 案例复盘, forge, drafting, long-form writing, rewrite article.

写作流的融合层（选题层）。检索 01-碎片/ 既有碎片、本次新碎片及争点材料，比较可竞争解释，挑时效性/主体性材料作骨架；存在真实竞争解释时产出 2～5 条候选 idea 到 02-创意/候选/，用户拥有的中心判断选择交给 grill。不挖碎片（归 mine）、不写正文（归 forge）、不和 cast 抢沉淀。Use when user mentions 融一下, 融合一下, 熔一下, 这几个碎片能不能成题, 组个选题, 挑骨架, 组合成选题, 把这些碎片融成一个选题, 看看能不能写成一篇, 够不够写一篇, 这个主题够成题了吗, 挑主碎片, 融合成 idea, 产候选选题, 产候选 idea, 挑时效碎片, fuse, melting, fuse fragments, idea candidate, topic fusion.

现场讲述 skill（讲稿/PPT/课程稿/企业培训）。输入允许多 idea + 多碎片组合（比 forge 灵活），事化真实案例为可落地方法，保留现场口播节奏。和 forge 分工：forge 写出来（书面长文），stage 讲出去（现场口播）。Use when user mentions 写演讲稿, 做演讲稿, 写讲稿, 做 PPT, 打磨 PPT, PPT 逐页稿, 写逐页稿, 课程稿, 写课程稿, 课程分享, 现场分享稿, 现场讲稿, 企业培训, 企业 AI 分享, 案例型企业培训, 分享内容, 演讲内容, 口播稿, 路演稿, 逐页稿, 分享会, 演讲, stage, presentation, slide script, keynote, talk script, course script, corporate training.

创建和维护 GitHub issue 的生命周期。可先在对话中草拟，或以 investigation（调查态）开远程 issue；通过 explore、research、prototype 与 grill 补充事实和决策后，在同一 issue 原位升级为 ready（执行态），作为可被 AI 或协作者领取的执行合同。每个远程状态都按仓库规范设置并核验标签与负责人，除非权限不足。Use when user mentions 写 issue, 开 issue, 草拟 issue, 调查工单, 执行工单, 更新 issue, 转成执行工单, 上传 issue, bug 转 issue, gap 转 issue, GitHub issue, ticket.

把当前对话、方案或 PRD 沉淀成产品需求文档（PRD）。承接对齐结果到执行的中间规格化层——把方案落成需求规格（要解决什么问题、给谁、怎么验证）。不拆 issue 工单（归 507-issue）、不做架构体检（归 507-inspect）。Use when user mentions 写 PRD, 拆 PRD, 做个 PRD, 沉淀 PRD, 形成需求文档, 把刚才整理成需求, 需求规格, 落成 PRD, to-prd, product requirements.

前置验证与证据 skill。只在一个具体未知能由低成本、可丢弃原型直接观察，且预期学习收益高于制作与清理成本时使用；逻辑/状态问题可做交互式终端原型，UI/视觉问题可做结构差异明显的页面变体。记录证据与 verdict 后删除外壳或明确清理状态，不把原型当半成品。Use when user mentions 做个原型, 做个 demo, 快速验证, 让我玩一下, 试几个设计, 验证状态机, 验证数据模型, mock UI, 可丢弃原型, prototype, throwaway prototype, proof of concept, PoC.

实施前对齐的决策树追问（通用，代码/写作都用）。把一个改动/方案的每个决策分支沿依赖关系问到底；每轮只收集 frontier（前置条件已确定）的独立决策，有合适工具时批量收集，否则一次只问一个问题。需要用户决策时必须给出 2–5 个有真实权衡的候选并标出推荐项，边问边把术语/决策/经验沉淀进 doc。代码里沉淀进项目 doc，写作里把判断问透后另行落碎片。Use when user mentions 先对齐一下, 追问一下, 实施前对齐, 帮我把这个方案问透, 这个改动我先聊聊, 把方案问透, 决策对齐, 我们先聊聊, 对齐一下设计, 把决策树走一遍, 一个问题一个问题问, 拷问一下方案, 质疑一下这个设计, grill, pre-flight review, align before build, decision tree, interrogation.

面向人的结构化方案 skill（活动、培训、工作坊、合作提案、项目计划）。输入是已由 grill 确认的需求与边界，产物是推动读者决策或行动的正式方案；信息缺口涉及用户取舍时返回 grill，不在 frame 内追问确认。具体软件产品需求规格归 507-prd。Use when user mentions 写方案, 写计划, 活动方案, 培训方案, 工作坊方案, 合作提案, 项目计划, 结构化文档, 正式提案, frame, proposal, workshop plan, partnership proposal, project plan, brief.