Longflow Manifesto技术篇:独立工程师自我修炼的10条代码原则清单
【免费下载链接】longflow-manifesto:coffee: The longflow manifesto项目地址: https://gitcode.com/gh_mirrors/lo/longflow-manifesto
The Longflow Manifesto 是一份面向独立工程师和严肃软件开发者的软件工程工作流宣言,主张"工程优先",并从中提炼出 10 条可直接落地的代码原则清单。它不教你写某门语言,而是告诉你:如何用长期思维管理时间、任务与代码质量。
Longflow Manifesto 是什么?
Longflow(长流)方法论的核心只有一句话:
一切都要以长期目标为前提来做。
它诞生于作者对 "Agile/Scrum" 式流程的反思:频繁的站会、冲刺、估算和截止日,往往让工程师产出"最不太坏"的代码,而不是"最好"的代码。
宣言的原文保存在 README.md 中,项目还附带了葡萄牙语版和俄语版译本,并采用 LICENSE(MIT 协议)开源,欢迎自由修改。
如何获取并阅读这份宣言
获取仓库只需一条命令:
git clone https://gitcode.com/gh_mirrors/lo/longflow-manifesto打开README.md,全文不长,10 分钟就能读完。建议先读"管理篇"和"技术篇"两节清单,再对照自己的日常流程逐条自查。
时间观:Longflow 的第一性原理 💡
在开始清单之前,必须先理解 Longflow 对"时间"的三个判断,它们是 10 条原则的根基:
- 时间 ≠ 工作量。投入时间与产出呈对数关系:前期优化收益递减,而好的重构能用中等时间换取长期指数级回报。
- 估算应尽量避免。除了极小的任务,软件工作几乎无法给出有意义的估算,估算只会制造压力和内卷。
- 基于时间的会议毫无意义。每周例会隐含"所有任务同等重要、进度必须匀速"的假设,这是毁掉创造力的捷径。
独立工程师的 10 条代码原则清单
以下 10 条原则整理自宣言的"技术篇"(README.md 的 "Technical" 小节),可直接打印贴在工作台:
| # | 原则 | 一句话解释 |
|---|---|---|
| 1 | 以长期目标思考 | 每个动作都问一句:这对三年后还有价值吗? |
| 2 | 自选任务 | 自己认领任务,而不是被动领单 |
| 3 | 先修 Bug 再加功能 | 在程度上控制,优先偿还技术债 |
| 4 | 先清理代码库再上新功能 | 保持代码库整洁,再往上叠新东西 |
| 5 | 写尽可能好的代码 | 质量无限高于数量和截止日期 |
| 6 | 不害怕尝试不同的做法 | 别把"一直这么写"当理由 |
| 7 | 多想少写 | 下笔之前,先让问题想透 |
| 8 | 保持好奇,持续学习 | 学习本身是工作的一部分 |
| 9 | 不害怕延迟,也不害怕失败 | 长期主义者的底气 |
| 10 | 远离"cargo-cult"编程 | 别因为别人用就盲目照搬 |
原则 1:始终以长期目标思考
这是 Longflow 的总纲。它不反对原型,也不反对优化,只反对"为了快而快"。宣言的原文写得很清楚:质量有价格,价格是时间。
原则 2:自己挑选任务
让工程师自主认领中大型、有意义的任务,才能同时锻炼技术能力和问题解决能力。被动领小任务的人,永远长不出判断力。
原则 3:先修 Bug,再加功能
"在程度上"(to an extent)是关键限定词——不是无限清债,而是保持一个健康的节奏:新功能落笔之前,先看一眼旧账。
原则 4:先清理代码库,再引入新功能
与原则 3 互为表里:功能叠加之前,让相关模块的代码先变得可读、可维护。整洁的代码库是最便宜的"基础设施"。
原则 5:写出尽可能好的代码
质量无限高于数量。
独立工程师没有"截止日期"施压,你唯一的对手是昨天的自己。目标不是"能跑",而是"可读、优美、正确"。
原则 6:不害怕尝试不同的东西
"一直这么做"是最贵的理由。对同一个问题拥有多种解法,是优秀工程师的核心竞争力。
原则 7:多想少写(Think more, write less)
宣言建议:开始之前先不写代码,先问自己三个问题:
- 这真的有一个需要解决的问题吗?
- 这段代码我能改进吗?
- 有没有我当初本该换个方式完成的任务?
原则 8:保持好奇,永远在学习
压力和"尽快发布"是好奇心最大的敌人。允许自己花时间研究新工具、新概念——这种投入会在未来的项目中成倍回报。
原则 9:不害怕延迟,也不害怕失败
宣言同时列出了"don't fear running late"和"don't fear to fail"。当你以长期目标为准绳时,单次任务的早晚和成败,都不构成对自我价值的评判。
原则 10:像躲避瘟疫一样躲避 cargo-cult
Cargo-cult(货舱崇拜)指不懂原理、只抄形式的模仿:跟风上微服务、跟风写某种架构。宣言在管理篇和技术篇各警告了一次,可见其重视程度。
Longflow 工程师的典型工作流
宣言给出了一个"典型实现",看似随意,实则极其灵活。它允许在任何一步回头,这正是它质量好的原因:任何人都可以在任何时间改进代码库的任何部分。
- 挑选或创建一个任务
- 花几分钟到几天思考它:需要吗?做过类似的吗?它达成什么目标?
- 如果任务不需要 → 回到第 1 步
- 完成任务需要先学的东西,去学
- 想学的新东西,也去学
- 再想一遍任务(学习可能改变你的判断)
- 动手做(任何时候可以回到第 2 步)
- 完成任务
- 再复盘一遍
- 任务"完成",但随时可以重开循环
新手如何开始使用这份清单 🚀
- 第一步:把 10 条原则打印出来,本周每天对照检查一次自己的提交。
- 第二步:挑出违反频率最高的 1~2 条(通常是"先加功能后还债"和"少想多写"),下个月只改这一个习惯。
- 第三步:每月末花 30 分钟回顾:这个月有没有为自己安排"学习时间"?
Longflow 不是一套要一次性装进流程里的重型框架,而是一份贴在墙上的自检清单。坚持得越久,代码库的复利效应就越明显。
总结
Longflow Manifesto 用一份极简宣言回答了一个问题:独立工程师如何在没有冲刺、没有估算、没有截止日期压迫的环境下,持续产出高质量代码?答案是长期目标、自选任务、多想少写,以及一份可以随时对照的 10 条代码原则清单。
【免费下载链接】longflow-manifesto:coffee: The longflow manifesto项目地址: https://gitcode.com/gh_mirrors/lo/longflow-manifesto
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考