1实现原理 · 为什么它能做到
纯指令型「写作伙伴」:skill 目录内只有 SKILL.md 一个文件,全部能力是把 7 项写作能力写成一套协作流程,由宿主模型执行。
This skill acts as your writing partner, helping you research, outline, draft, and refine content while maintaining your unique voice and style.
能力清单以编号列表固定下来,模型按 1-7 项逐条兑现,避免只写不反馈。
## What This Skill Does 1. **Collaborative Outlining**: Helps you structure ideas into coherent outlines 2. **Research Assistance**: Finds relevant information and adds citations 3. **Hook Improvement**: Strengthens your opening to capture attention 4. **Section Feedback**: Reviews each section as you write 5. **Voice Preservation**: Maintains your writing style and tone 6. **Citation Management**: Adds and formats references properly 7. **Iterative Refinement**: Helps you improve through multiple drafts
每一阶段都内嵌 Markdown 输出模板:大纲模板带 Research To-Do 勾选清单,把「还要查什么」显式化。
## Research To-Do - [ ] Find data on [topic] - [ ] Get examples of [concept] - [ ] Source citation for [claim]
研究阶段要求给出可信来源 + 引用格式,并示范三种引用体例(行内 / 编号 / 脚注)与运行中的 References 列表。
**Inline Citations**: ```markdown Studies show 40% productivity improvement (McKinsey, 2024). ``` **Numbered References**: ```markdown Studies show 40% productivity improvement [1]. [1] McKinsey Global Institute. (2024)... ``` **Footnote Style**: ```markdown Studies show 40% productivity improvement^1 ^1: McKinsey Global Institute. (2024)...
分节反馈是固定五栏模板(What Works / Clarity / Flow / Evidence / Style + 逐行修改建议),保证每次反馈都是可执行编辑而非泛泛评价。
## What Works Well ✓ - [Strength 1] - [Strength 2] - [Strength 3] ## Suggestions for Improvement ### Clarity - [Specific issue] → [Suggested fix] - [Complex sentence] → [Simpler alternative] ### Flow - [Transition issue] → [Better connection] - [Paragraph order] → [Suggested reordering] ### Evidence - [Claim needing support] → [Add citation or example] - [Generic statement] → [Make more specific] ### Style - [Tone inconsistency] → [Match your voice better] - [Word choice] → [Stronger alternative] ## Specific Line Edits Original: > [Exact quote from draft] Suggested: > [Improved version] Why: [Explanation] ## Questions to Consider - [Thought-provoking question 1] - [Thought-provoking question 2] Ready to move to next section!
声音保护被写成硬原则:建议而非替换、跟随用户风格、用户坚持则尊重其版本。
- **Suggest, don't replace**: Offer options, not directives - **Match tone**: Formal, casual, technical, friendly - **Respect choices**: If they prefer their version, support it - **Enhance, don't override**: Make their writing better, not different
规定了工作目录与文件组织(outline.md / research.md / draft-v1..vN / final.md / feedback.md / sources/),把写作变成可版本化的工程。
### Setup Your Writing Environment Create a dedicated folder for your article: ``` mkdir ~/writing/my-article-title cd ~/writing/my-article-title ``` Create your draft file: ``` touch article-draft.md
研究阶段不点名任何检索后端,把「去哪查」留给宿主既有联网/知识能力——因此它自带的外发面为零,属纯协作编排。
- Search for relevant information - Find credible sources - Extract key facts, quotes, and data
2核心能力
4风险提醒 风险提醒:蓝色 · 知晓即可
- 示例引用是占位,照抄会产出未经核实的引用 — 研究示例里 [1] McKinsey 2024、Gartner 80%、Airbnb 案例、Marty Cagan 引语均为格式示范;SKILL.md 仅在 Best Practices 写「Verify sources before citing」,没有阻止模型把示例当事实。写作用它时要人工核验每条来源。
- 检索能力依赖宿主,质量不受本 skill 控制 — SKILL.md 不点名任何检索后端,「研究」结论取决于宿主模型/搜索工具;在没有检索能力的宿主上,这一步会退化为模型记忆,容易产生幻觉来源。
- 会主动建目录/写文件 — mkdir/touch 与推荐文件结构会落在用户工作目录(默认 ~/writing/...);在已有工程目录里使用时注意路径,避免污染。
- 英文语料导向 — 模板、示例、引用体例与工作流描述全为英文媒体/产品语境;中文长文写作需自行迁移,示例钩子不宜直用。
- 无输出事实边界约束 — skill 不限制模型编造案例风格(示例中的「Company A/B」结果数据),用户需自己守住「不虚构数据」的底线。
5第二遍独立确认
- [ok] skill 目录仅 SKILL.md — sparse-checkout 只含 cli-tool/components/skills/business-marketing/content-research-writer/;该目录下 find 结果仅 SKILL.md。
- [ok] 无网络代码 — http/https、curl、wget、requests、urllib、fetch 全文零命中;研究能力表述为「Search for relevant information」,未指向任何端点。
- [ok] 无凭证读取 — API_KEY/token/secret/password/keychain 零命中;全文不涉及登录或私有数据源。
- [ok] 写盘指令确实存在(判蓝依据) — How to Use 节含 `mkdir ~/writing/my-article-title`、`cd ~/writing/my-article-title`、`touch article-draft.md`;File Organization 节给出 7 个文件/目录的推荐结构。
- [ok] 引用体例三种 + References 维护 — Citation Management 节含 Inline Citations / Numbered References / Footnote Style 三个代码块与 `## References` 运行清单。
- [ok] 「研究」是否有真实检索能力 — SKILL.md 只写「Search for relevant information / Find credible sources / Extract key facts, quotes, and data」,不含任何 API、CLI 或端点——检索能力完全来自宿主;示例中的数字与来源(McKinsey 2024、Gartner 80%、Airbnb 案例)是格式示范且未经核验,已在 risks 标出。
- [ok] 声音保护原则 — Preserve Writer's Voice 节四项原则(Learn their style / Suggest, don't replace / Match tone / Respect choices / Enhance, don't override)与三句定期确认话术逐字核对通过。
- [ok] 示例与人名的事实性 — Example 1 以 Teresa Torres 的工作流举例、例中 Marty Cagan / Airbnb 均为说明性示例,不代表本 skill 与其有合作关系;已在 traits 注明。
6结论
da1a7a70a95381f5…41afe2db06