mcpField
W
writing-tech-post

writing-tech-post

github.com/pedronauck创意与媒体644170 次安装1 周前更新
代码仓库

关于 writing-tech-post

writing-tech-post 是用于撰写、改写、列提纲和审阅工程文章的技能。它帮助技术作者围绕有依据的证据组织内容、解释机制与影响,并避免把编辑启发式当作强制规则。

主要功能

  1. 01撰写文章、提纲、改稿和审阅
  2. 02明确读者、要点与已证实事实
  3. 03选择适合材料的文章结构
  4. 04以证据支撑技术主张
  5. 05检查发布前的主张与披露
  6. 06运行可选的启发式检查器

适用场景

  1. 01为新的工程文章拟定提纲
  2. 02修改现有技术稿件
  3. 03解释性能或安全问题
  4. 04对外发布前核查主张

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/pedronauck/skills --skill writing-tech-post

安装后在 Claude Code 中输入/writing-tech-post确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/
evidence-block.snippets.md
frontmatter.template.md
outline.ai-agent-post.md
outline.launch-deep-dive.md
outline.migration.md
outline.performance.md
outline.postmortem.md
outline.research-translation.md
outline.security-disclosure.md
outline.tutorial.md
references/
ai-and-agents.md
anti-patterns.md
archetypes-and-structure.md
depth-and-abstraction.md
evidence-diagrams-code.md
migrations.md
narrative-and-pacing.md
performance-deep-dive.md
postmortems.md
pre-publish-checklist.md
publisher-voice-matrix.md
security-and-reliability.md
voice-and-disclosure.md
scripts/
lint-post.py
validate-metadata.py

详细介绍

撰写工程文章

产出所请求的内容:新文章、大纲、针对特定范围的改写,或发布审核。重用已确认的简报和证据。选择适合读者和材料的结构;小幅编辑无需重新启动整个写作流程。

  1. 根据现有上下文明确读者、核心观点和有依据的事实。仅在缺失信息会实质影响所请求的输出时才提问。
  2. 撰写新文章时,选择合适的主要文章类型并拟定大纲。处理现有草稿时,保留可用结构,并在所请求的范围内进行编辑。除非发布方要求,否则前置元数据、层级标签、深度元组和逐节证据计划都是可选工具。
  3. 说明机制及其重要性。为定量、比较、安全和能力方面的主张提供适当证据,并说明其局限。区分实际测量结果、示例说明、假设和仍在进行的工作。
  4. 根据需要润色语气和行文。发布方风格矩阵、H2 问题链以及首尾各 200 字的对比都是编辑启发式方法,并非通用门槛。不要为了满足某种叙事结构而捏造失败的缓解措施、阶段性胜利、基准测试结果或经验教训。
  5. 对外发布前,针对相关主张和披露义务,执行 references/pre-publish-checklist.md。交付草稿不代表已获准发布。可选的检查工具会报告启发式问题;事实核查和披露决定由人工审核负责。

参考资料导航

阅读与当前文章类型或编辑问题相关的参考资料,无需查阅每个阶段的资料:

  • 结构:references/archetypes-and-structure.md;可选的深度诊断:references/depth-and-abstraction.md。
  • 事件:references/postmortems.md;迁移:references/migrations.md;性能:references/performance-deep-dive.md。
  • AI/Agent:references/ai-and-agents.md;安全/可靠性:references/security-and-reliability.md。
  • 证据/素材:references/evidence-diagrams-code.md;叙事:references/narrative-and-pacing.md。
  • 语气/披露:references/voice-and-disclosure.md;指定的发布方语体:references/publisher-voice-matrix.md;具体的行文问题:references/anti-patterns.md。

仅在有用时使用 assets/outline.<archetype>.md 模板;省略无关章节。通过此技能的绝对目录运行辅助脚本:python3 <writing-tech-post-dir>/scripts/lint-post.py <draft.md>。--strict 会将启发式警告视为失败,用于明确选定的编辑门槛。检查结果无误并不能证明内容符合事实或已满足披露要求。

评论

支持 Markdown