507 explore

Skill ssdiwu/507-skills/common/507-explore

Workflow-oriented Agent Skills for writing, coding, research, and decision alignment.

Install

npx -y skills add ssdiwu/507-skills --skill 507-explore

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

24 days oldThe repository was created 24 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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

SKILL.md

6.9 KB, as published. Nobody here has run it

项目探索（`explore`）

面对一个还看不清全貌的项目问题，先建立共同上下文，再找出当前真正能够推进的未知。探索是一段有起止的临时会话，不是长期运行的编排器；长期共识继续由项目文档、术语、决策、经验、规格和工单承载。

507-explore 做的是：项目未知 → 证据支持的认知边界与下一步路由。

覆盖什么

定位一个现象、想法或问题在项目中的入口、上下游与证据范围；
解释当前项目机制，同时区分已经确认与仍未核实的部分；
面对暂时无法完整规划的方向，找出当前可解决的一个 frontier（当前可推进边界）；当有多条技术路径且证据不足以选择时，形成带依据的可验证候选；
在代码、写作或其他项目中，为后续专门技能建立输入上下文。

不覆盖什么

用户只是不理解一个概念或术语 → 用 507-explain；
外部参照物的机制与借鉴判断 → 用 507-research；
已经明确需要用户决定的权衡 → 用 507-grill；
系统性架构体检 → 用 507-inspect；
实现、修复、写规格、建工单或修改项目文档 → 退出本技能后进入对应工作流。

核心纪律

先读既有共识：遵循项目 AGENTS.md、根 README.md、doc/README.md 和项目规定的阅读顺序；按需读取术语表、决策档案、经验笔记、相关分层 README、代码、测试、配置或写作材料。
不伪造完整路线：只写证据已经支持的已知、尚未支持的未知，以及前置条件已经满足的当前可推进边界；未来问题仍看不清时留在未知区，不补成假计划。
能查的事实立即查：项目文件、运行输出、文档或小型只读验证可以回答的，不转问用户。外部参照物需要系统调研时路由 507-research。
事实与决策分开：只有产品意图、权责边界、不可逆成本、体验或风险取舍需要用户决定；一旦当前可推进边界变成这类问题，携带探索快照转入 507-grill。
会话内累积快照：每完成一轮有效查证、形成候选或准备切换工作流时，重写最新、完整的探索快照；不追加流水账，不让旧结论和新证据并排冲突。
候选不是结论：当前可推进边界有多条技术路径而证据不足以选择时，才整理少量候选；每项都写明主张、依据、适用边界或风险，以及最小验证动作。候选不得伪装成已确认结论；取舍若取决于用户意图、体验或风险承受，携带事实转入 507-grill。
只读且临时：不修改代码、配置或项目文档，不创建持久探索地图。对话结束后快照可以消失；够格的长期结论由后续动作沉淀到项目既有载体。
找到下一步就停止：问题已经能够直接回答就给结论；需要专门动作就明确路由，不把 507-explore 扩成 507-research、507-grill、507-prototype 或实施总控。

工作流程

锁定探索目标：用一句话说明这次要弄清什么，以及暂不处理什么；用户已说清时不重复确认。
读取项目依据：从项目规则和权威文档开始，再按需进入相关实现、测试、配置或材料；没有明确路径时先做窄范围搜索。
建立首个快照：列出已知、未知、当前可推进边界与证据边界；只能从局部判断时明确标注已读范围。
推进当前可推进边界：读取证据或做只读验证；得到新事实后重新计算已知、未知和下一可推进边界。
形成候选或路由：若多条技术路径仍会改变下一步，基于已核验证据写出可验证候选；若事实已经足够，直接选择下一专门动作。概念不懂转 507-explain，外部机制转 507-research，用户决策转 507-grill，需看见后判断转 507-prototype，已足够清楚则进入规格、工单或正常实施。

会话输出

探索过程中按实际复杂度呈现并累积重写：

## 当前探索快照

### 目标
- <这次要弄清什么>

### 已知
- <有项目依据支持的事实 + 依据>

### 未知
- <当前证据仍不足的部分>
### 证据化候选（按需）
- <主张：可尝试或优先查明什么>
- <依据：来自项目材料、独立探测或已核验证据>
- <边界 / 风险：什么条件会使它不成立>
- <最小验证：下一步如何确认或证伪>


### 当前可推进边界
- <现在具备前置条件、最值得先解决的问题>

### 证据边界
- <已读范围、未核实范围与置信限制>

结束时给出：一句话结论、仍未解决的未知、按需列出的候选，以及唯一推荐的下一工作流。简单问题不机械展开全部标题。

与相邻技能的边界

技能	回答的问题
`507-explore`	项目里已经知道什么、还不知道什么、现在先查什么？
`507-explain`	这个概念到底是什么意思，怎样讲我才能懂？
`507-research`	外部对象真实怎么做，对当前项目有什么借鉴？
`507-grill`	在已知前提下，需要用户决定的权衡最终选什么？
`507-prototype`	必须看见或操作一个低成本原型后才能判断什么？

红线

不跳过项目文档直接把代码猜测写成事实；
不把未知补成完整计划；
不把可查事实转交用户决定；
不持久化探索快照或建立第二事实源；
不在只读探索中顺手实施、修文档或创建提交。

完成与接力

完成信号：探索目标已得到答案，或当前可推进边界已落到一个边界清楚的专门动作。
产物：会话中的最新探索快照和一句话结论；不建立持久探索地图。
候选出口：概念障碍进入 507-explain；外部未知进入 507-research；低成本可观察假设进入 507-prototype；用户决策进入 507-grill；前提充分时进入规格、工单、写作或实施；问题已回答时直接结束。
回退条件：证据只覆盖局部时保留边界与置信限制，不把局部观察扩写成全局计划。