mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-11-02 10:46:29 +00:00
docs: readme - add v1 collection explanations (#182)
This commit is contained in:
@@ -6,7 +6,7 @@
|
||||
- 只组织现有资产;三域为`.github/context/`、`.github/skills/`、`.github/extensions/`,域内对象平铺。包内部源码、资料集合与共享实现不另算新的一级资源分类。
|
||||
- 根`README.md`是唯一主页;`.github/README.md`禁止创建。`llms.txt`是AI短入口;大资料按需读取,不全部注入系统上下文。
|
||||
- 读者按问题、设计、实现、代价及比较/共性/适用条件理解工具;Lambda记号只辅助表达输入输出与组合,不证明纯函数、正确、确定或终止。
|
||||
- 功法与法器441个对象的活动说明使用`.github/context/assets/templates/tool-explanation-template-v1.md`:保留v0的15项并新增“结论、连接规则、依据”,共18项;v0仅作历史模板。第16项为主张、第18项为事实依据、第17项须按图尔敏模型写明从证据到主张的具体推理规则;不得用字段交叉引用冒充连接规则。不得用AI自拟版本替代已登记模板,不借模板迁移改写原15项、来源或评级。主页集合级说明仍按既有15项结构展示。
|
||||
- 功法与法器441个对象的活动说明使用`.github/context/assets/templates/tool-explanation-template-v1.md`:保留v0的15项并新增“结论、连接规则、依据”,共18项;v0仅作历史模板。第16项为主张、第18项为事实依据、第17项须按图尔敏模型写明从证据到主张的具体推理规则;不得用字段交叉引用冒充连接规则。不得用AI自拟版本替代已登记模板,不借模板迁移改写原15项、来源或评级。主页集合级说明也按活动v1模板18项名序组织;作为集合摘要,第16–18项仅陈述集合层级可核的结论、推理与依据,不合并或替代对象级说明。
|
||||
|
||||
## 目录职责
|
||||
|
||||
@@ -83,7 +83,7 @@ Lambda演算已按用户要求加入功法,品级天级上品(现行`tian-ad
|
||||
## 首页与文档约定
|
||||
|
||||
- 根README不恢复AI推荐摘要、选择理由、维护验证、参与贡献或许可证正文块;AI两块仍维护于`llms.txt`,贡献者名单与鸣谢迁至`.github/CONTRIBUTORS.md`,许可文件保留。
|
||||
- 首页将“⚡ 1 分钟快速开始”和“📺 演示与产出”收进“📌 字多不看”,两者保留各自默认收起层,演示区内部子区块折叠深度不变,正文只移动不改写;其后依次展示“📚 功法体系”和“🧰 法器体系”。“🗂️ 项目目录结构概览”继续位于演示区内部;“✨ 支持项目”和“📞 研究交流”区块不再保留;Star 呼吁句置于“返回顶部”链接之后。两个集合级首页说明仍按既有15项结构组织;数据中441个对象则使用v1的18项说明。每个首页对象独立使用一张严格Markdown表格;无来源依据的集合级信息标明待核,不作推断。
|
||||
- 首页将“⚡ 1 分钟快速开始”和“📺 演示与产出”收进“📌 字多不看”,两者保留各自默认收起层,演示区内部子区块折叠深度不变,正文只移动不改写;其后依次展示“📚 功法体系”和“🧰 法器体系”。“🗂️ 项目目录结构概览”继续位于演示区内部;“✨ 支持项目”和“📞 研究交流”区块不再保留;Star 呼吁句置于“返回顶部”链接之后。两个集合级首页说明按活动v1模板18项名序组织;数据中441个对象也使用v1的18项说明。每个集合独立使用一张严格Markdown表格;第16–18项只作集合层级归纳,不复制对象级说明;无来源依据的集合级信息标明待核,不作推断。
|
||||
- 方法历史栏目与六命题仅保留旧锚点,正文进入功法;不恢复独立经验/哲学/道法术器分库或首页正文副本。
|
||||
- 功法、法器块使用同级原生details默认折叠。顶部徽章只保留独立目的地,不重复同一目标;路径与文案须反映真实新资源,不把JSON称为活动Excel。
|
||||
- `.github/lint_config.json`是格式规则;`.gitattributes`仅将原第三方来源及其对应HTML标为vendored,不标记整个Extensions。
|
||||
|
||||
@@ -111,7 +111,7 @@ pi --skill .github/skills
|
||||
### 🗂️ 项目目录结构概览
|
||||
|
||||
资源只有三个域;下面列出域边界与Context的全部9个集合,不展开各原生包内部源码。完整对象分别在三个域的README中导航。
|
||||
功法与法器441个对象的活动说明使用[工具解释模板v1](.github/context/assets/templates/tool-explanation-template-v1.md):保留原15项并新增“结论、连接规则、依据”,共18项;每个对象独立使用一张严格表格。v0仅作历史模板;下方集合级首页说明仍保持既有15项结构。
|
||||
功法与法器441个对象的活动说明使用[工具解释模板v1](.github/context/assets/templates/tool-explanation-template-v1.md):保留原15项并新增“结论、连接规则、依据”,共18项;每个对象独立使用一张严格表格。v0仅作历史模板;下方两个集合级首页说明也按v1的18项名序填写,集合摘要不替代对象级说明。
|
||||
Extensions当前保留17个一级对象;用户点名的8项程序/配置/图文文件已移除,历史资料不代表当前可用入口。
|
||||
原Actions定义已移入Extensions保全,自动CI、打标签及欢迎流程已停用;本地`make test`保留。
|
||||
|
||||
@@ -322,6 +322,9 @@ gantt
|
||||
| 13 | 比较不同技术与方法。 | 应在同一问题和适用条件下比较具体条目;不同任务中的效果或品级不能直接互比。 |
|
||||
| 14 | 提炼共同规律。 | 当前可归纳的共同做法是先看问题,再选择方法;不把目录归类或已有初评当作统一效果证明。 |
|
||||
| 15 | 明确这些规律成立的前提与适用条件。 | 选择依赖具体任务和条目的适用条件、限制;文集归并不等于全部内容已经逐条登记,已有初评也不等于正式效果验证。 |
|
||||
| 16 | 结论 | 当前登记411项逐对象说明;每项结论仅在相应对象身份和第15项条件内成立,不合并为全集合的统一效果或正式评级主张。 |
|
||||
| 17 | 连接规则 | 说明载荷按对象身份把第15项边界、第16项结论和第18项依据绑定在同一记录中;因此集合层只能汇总记录范围,不能跨条目拼接局部推理推出普遍效果。 |
|
||||
| 18 | 依据 | 逐项事实依据与边界由唯一[功法数据源](.github/context/gongfa/data.json)第18项维护,浏览见[生成总表](.github/context/gongfa/README.md#全部记录);本集合摘要不复写或替代对象级依据。 |
|
||||
|
||||
</details>
|
||||
|
||||
@@ -348,6 +351,9 @@ gantt
|
||||
| 13 | 比较不同技术与方法。 | 30 项分级比较的是 Vibe Coding 重要性,不是质量或效能;方案比较须限定同一任务、对象层级和适用条件。 |
|
||||
| 14 | 提炼共同规律。 | 应分别核对对象身份、重要性、当前运行状态、许可和效果证据;其中一项不能替代其他项。 |
|
||||
| 15 | 明确这些规律成立的前提与适用条件。 | 当前 30 项按重要性暂分天阶 4 项、地阶 12 项、玄阶 9 项、黄阶 5 项;重要性不代表实现质量、运行可用性或效能验证。正式效能量表仍为草案,评级尚未完成。 |
|
||||
| 16 | 结论 | 当前登记30项对象说明;每项结论只覆盖其固定来源和第15项条件,不把重要性分级解释为当前可用、有效或获许可。 |
|
||||
| 17 | 连接规则 | 重要性分级只记录对象在项目中的相对角色,静态来源选区只记录固定版本范围;两者都不是目标环境的安装、运行、效果或许可证据,故不能推出这些状态。 |
|
||||
| 18 | 依据 | 每项的来源、版本、选区与边界由唯一[法器数据源](.github/context/faqi/data.json)第18项维护,浏览见[法器总表](.github/context/faqi/README.md#法器总表);本集合摘要不代替对象级依据。 |
|
||||
|
||||
</details>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user