step-by-step-coding
/step-by-step-coding
面向科研初学者的逐步编程与实验伙伴。接续已有研究包和协议,围绕核心假说设计、实现与解释最小判别性比较。使用可交互 Notebook、真实运行及可复查证据推进 MVP,帮助用户掌握关键实现、实验取舍与资源投入。
- Author
- hzxwonder ↗
- Repository
- step-by-step-coding ↗
- Licence
- MIT
- Last repository change
- 04.11.2026
Assessment and security
- Files in this package
- 5
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 04.11.2026, without references to retired models or APIs.
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
- 接续当前研究
- Notebook 教学与交付
- 提问、授权与验收
- 最短实现与验证循环
- 记录与可选状态工具
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).