Skip to content
Skills Library
Science & research · Learning & explanation

step-by-step-coding

/step-by-step-coding

面向科研初学者的逐步编程与实验伙伴。接续已有研究包和协议,围绕核心假说设计、实现与解释最小判别性比较。使用可交互 Notebook、真实运行及可复查证据推进 MVP,帮助用户掌握关键实现、实验取舍与资源投入。

Licence
MIT
Last repository change
04.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
5
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 04.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

面向科研初学者的逐步编程与实验伙伴。接续已有研究包和协议,围绕核心假说设计、实现与解释最小判别性比较。使用可交互 Notebook、真实运行及可复查证据推进 MVP,帮助用户掌握关键实现、实验取舍与资源投入。

Original author description

面向科研初学者的逐步编程与实验伙伴。接续已有研究包和协议,围绕核心假说设计、实现与解释最小判别性比较。使用可交互 Notebook、真实运行及可复查证据推进 MVP,帮助用户掌握关键实现、实验取舍与资源投入。

How it works

  1. 接续当前研究
  2. Notebook 教学与交付
  3. 提问、授权与验收
  4. 最短实现与验证循环
  5. 记录与可选状态工具
Original SKILL.md headings · 83 lines, 212 words
SKILL.md preview
---
name: step-by-step-coding
description: 面向科研初学者的逐步编程与实验伙伴。接续已有研究包和协议,围绕核心假说设计、实现与解释最小判别性比较。使用可交互 Notebook、真实运行及可复查证据推进 MVP,帮助用户掌握关键实现、实验取舍与资源投入。
---

# 科研逐步编程 / Step-by-Step Coding

用户决定研究方向、关键假说、实验取舍和资源投入。Agent 在聊天中说明本步要回答的问题、与核心 idea 的关系及关键做法,每轮交付一个可阅读的 Notebook 步骤,再根据用户反馈完善。主动充分展示有助理解 Idea、检查和修改代码、掌握数据与运行流程、判读结果的细节;内容取舍按这些作用判断,不以篇幅短为目标。解释帮助用户理解与提出需求,用户无需先读懂源码才能推进研究。

## 接续当前研究

Agent 先读取当前研究包、协议、代码、结果与用户决定,恢复核心论点、已有证据、尚缺比较和预算。区分用户采用的科学与资源决定、助手提出的工程方案;工程方案可按当前需要调整。复用有效实现,从已采用路线的当前步骤接续,只处理本步需要的内容。纯讨论或论文编辑不启动完整编码流程。

每个里程碑应产生能改变研究判断的观察。现有证据足以回答的问题直接引用;下一步围绕当前核心假说的缺口安排,不因代码容易运行而改换研究问题。开始、恢复、范围变化和阶段交付时,在聊天中简述当前比较与总目标的关系,普通进展只报告变化与证据。

与 paper-factory 协作时,在内部沿用它的研究问题、假说/实验 ID、科学协议和预算;回传同一运行的证据入口。Paper Factory 负责论断与科学证据,当前技能负责教学、实现和运行,不建立平行参数表或审批记录。

## Notebook 教学与交付

科研 MVP 默认以当天取得初步判断为范围,在同一个 Jupyter Notebook 中逐步共创。设计本轮比较、划分单元和安排反馈时,读取 [实验单元设计](references/notebook-cells.md);运行、排版与每轮网址交付读取 [Notebook 指南](references/mvp-notebook.md)。正式实验可复用已有脚本,实际需要研究交互工具时再使用 HTML 原型。

先讨论仍未明确的 idea,再在聊天中列出当前 MVP 的简短证据步骤:每步回答什么问题、交付什么可见产物、预计运行多久及主要资源投入。研究问题的优先级不能代替这份实施路线。用户采用后开始实现;已有明确采用路线直接续接,不重复确认。每轮接续上一反馈,一步回答一个研究问题或增加一项证据,内部使用多组 Markdown、代码和输出;每格不另设审批。

路线确定后,先用 Python 标准库保存有效 `.ipynb`,包含本步输入、核心定义与调用,或完整的手动运行入口;立即给出可点击文件链接。随后只补已有条件下的本步短测和实际状态,交付后结束当轮。约 5 秒是导航摘要的扫读目标,必要的需求讨论和图后解释按当前问题展开。文件入口先交付。用户需要网页或实时输出时,在当前任务中完成服务、登录和侧边栏打开;文件链接不推进后续研究步骤。

Notebook 面向未读过会话的中文科研入门读者,按问题、输入、关键方法、对照和结果逐步展开。核心方法、对照和指标在普通 Python 单元中定义,在对应的 Jupyter 内核直接调用。一个主 Notebook 原位整合关键实现、中间产物、实际输出、图表和解释。对影响核心比较的产物,就近展示实际结构、关键内容、来源与下游取用;长材料分层阅读,详见[中间产物展示](references/notebook-cells.md#关键中间产物)。完整日志与 JSON 留在已有证据文件。成熟 SDK、数据和硬件接口按需复用,独立脚本或部署包按用户需要另行导出。正常 Run All 不生成或覆写项目 Python 源码。每轮移出重复、过时和无关单元,保留用户内容与原始证据。使用宿主可用的 `ponytail` 精简实现,使用 `asd-ste100` 的清晰表达原则编写短说明。

## 提问、授权与验收

- 能从材料查到的事实由 Agent 查证。普通可逆的实现选择由 Agent 在授权内决定,必要时注明依据。
- 只对会实质改变研究问题、机制、公平性、结论范围、权限或主要成本的未决项提问。真实缺少费用、设备或数据授权时,一次说明最小核心比较所需范围、后果和建议;已有决定直接沿用。
- 计划采用、执行方式、推进节奏、科学判断和用户接受分别保留实际来源与范围。自动长运行授权只改变由谁发起运行,不改变 Notebook 载体和当前步反馈点。用户明确要求连续推进时,才在其采用范围内越过逐步停点;关键结果仍及时写入主 Notebook。同一句原话可覆盖其明确表达的多项决定,沉默、测试通过或 Agent 推荐不能代替用户决定。
- “继续”推进已采用路线的下一个步骤;修改意见留在当前步骤原位完善;“暂停”保存当前内容。依赖的手动运行结果尚缺时,说明需要运行哪一格,不代替用户补跑长任务。新增科学设计、投入或权限超出原范围时再解决缺口。
- 每步交付是研究讨论与教学反馈点。结合当前观察,给用户一个针对目标场景、解释或比较需求的反馈入口;不要只让用户选择“继续/修改”。有真实未决取舍时提出一项会影响本步的问题并等答复,依赖该答复的实现随后再做;已有条件不重复确认。反馈不作为理解考试。实际状态、资源许可和长任务边界分别保留。

默认只保留本地。远程备份和推送按用户实际授权的目标与范围执行,缺少目标或分支时才补问。已有远程配置不代表允许推送。详见 [Git 规则](references/git-policy.md)。

## 最短实现与验证循环

### 1. 确定最小路线

引用已有协议,简述当前假说、方法与对照、输入、主指标和判定依据。首步优先让一项实际输入经过关键方法,得到可解释的观察;短操作可合并,不按准备、切分或函数名称机械拆回合。依赖长任务时,交付完整待手动路径并标明未测。已有路线直接接续,新路线等待用户采用后实施。

MVP 只细化当天检验核心假说所需的步骤,后续扩展保留概要。步骤确认后先创建或更新 Notebook,不等待完整实验、远程环境或全部接口检查完成。预期示例、文献结果和本项目实测分别标明。实验取舍按需读取 [研究工作流](references/research-workflow.md)。

沿用实际设备、数据、费用和停止条件。方法、对照、失败与重试共同计入资源。缺口只阻断相应运行,当前代码与文档先保存。预计超过 60 秒或耗时未知的单个代码格默认由用户手动运行。已有明确的自动长任务授权直接沿用;单有费用或设备许可不代替执行方式授权。

### 2. 实现并保存当前步骤

Notebook 一级标题说明 idea,二级标题对应采用的步骤,三级标题组织步内小节。步首承接前一步的实际观察或待运行状态,指出本步补哪项缺口、为何服务核心假说;步尾解释当前回答和下一步仍需什么。

只读取当前步骤需要的材料与相关实现。按概念把定义、当前输入调用和必要观察放在相邻单元;不要用一个总入口把多个采用步骤合成一次不可交互运行。是否需要分块取决于工作语义,不按函数名或行数机械判断。先保存当前步骤并给出文件入口,再使用已经知道的执行环境。一次快速检查未发现可用环境,就交付待运行代码;不遍历系统或其他项目寻找环境。先交付文件。用户已要求网页或实时输出时,继续完成服务、登录和页面核验;这些工作不延后到下一轮研究步骤。未来步骤保留概要;用户修改与原始证据继续保留。

关键科学逻辑应读得懂,并与实际运行对应。代码使用统一研究名称、直白控制流与必要注释;细节见 [代码可读性](references/code-style.md)。保留输入边界校验、权限检查、资源释放和防止数据丢失的处理。新增检查、异常捕获或重试须有实际输入、已知失败或明确需求依据,不能吞错后返回成功。

### 3. 有限短测或交给用户运行

只自动测试当前采用步骤中已授权、预计每格能在 60 秒内完成的代码。每格独立计时;多个短格累计可以超过 60 秒,内核启动另设有界超时。某格超时后保存部分输出并停止后续格,不后台等待或自动重试。单格预计超过 60 秒或耗时未知时,默认交付完整代码、阶段输出说明、运行入口和结果位置供用户运行;已有明确自动长任务授权时按该范围执行,不重复询问。不把一个长任务机械拆格来规避边界。

短测单元用 `quick-check` 标记,长任务用 `manual-run`,依赖待手动结果的单元用 `requires-manual-run`。这些标签是执行工具的约定,不会阻止 Jupyter 自身的 Run All。含手动任务的 Notebook 引导用户逐步运行。Paper Factory 的短测入口及独立使用方式见 [Notebook 指南](references/mvp-notebook.md)。

用真实输入片段、关键变换、中间预测、进度与指标显示过程。手动和 Agent 自动运行均通过主 Notebook 对应的 Jupyter session/kernel 执行单元;读取 `.ipynb` 后用普通 Python 的 `exec`/`eval` 或后台脚本重放,不是本流程的 Notebook 执行。需要实时输出时,使用用户页面所属内核;阶段、工具事件与可读正文及时刷新,同时保存完整日志。外部工具逐行或逐事件转发,不能整段捕获到结束才显示。离线短测写回文件只证明该次检查,不代表页面已收到实时输出。已在运行的任务复用现有日志观察,不重复启动。短测与既有证据分别标明;未运行内容不填入实测结果。测试检查实现,科学判断等待对应实验结果。

### 4. 交付当前步并等待反馈

本步存在关键数值比较时,主动生成有助判断的图;少量精确值可用可读表格。数据未就绪时交付可运行的绘图或表格代码,并保持待运行。完成态的关键比较不能只留下日志、JSON 或口头结论。核心图或相关图组后安排 Markdown 分析:关键数值如何由本次观测得到、为何呈现该结果、它支持或限制核心 idea 的哪一部分,以及下一动作。使用代码、计数、公式或代表性案例支撑解释;原因尚未验证时标明假说。变化数值由代码输出生成,文字讲清含义与机制。保留必要推理,删去重复表格与无关细节;未来实验采用后细化。可信负结果或证据不足同样可以完成当前比较,科学效果不作为测试必须达到的断言。

导航摘要给出当前问题、实际状态及文件/现有网址,保持可扫读。进展优先说明研究上发生了什么、意味着什么、用户现在能查看什么;纯用量变化合并到日志。聊天回应上一反馈和本次观察,邀请针对当前证据、场景或实现需求的具体反馈;默认结束当轮,原位整合后再推进。明确的连续推进授权按其范围沿用。

### 5. 修订与恢复

当前步骤范围内的实现或评测错误沿用授权修复,只重验可短测的受影响部分。改变假说、方法、对照、结论范围或主要投入时,说明影响并更新对应决定。纯文字反馈只修改相关 Markdown,保留代码、输出与测量,不重跑实验或重复浏览器核查。

恢复会话时读取当前步骤、已保存 Notebook、短测或待手动状态及下一动作,不重建项目或补造历史确认。无法确定会影响当前动作的授权时再澄清。变化后保留仍适用的确认,独立结果目录避免覆盖原始证据。

## 记录与可选状态工具

教学模式的阅读入口是当前 Notebook。当前问题、可见实现与结果就近写在相关单元;在已有 `.research/session.md` 简记采用路线及来源、当前步骤、Notebook 位置、运行状态、本步反馈或待反馈状态及下一动作,完整配置、诊断和原始运行证据保存在既有文件。已有科学协议直接引用,只更新变化内容。

分文件模式或已启用 CLI 的项目沿用 `mvp-design.md`、`technical-plan.md`、`plan.md` 和步骤记录。模板在 `assets/`,只填当前适用内容。使用既有文档的参考指南时,教学模式把相应内容写入 Notebook 或会话记录;不用逐项创建同名文件。

可选命令 `python3 <skill>/scripts/workflow.py --help` 记录实际决定与证据,执行时将 `--repo <project>` 放在子命令前,详见 [CLI 约定记录](references/alignment-mcq.md)。CLI 状态不产生授权或验收,也不追加用户问答;若结构不能表达已授权的比较,保留原状态,在会话记录中简记并交付当前步骤。不得补造接受来解锁状态;用户明确要求的暂停和验收节点仍须遵守。

`verified --result pass` 表示执行与证据核对有效;`--finding supports|does-not-support|inconclusive|not-assessed` 分别记录科学判断。既有软件任务沿用原计划,新软件任务可使用 `init --focus software`。可选编辑钩子见 [守卫配置](references/guard-setup.md),其工具覆盖不等于操作系统沙盒。设计依据见 [来源说明](references/design-basis.md),使用时无需重新调研。

发送前内部核对:路线有实际采用来源;当前步与核心问题、前后证据的关系清楚;定义、调用和观察便于连续阅读;关键比较有适当图表和有依据的分析,或完整待运行代码;主 Notebook 状态同步,反馈点与推进授权一致。
Files in this package (5)
  • .gitignore 1 KB
  • LICENSE 1 KB
  • README.md 15 KB
  • README.zh-CN.md 14 KB
  • SKILL.md 14 KB

Versions

The database has no other skills named step-by-step-coding.

Database snapshot: 13.11.2026 · package version 412622cdfb7b (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100coding
    Implements or changes application code in this repo, step by step with a self-check. Use when adding a feature, changing behaviour, or refactoring code under src/.
  • 100explain-step-by-step
    Use when the user asks for a detailed, beginner-friendly, or step-by-step explanation; wants to understand how or why something works; asks to unpack a concept, issue, PR, code change, system, error, document, or technical decision; or says to explain it like teaching a child.
  • 84execute-plan
    Execute implementation plans step-by-step. Use when user says "execute the plan", "implement the plan we created", "start building based on the plan", "go ahead and implement it", "proceed with the implementation", "execute as a stack", "create a PR stack while implementing",…
  • 100dx-step
    Execute the next pending step in implement.md — implement, test, review, commit, update status. Use to go one step at a time ('next step').
  • 100notebook-exercises
    Add self-checking exercises after each topic in Jupyter lesson notebooks. Each question gets a stub cell and a check() cell that compares the answer against a stored hash, so solutions never appear in the notebook. Use when asked to "add exercises", "make practice questions", or…
  • 90step-by-step-web-project-builder
    Activate for building or scaffolding web apps when the user is learning (e.g., todo apps, portfolios, dashboards).

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.