c456-cli 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,65 @@
1
+ ---
2
+ name: c456-sync-public-markdown
3
+ description: >-
4
+ 撰写或修订 c456-sync/ 下将上行 C456 的 Markdown:正文为媒体级对外稿,不写正文一级标题、不写制作备忘与仓库内部路径;总括与结论写在首节正文段中,不用「## 一句话结论」等标签式二级标题。
5
+ 在编写 tool/signal/channel 的 c456-sync 镜像、或执行 c456 intake update 的 --body-file 前使用。
6
+ ---
7
+
8
+ # c456-sync 对外正文(C456 镜像层)
9
+
10
+ `c456-sync/` 中的正文会与 C456 `intake` 正文一致,读者包含站外陌生访客。须与 `wiki/` 的「笔记、线索、本地路径」写法区分。
11
+
12
+ ## 1. 标题:只在 Frontmatter
13
+
14
+ - **禁止**在正文开头使用 `#` 一级标题重复 `c456-title`(或 tool 标题)。C456 页面标题来自元数据,正文再写会 **重复展示**。
15
+ - 正文从 **二级标题 `##`** 起,或从导语段落 / 配图起。
16
+
17
+ ## 2. 禁止出现在对外正文中的内容
18
+
19
+ 以下内容视为 **对内/草稿/制作备忘**,不得写入 `c456-sync/` 正文(含上行用的 `--body-file`):
20
+
21
+ - 章节名如「配图(对照页首屏)」「以下为截图」等 **工序标签**;可改为直接呈现信息,用 **一句公众导语** 或 **加粗 + 外链 + 图** 完成「图说」。
22
+ - **标签式总括标题**:如 `## 一句话结论`、`## TL;DR`、`## 核心观点`(小节里只有一句判词的那种)。**判断句写进第一节正文**(首段或次段),`##` 留给有展开内容的主题(产品名、对比轴、具体问题等)。
23
+ - **视口、截图日期、截图命令**(如 `c456 screenshot`)、**素材库 ID 文案**(如「素材 c456:asset/63」)、**仓库相对路径**(如 `raw/tools/...`、`c456-sync/...`、`wiki/...`、`output/...`)。
24
+ - 「与本地镜像一致」「参见本仓库信号」等 **仅仓库读者** 能理解的指代。
25
+ - 竞品索引里 **仅本地可用的链接**(如 `../signal/...md`);对外只保留 **https://c456.com/intakes/<id>** 或公开官网 URL。
26
+ - **来源块前**不要单独插入整行 `---`(会渲染为横线);与上一节用空行或自然段落收束即可。
27
+
28
+ 说明:Markdown 图片语法 `![alt](url "title")` 里 **title** 字段若需保留 `c456:asset/<id>` 供平台识别,可以保留;**正文中不要再用自然语言解释 asset ID**。
29
+
30
+ ## 3. 配图:媒体级呈现
31
+
32
+ 推荐形态(示例):
33
+
34
+ ```markdown
35
+ *[Logto](https://logto.io/) — 官网首页。*
36
+
37
+ ![Logto 官网首页](https://c456.com/our-assets/.../....png "c456:asset/63")
38
+
39
+ *[Clerk](https://clerk.com/) — 官网首页。*
40
+
41
+ ![Clerk 官网首页](https://c456.com/our-assets/.../....png "c456:asset/66")
42
+ ```
43
+
44
+ - 每张图前用 **一行斜体或加粗 + 外链** 作公众图说即可。
45
+ - **不要**单独开「配图」二级标题专门描述拍摄过程。
46
+
47
+ ## 4. 与 wiki/ 的分工
48
+
49
+ - **`wiki/`**(含 `wiki/sources/`)可保留 Wikilink、`[[...]]`、本地路径、调研笔记、`来源:C456 收录` 等,便于 Obsidian 内导航。
50
+ - **`c456-sync/`** 在发布前应 **自检一遍**:假设读者从未打开本仓库,是否仍自洽、专业、无内部噪音。
51
+
52
+ ## 5. 上行前检查清单
53
+
54
+ - [ ] 正文无 `# ` 一级标题
55
+ - [ ] 无 `raw/`、`wiki/`、`output/`、`c456-sync/`、`c456 screenshot`、视口尺寸等字样
56
+ - [ ] 无「配图(…)」类工序标题(除非改为公众向小节名,如「产品概览」且内容无制作信息)
57
+ - [ ] 对外链接均为 **https** 公网 URL 或本站 intake 链接
58
+ - [ ] 编辑性措辞用公众语言(少用「观察:」类内部批注腔,可改为「实践中」等)
59
+ - [ ] 对比/评测类正文:无空洞帽子段与对称废话;关键句有依据或场景;「不适合谁」与「以官网为准」出现得恰到好处(可对照 [.cursor/skills/c456-signal-product-vs/SKILL.md](c456-signal-product-vs/SKILL.md) 第 4 节)
60
+ - [ ] 文末 **来源** 块前无单独一行的 `---`(避免误渲染为分割线)
61
+
62
+ ## 6. 参考
63
+
64
+ - 仓库总规范:[AGENTS.md](../../AGENTS.md) §1.3
65
+ - C456 CLI:`c456 signal update`、`c456 tool update` 的 `--body-file` 应使用已按本技能清理后的正文。