c456-cli 0.4.0 → 0.6.0

package/skills/c456-signal-researcher/SKILL.md

@@ -0,0 +1,169 @@
+---
+name: c456-signal-researcher
+description: >-
+  Drafts C456 signals in a news-researcher voice: verified facts, independent value judgment, links to existing intakes, end-of-article source block; routes to product-vs or channel article skills when the piece is a deep compare or long intro.
+  Use when writing signals, news intakes, or industry updates in this wiki repo (c456-sync / C456).
+disable-model-invocation: true
+---
+
+# C456 信号研究员（Signal Researcher）
+
+## 定位
+
+目标不是「记一条笔记」，而是 **让读者在短时间内做决定**：这条消息值不值跟进、对谁有意义、和站上已有内容怎么拼在一起。
+
+动笔前心里过三个问题即可：
+
+1. **发生了什么**——能核对吗？日期、主体、数字是否齐？
+2. **为什么值得看**——对谁、在什么约束下有用？不是替厂商喊口号。
+3. **和咱们已有内容什么关系**——接续、打脸、还是补一句背景？没有就说没有。
+
+对外正文版式须同时遵守 [.cursor/skills/c456-sync-public-markdown/SKILL.md](../c456-sync-public-markdown/SKILL.md)。
+
+## 信号结构
+
+### 1. 导语（1～3 句）
+
+先用 **人话** 交代事件 + 对你这类读者意味着什么。十秒钟内要能判断：还要不要往下读。  
+避免「在数字化浪潮下」「值得注意的是」这种零信息开篇。
+
+`c456-sync` 对外稿若用 `##` 分节：**核心判断写在第一节下的正文段落里**（可与导语同段或紧接一段），**不要**单开 `## 一句话结论`、`## TL;DR` —— 标签标题一眼像生成文。
+
+### 2. 事实描述（2～5 段）
+
+- 谁、做什么、什么时间、对哪条产品线/用户群生效。
+- 版本号、价格、配额、发布日期等 **硬事实** 跟紧；吃不准就写 **「以官方最新说明为准」** 并指 URL。
+- 官网通稿可以读，成稿时 **改写** 成读者要用的信息密度；不要整段复制营销句式。
+
+段落之间用一句短承接（「这次更新真正会影响到的是……」）比纯列表更像活人写的。
+
+### 3. 价值分析（核心）
+
+信号和「转载摘要」的差就在这里：**你有没有自己的判断**。
+
+| 分析维度 | 自问 |
+|----------|------|
+| **行业** | 这条是噪声还是范式变化？有没有更可验证的旁证？ |
+| **读者** | 谁该盯？ small team / 企业 / 开源用户——别假装「所有人都该关心」。 |
+| **时机** | 现在就该动手试，还是先放进观察清单？ |
+| **边界** | 哪些是厂商叙事、哪些是我们从材料里推出来的？哪里留白？ |
+
+少写对称废话（「不仅……而且……」信息量为零就删）。一句短结论 + 一两句依据，通常就够。
+
+### 4. 关联研究
+
+**必做**：搜一圈已有内容，回答「这条和站上已经有的东西怎么接」。
+
+- 已有 **signal**：继承、反驳、还是补充同一条线？
+- **tool**：会不会改写某个工具的采用/定价/风险画像？
+- **channel**：是不是某个创作者或团队的可核验动态？
+- **playbook**：有没有让某套打法过时或变难？
+
+翻完 **没有发现硬关联**，就老老实实写一句：暂未发现与现有收录的直接关联，后续可再跟。别硬拗联系。
+
+### 5. 读者行动（1～2 句）
+
+给一个 **单一清楚的下一步**：读哪篇 doc、开哪个试用、关注哪个 changelog——别列一串 equally important 的链接糊弄过去。
+
+### 6. 来源（正文最末，固定块）
+
+主体正文与来源块之间 **空一行** 即可。**不要** 在 `**来源**` 前单独写一行 `---`：在 Markdown 里那是水平线，不是 Frontmatter；也容易让版面像「没粘干净的元数据」。
+
+```markdown
+**来源**：[标题](URL) · 作者/团队 · YYYY-MM-DD
+
+**延伸阅读**：
+- [标题](URL) · 简述
+- [标题](URL) · 简述
+
+**相关收录**：
+- C456 #id 信号/工具/渠道：[标题](https://c456.com/intakes/id)
+```
+
+## 调研流程
+
+### 第一步：事实核查
+
+| 优先级 | 渠道 | 干什么用 |
+|--------|------|----------|
+| **P0** | 官方公告、官博 | 定调、日期、产品名 |
+| **P1** | 文档、Changelog、GitHub Releases | 技术细节、行为变化 |
+| **P1** | 严肃科技媒体 | 外部视角，仍须回 P0 对关键事实 |
+| **P2** | HN、Reddit、X 等 | 摩擦点、舆情，标成社区视角 |
+| **P3** | 第三方解读 | 借问题意识，**结论自己用 P0 重核** |
+
+### 第二步：关联扫描
+
+翻 `c456-sync/`（以及本仓库 `wiki/`）：
+
+1. 工具名 / 人名 / 技术栈关键词
+2. 同主题过往 signal
+3. 可能被牵连的 tool、channel 条目
+
+### 第三步：要不要叫别的技能
+
+| 信号类型 | 技能 | 何时用 |
+|----------|------|--------|
+| 两家产品 **深度对比** | [c456-signal-product-vs](../c456-signal-product-vs/SKILL.md) | 主干就是选型对照，篇幅与 P0 覆盖按该技能来 |
+| 单工具/单渠道 **长叙事介绍** | [c456-product-channel-article](../c456-product-channel-article/SKILL.md) | 主干是「讲清楚一个产品或一个人」 |
+| 事实缺口大 | WebFetch 等独立调研 | 官稿太薄，补背景但仍回落到可核对来源 |
+| 普通动态 | 本技能独立完成 | 事实链清楚、影响一句话能说圆 |
+
+默认 **别过度叠技能**。只有真要做深度对比或长介绍时，再挂别的 SKILL。
+
+写 **产品 vs** 对比稿时，`c456-signal-product-vs` 里对 **对外语气** 有单独一节，与本技能一并满足。
+
+## 配图规则
+
+若材料里有 **肉眼可懂的界面、对比表、架构示意**，可以主动截图进正文；纯文字公告不必硬截。（CLI：`c456 screenshot`、`c456 asset upload`，详见全局 c456-cli 技能。）
+
+### 什么时候值得截
+
+| 值得 | 不太值得 |
+|------|----------|
+| 官网友好首屏、关键功能界面 | 全文纯文字声明 |
+| 对比表、架构图、定价档位 | 只有一个孤立数字 |
+| 可复述的性能对比页 | 论坛吵架帖 |
+
+### 怎么截、怎么传
+
+1. **截图**：`c456 screenshot <url> -o .tmp/xxx.png`  
+   - 首页/落地页：**视窗**即可，默认不加 `--full-page`。  
+   - 定价、长文再考虑 `--full-page`。
+2. **上传**：`c456 asset upload -f .tmp/xxx.png`
+3. **塞进正文**：紧跟相关段，媒体级图说；正文里 **不讲** 截图命令、视口、素材 ID 叙事（平台用 `title` 里的 `c456:asset` 即可）。
+
+### 插入格式示例
+
+```markdown
+*[Pinecone Nexus 架构](https://www.pinecone.io/blog/introducing-nexus-knowledge-engine/) — 知识引擎架构图。*
+
+![Nexus 架构](https://c456.com/our-assets/.../xxx.png "c456:asset/YY")
+```
+
+- 图说：**斜体 + 外链**，陌生读者也懂指什么。
+- 不要单开「配图」小节堆工序说明。
+
+## 文风：像研究员投稿，不像模板生成
+
+- **第一句就要落地**：谁、改了什么、对谁刺痛，比「背景介绍」优先。
+- **长短句混用**：判断用短句，限定条件用从句；别全文同一句式长度。
+- **分得清事实和观点**：事实带来源；观点说清 **凭什么**（行业常识、历史类似案例、文档里的前提）。
+- **慎用空洞强调**：「重大」「颠覆性」要有可核对背书，否则改成具体变化。
+- **克制内部腔**：少写「观察：」「可以看到：」；改成「实践里常见的是……」并带场景或来源。
+- **列表与段落**：列表承载并列信息；段承担 **转折、限定、递进**——别为了「简洁」把文章磨成 bullet 墙。
+
+### 少用（除非有意反讽）
+
+记笔记口吻（「今天刷到……」）、无信息帽子段、厂商 PR 整段粘贴、假关联、满屏「可能也许」又不给核实路径。
+
+**不确定时**：写清楚依据断在哪一层（只看到官推 / 只看到二级报道），写「以官方为准」或「待二次核实」，别假装定论。
+
+## 产出前自检
+
+- [ ] 十秒内能答：发生了什么？为什么要关心？
+- [ ] 事实是否都能指回来源？
+- [ ] 价值段有没有 **你的** 判断，而不只是官稿压缩？
+- [ ] 关联段落是真翻过现有内容写出来的吗？
+- [ ] 来源块是否在底部、格式整齐？**来源** 前无孤行 `---`？
+- [ ] 读起来像 **一篇短稿**，不像 checklist 填空？

package/skills/c456-sync-public-markdown/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: c456-sync-public-markdown
+description: >-
+  撰写或修订 c456-sync/ 下将上行 C456 的 Markdown：正文为媒体级对外稿，不写正文一级标题、不写制作备忘与仓库内部路径；总括与结论写在首节正文段中，不用「## 一句话结论」等标签式二级标题。
+  在编写 tool/signal/channel 的 c456-sync 镜像、或执行 c456 intake update 的 --body-file 前使用。
+---
+
+# c456-sync 对外正文（C456 镜像层）
+
+`c456-sync/` 中的正文会与 C456 `intake` 正文一致，读者包含站外陌生访客。须与 `wiki/` 的「笔记、线索、本地路径」写法区分。
+
+## 1. 标题：只在 Frontmatter
+
+- **禁止**在正文开头使用 `#` 一级标题重复 `c456-title`（或 tool 标题）。C456 页面标题来自元数据，正文再写会 **重复展示**。
+- 正文从 **二级标题 `##`** 起，或从导语段落 / 配图起。
+
+## 2. 禁止出现在对外正文中的内容
+
+以下内容视为 **对内/草稿/制作备忘**，不得写入 `c456-sync/` 正文（含上行用的 `--body-file`）：
+
+- 章节名如「配图（对照页首屏）」「以下为截图」等 **工序标签**；可改为直接呈现信息，用 **一句公众导语** 或 **加粗 + 外链 + 图** 完成「图说」。
+- **标签式总括标题**：如 `## 一句话结论`、`## TL;DR`、`## 核心观点`（小节里只有一句判词的那种）。**判断句写进第一节正文**（首段或次段），`##` 留给有展开内容的主题（产品名、对比轴、具体问题等）。
+- **视口、截图日期、截图命令**（如 `c456 screenshot`）、**素材库 ID 文案**（如「素材 c456:asset/63」）、**仓库相对路径**（如 `raw/tools/...`、`c456-sync/...`、`wiki/...`、`output/...`）。
+- 「与本地镜像一致」「参见本仓库信号」等 **仅仓库读者** 能理解的指代。
+- 竞品索引里 **仅本地可用的链接**（如 `../signal/...md`）；对外只保留 **https://c456.com/intakes/<id>** 或公开官网 URL。
+- **来源块前**不要单独插入整行 `---`（会渲染为横线）；与上一节用空行或自然段落收束即可。
+
+说明：Markdown 图片语法 `![alt](url "title")` 里 **title** 字段若需保留 `c456:asset/<id>` 供平台识别，可以保留；**正文中不要再用自然语言解释 asset ID**。
+
+## 3. 配图：媒体级呈现
+
+推荐形态（示例）：
+
+```markdown
+*[Logto](https://logto.io/) — 官网首页。*
+
+![Logto 官网首页](https://c456.com/our-assets/.../....png "c456:asset/63")
+
+*[Clerk](https://clerk.com/) — 官网首页。*
+
+![Clerk 官网首页](https://c456.com/our-assets/.../....png "c456:asset/66")
+```
+
+- 每张图前用 **一行斜体或加粗 + 外链** 作公众图说即可。
+- **不要**单独开「配图」二级标题专门描述拍摄过程。
+
+## 4. 与 wiki/ 的分工
+
+- **`wiki/`**（含 `wiki/sources/`）可保留 Wikilink、`[[...]]`、本地路径、调研笔记、`来源：C456 收录` 等，便于 Obsidian 内导航。
+- **`c456-sync/`** 在发布前应 **自检一遍**：假设读者从未打开本仓库，是否仍自洽、专业、无内部噪音。
+
+## 5. 上行前检查清单
+
+- [ ] 正文无 `# ` 一级标题  
+- [ ] 无 `raw/`、`wiki/`、`output/`、`c456-sync/`、`c456 screenshot`、视口尺寸等字样  
+- [ ] 无「配图（…）」类工序标题（除非改为公众向小节名，如「产品概览」且内容无制作信息）  
+- [ ] 对外链接均为 **https** 公网 URL 或本站 intake 链接  
+- [ ] 编辑性措辞用公众语言（少用「观察：」类内部批注腔，可改为「实践中」等）
+- [ ] 对比/评测类正文：无空洞帽子段与对称废话；关键句有依据或场景；「不适合谁」与「以官网为准」出现得恰到好处（可对照 [.cursor/skills/c456-signal-product-vs/SKILL.md](c456-signal-product-vs/SKILL.md) 第 4 节）
+- [ ] 文末 **来源** 块前无单独一行的 `---`（避免误渲染为分割线）
+
+## 6. 参考
+
+- 仓库总规范：[AGENTS.md](../../AGENTS.md) §1.3  
+- C456 CLI：`c456 signal update`、`c456 tool update` 的 `--body-file` 应使用已按本技能清理后的正文。

package/docs/private-knowledge-base.md

@@ -1,134 +0,0 @@
-# 私人知识库：用 AI 客户端使用 C456
-
-下文前几节先把 **c456.com 账号**、本机 `**c456` 命令**、以及两个 **Agent 技能**装好，让 **Cursor / OpenCode / Trae / Claude Code** 里的 AI 能按规范代你操作 C456 与本地 Wiki；第 4 节是**第一次**在本文件夹当知识库时的初始化口令。
-
-**日常用法**：在客户端里**用对话说明意图**即可；**第一次**把某个文件夹当 C456 知识库用时，须先按第 4 节用口令初始化目录。需要访问 c456.com 时，由 Agent 在本机调用已安装的 `c456`（你不必自己背命令）。**要和线上对齐时，用下面两句口令之一即可**（可按需补充范围，例如「只同步刚改的那几页」）。想深究目录与同步规则，再点开文末技能链接。
-
----
-
-## 1. 账号（必须）
-
-1. 打开 [https://c456.com](https://c456.com) 注册并登录。
-2. 在站内创建 **API Key / 访问令牌**，复制保存（一般只显示一次）。
-
----
-
-## 2. 安装命令行（全局执行即可）
-
-```bash
-npm install -g c456-cli
-```
-
-写入密钥（把 `<密钥>` 换成上一步复制的）：
-
-```bash
-c456 config set-key <密钥>
-```
-
-检查：
-
-```bash
-c456 config show
-c456 --help
-```
-
----
-
-## 3. 安装技能（在「知识库项目」文件夹里执行）
-
-先进入你要当知识库根目录的文件夹（没有就 `mkdir` 一个再 `cd` 进去）：
-
-```bash
-cd /path/to/your-kb-project
-```
-
-需要本机能跑 `**npx**`，会用到 [Skills CLI](https://skills.sh/)。私人知识库路径须具备三类能力，对应 **三个技能**（缺一不可）：
-
-
-| 技能                | 作用                                                                                                                      |
-| ----------------- | ----------------------------------------------------------------------------------------------------------------------- |
-| **karpathy-wiki** | 本地 `raw/`、`wiki/` 等目录与编辑约定（[Karpathy Wiki](https://github.com/baklib-tools/skills/tree/main/skills/karpathy-wiki)）      |
-| **c456-llm-wiki** | 与 C456 双向同步、`c456-sync/` 等（[c456-llm-wiki](https://github.com/xiaohui-zhangxh/c456-cli/tree/main/skills/c456-llm-wiki)） |
-| **c456-cli**      | 终端 `c456` 与 HTTP API 的 Agent 说明（[c456-cli 技能](https://github.com/xiaohui-zhangxh/c456-cli/tree/main/skills/c456-cli)）   |
-
-
-```bash
-c456 skill install --with-wiki
-```
-
-## 4. 首次：初始化当前目录（第一次把本文件夹当 C456 知识库时）
-
-技能装好后，**第一次**在本机用某个文件夹承载 C456 知识库时，需要先让 Agent 按 **c456-llm-wiki** 把目录结构初始化好（例如对齐 `raw/`、`wiki/`、`c456-sync/` 等约定，具体以技能正文为准）。
-
-做法：
-
-1. 用 **Cursor / OpenCode / Trae / Claude Code** 打开你的知识库项目根目录（与上一步 `cd` 的文件夹一致）。
-2. 在 AI 对话里直接说下面这句（可照抄）：
-
-```
-基于 c456-llm-wiki 初始化当前目录
-```
-
-Agent 会按技能在该知识库项目根目录下创建或补齐所需目录与约定；完成后再按第 5 节日常放 `raw/`、对话操作即可。若该目录**早已**按技能初始化过，可跳过本节。
-
----
-
-## 5. 装好后怎么用
-
-1. 用 **Cursor / OpenCode / Trae / Claude Code** 打开你的知识库项目文件夹（若尚未初始化，先完成第 4 节）。
-2. 把资料放进 `**raw/`**（路径按技能约定即可）。
-3. 在对话里直接说你要做什么（见下一节**可复制示例**）。Agent 会按 **karpathy-wiki**、**c456-llm-wiki** 与 **c456-cli** 三个技能，在本机执行 `c456`、维护 `wiki/` 与 `c456-sync/` 等；你主要负责说清楚意图与确认结果。
-4. **需要同步内容时**，对 AI 说下面之一即可（字可以照抄）：
-  - **把本地推到线上**：「**同步内容到 C456。**」
-  - **把线上拉回本地**：「**从 C456 同步内容。**」
-
-若你坚持自己敲终端命令，见 [c456-cli README](https://github.com/xiaohui-zhangxh/c456-cli#常用命令)。
-
----
-
-## 6. 使用例子（复制到 AI 对话里）
-
-以下整段复制到客户端输入框即可（把路径或网址换成你的）。
-
-### 例子 1：收录 `raw/` 里的内容
-
-```
-整理 raw/articles/我的笔记.md
-```
-
-### 例子 2：收录 baklib.com 这个产品
-
-```
-收录 Baklib 这个产品，同步到 C456。
-```
-
-### 例子 3：记下对 fly.io 界面设计的喜欢
-
-```
-https://fly.io/ 的界面设计我很喜欢，请记下来：写成一条以后做产品可以借鉴的笔记，更新 wiki；同步内容到 C456。
-```
-
-### 例子 4：只做同步（不说别的）
-
-把本地已整理好的内容推到线上：
-
-```
-同步内容到 C456。
-```
-
-把线上最新状态拉回本地镜像与 wiki：
-
-```
-从 C456 同步内容。
-```
-
----
-
-## 7. 链接（想细看再点开）
-
-- [c456.com](https://c456.com)
-- [c456-cli 仓库与 README](https://github.com/xiaohui-zhangxh/c456-cli)
-- [Karpathy Wiki 技能（目录与约定）](https://github.com/baklib-tools/skills/tree/main/skills/karpathy-wiki)
-- [c456-llm-wiki 技能（与 C456 双向同步）](https://github.com/xiaohui-zhangxh/c456-cli/tree/main/skills/c456-llm-wiki)
-
-上游安装命令若变更，以对应仓库页面为准。