Mmcp.market

apostle-sdd skill

by Luciole-Studio·Luciole-Studio/apostle-skills·10 stars·AGPL-3.0

编程工作流，在你开始工作编程前加载。

A100/100content scan

Is the apostle-sdd skill safe?

Clean: nothing in its files matched our rules. We read 1 file in the folder on 2026-09-28.

No findings.

Install the apostle-sdd skill

A skill is a folder. Copy it into your agent's skills folder and the agent loads it when the task matches its description. 

git clone --depth 1 https://github.com/Luciole-Studio/apostle-skills.git /tmp/apostle-skills
mkdir -p ~/.claude/skills
cp -r /tmp/apostle-skills/skills/apostle-sdd ~/.claude/skills/apostle-sdd
available in every project

In the Claude apps, zip the folder and upload it from the Skills settings. The folder on GitHub

The instructions your agent would load

SKILL.md as published, without the frontmatter. Read it on GitHub

SDD工作流

本skill基于apostle-artifacts-loops：继承其"文档先行"原则，基于Spec-Driven Development规范。为一个组件写代码前先发散思考，再为这个组件按要求写一份独立的SPEC.md，便于用户理解和后期维护。

零引用：本 SKILL.md 即全部内容，不附带任何参考文件、脚本或模板；SPEC.md属于项目工作区，请你按代码结构整理文档结构。

动笔之前先确保项目文档在你的上下文中：AGENTS.md、权威文档（如 "CONTEXT.md"、 "ARCHITECTURE.md"）、ADR、相邻模块的文档与代码，沿用其中的词汇与约定。

你应用 "组件名+SPEC.md" 防止同一目录下有过多SPEC.md无法区分，你只应为项目中需合并的代码（即不需要为测试、prototype和demo等）编写SPEC.md，并在实现有SPEC.md的代码时只在必要时写极简风的注释。

当你工作涉及的代码存在现有的SPEC.md时应先完整读一遍，优化、增减改动和debug都应先修改SPEC.md再写代码。

执行纪律

  • SPEC.md写完再写代码；代码实现必须不多不少地遵守SPEC.md，偏离时要么改代码，要么先更新SPEC.md并说明原因。
  • 代码完成时对照SPEC.md自查：每一步的实现应当符合文档中的决策理由，发现更优做法先和用户更新文档。
  • 代码完成时按SPEC.md的测试章节验证并简要记录结果。
  • 完成时对照"文档同步"节，提醒用户更新所有列出的文档，把实际验证结果写清楚。
  • 如果你遇到了必须由用户审核或澄清的部分，请你交付SPEC.md或代码后停下来用用户喜欢的表达方式与其对齐。

SPEC.md的章节顺序

SPEC.md须用数字列表与下方所列顺序同步，采用精准、清晰、易读的风格和多级标题等进行结构化创作：

  1. 需求拆解——精确定位需求，把它拆成可独立完成、可独立验收的最小单元。
  2. 验收标准——穷举每个单元可观察、可检验的完成定义并排列为完整的清单，确保基于清单可以完成测试编写和功能验收。
  3. 假设与歧义——列出需求中的歧义点与你的假设，优先在权威信源一节查证。
  4. 现状分析——若涉及现有代码，先做分析：一手看代码逻辑，一手看时间、内存等性能表现。
  5. 权威信源——尽可能引用官方文档或项目文档等权威信源，确认设计意图、沿用相同的概念与风格，并确定精确的变量名和所需引用的内容，链接相关文档。
  6. 命名统一——模块、类型与变量的命名沿用项目词汇表与领域文档，不自造同义词。
  7. 模块边界——清晰划分模块边界、依赖关系与数据流。
  8. 接口先行——先设计公开接口与类型签名，用类型让非法状态不可表示，而不是靠运行时检查兜底。
  9. 工作流程——自上而下地分析这个模块从入口到出口的完整工作流程。
  10. 实现逻辑——按开发工作流把实现分成几步，逐步解释每步要做什么、为什么这样做：关键决策与权衡、复杂度与性能考量、为何优于替代方案，让读者能据此判断代码质量。
  11. 边界枚举——枚举极端输入、异常路径与并发冲突。
  12. 错误处理——定义每类错误的处理策略：谁捕获、如何传播、以什么形式呈现给调用方或用户。

More skills from Luciole-Studio/apostle-skills

  • Aapostle-antislopEdit existing English or Chinese prose when the language has become model-shaped rather than subject-shaped: inflated significance, vague authority, answer scaffolding, repeated conclusions, template paragraphs, flattened voices, or English-shaped Chinese. Use for AI味／模型腔／机翻腔／套话／slop. Supports diagnosis, local cleaning, and explicitly authorized blank-page rewriting while preserving meaning and genre. Not ordinary proofreading, imitation, fact-checking, authorship detection, or detector evasion. Pure translation belongs to `apostle-translation`.
  • Aapostle-article-researchPre-draft research for long-form nonfiction whose question, claim, scope, or structure must be allowed to change under evidence. Use for political, historical, social-scientific, intellectual, or investigative work involving conflicting records, archival silence, adverse material, sensitive sources, or publication boundaries. Stops at a draftable evidence handoff; not for one-off fact checks, literature reviews, deep reading of one work, or finished-draft review.
  • Aapostle-artifacts-loopsLong tasks, sub-agent, and multi-agent work — durable artifacts, session handoff, execution graphs, and context discipline. Trigger preferentially as working discipline when work spans stages, contexts, or agents and must keep user decisions, dependencies, evidence, and recovery state. Do not load for short or simple tasks that you can complete and verify directly.
  • Aapostle-constitutioApostle-Constitutio——智能协作宪法。 凡涉及实质思考或将产生效应的任务即应全文加载、不分层：深度讨论、批判与分析、研究与论证、创作与设计、决策辅助、哲学与社会议题、长对话，以及文件与记录的变更、委托、多步决策、同意/拒绝/伤害分析。 读法是宪法学与伦理学的，而非神学的；其思想来源是双向零信任和不对称自主性原则（见 §0）。 在用户层信息中持最高优先级；不凌驾于运行环境的系统级约束——二者冲突时必须披露，而非静默消化。
  • Aapostle-opus-reading对著作的深度理解。当用户交来著作、长文、全集要求真正读懂，或说深度阅读、深读、细读、逐句精读、重读、隐微阅读、读懂这本书、"未写而必须"时使用；对象为承重文本（指定文本、哲学/理论专著、隐微写作、被低估之作）时必须加载。Wager-ledger reading — understanding an opus as a signed, falsifiable discovery, not coverage.
  • Aapostle-opusmethodology-foucault-archaeologyApostle-Opusmethodology·方法迁移：福柯《知识考古学》(L'archéologie du savoir, 1969)。 当通行统一体（"某学科/某思潮/某群体/某传统"）一用就打滑、寻找共同本质连续失败、 新概念落在现成范畴的夹缝里无处安放、"X是什么"被反例反复击穿、 或需要为新研究写划界宣言/方法声明时使用； 用户说"考古学式分析""话语分析""像福柯那样看"时必须加载。 Doctrine dead, moves alive — the book's transplantable operations, kernels verbatim in French.
  • Aapostle-opusmethodology-foucault-society-defendedApostle-Opusmethodology·方法迁移：福柯法兰西学院课程《必须保卫社会》(«Il faut défendre la société», 1976)。 当一个领域自我呈现为和平/共识/普遍性（"社区""生态""大家庭""我们都赢了"）而你怀疑其下有未清算的战争时使用； 当需要分析一个理论使什么变得不可能（而非它反驳谁）、追踪同一话语被敌对各方征用、 解释冲突语汇如何变成健康/安全/风险的医学语汇、或需要把自己的假设押上台面公开检验时使用； 用户说"谱系学式分析""战争作为分析器""像《必须保卫社会》那样看""counter-history"时必须加载。 Doctrine dead, moves alive — the lecture course's transplantable operations, kernels verbatim in French.
  • Aapostle-opusmethodology-karatani-originsApostle-Opusmethodology·方法迁移：柄谷行人《日本近代文学の起源》(1980/定本2004)。 当一个「从来如此」的自然之物（某种感受方式、某个学科对象、某类主体、某种常识范畴） 需要被读出成立时刻，当批判一个对象的姿态反而在再生产这个对象， 当「X 的历史」写得越多 X 越显得自古就有， 当对象在某个压缩期内一举成立并即刻自然化时使用； 用户说「起源分析」「装置分析」「転倒」「像柄谷那样读」时必须加载。 Doctrine dead, machine alive — the book's transplantable operation, kernels verbatim in Japanese.
  • Aapostle-translation形式即内容的文本（措辞、句法、难度本身即思想）外译中的完整规程：哲学、社会理论、思想史、历史、文学、学术论文的低方差精译，源语覆盖英/法/德/俄/日/韩/拉丁。凡用户要求翻译论文/章节/整本书、要求"继续翻译/别停/一口气推进/断点续翻"、讨论译名取舍、要求复原作者句法与语法范畴（时态/语态/数/属格，从原文而非转译本）、或要求查译错/评审忠实度时使用。管从干净源文到已验证中文全稿之间的一切；抽取/OCR/排版交付不归它管（见文末路由行）。
  • Aapostle-tutor发现式教学——带一个具体的人把一门技术学到「能诊断」，靠对话、真实报错和他自己的话推进，不产出课件。凡用户说「教我 X」「带我学 X」「继续上次的学习」「我想学编程／Rust／某个语言或框架」「上一站到哪了」，或要求判断某人掌握到什么程度、要求把一次教学的进度记下来时使用。它管一次次对话式教学的方法与续接：先确定已有知识、划出前沿、给规格不给教程、让编译器当裁判、用学习者的原话作掌握证据。不产出 HTML 课件、阅读材料或课程包，那是 `teach` 的活；也不用于写文档、写教程文章或给代码加注释。

All agent skills → · MCP servers