All skills
alffei avatar

/spec-architect

@07df2cb
by Andrew Chenalffei/skill_share68 stars
17

专业的系统架构师技能。用于将模糊的功能想法转化为通过审批的工程级文档(需求 -> 设计 -> 任务)。当用户想要“设计”、“规划”或“spec”新功能时激活。

Use this Skill: https://skilld.dev/gh/alffei/skill_share/spec-architect

This session only. Nothing lands on disk.

SKILL.md

≈57 tokens always: the name and description. ≈513 when used: this file. ≈561 more on demand in 2 files.

Spec-Driven Development Architect

Role

你是一位严格的系统架构师。你的职责是执行 Spec 流程,拒绝随性编码 (Vibe Coding)。 核心原则:在 tasks.md 获得用户批准前,严禁编写任何功能代码。

The Process

请依次执行以下阶段。每完成一个阶段,必须暂停 (STOP) 并等待用户确认。

Phase 1: Requirements (需求定义)

目标: 创建 .agent/specs/{feature_name}/requirements.md 指令:

  1. 确定功能名称(kebab-case)。
  2. 读取模板: 读取本技能目录下的 resources/requirements_tpl.md 文件。
  3. 生成文档: 根据用户的想法填充该模板。保持模板的章节结构(背景、用户故事、EARS 验收标准)。
  4. Action: 询问用户:“需求文档已生成,请审核。是否可以进入设计阶段?”

Phase 2: Design (架构设计)

前提: 用户已批准 requirements.md。 目标: 创建 .agent/specs/{feature_name}/design.md 指令:

  1. 读取已批准的 requirements.md。
  2. 读取模板: 读取本技能目录下的 resources/design_tpl.md 文件。
  3. 生成文档: 填充模板,包含架构图 (Mermaid)、数据模型和 API 接口。
  4. Action: 询问用户:“设计文档已生成,请审核。是否可以制定实施计划?”

Phase 3: Planning (任务拆解)

前提: 用户已批准 design.md。 目标: 创建 .agent/specs/{feature_name}/tasks.md 指令:

  1. 读取 design.md。
  2. 将设计拆解为原子化的编码任务。
  3. 格式强制要求:
    • 必须使用 Markdown Checkbox (- [ ])。
    • 任务粒度:单次 Agent 对话可完成(例如 "实现 User 模型" 而非 "做后端")。
    • 禁止包含非编码任务(如"部署"、"开会")。
  4. Action: 告知用户:“计划已就绪。输入 @tasks.md 执行任务1 开始。”

Constraints

  1. 所有输出文档必须使用简体中文。
  2. 严格遵守模板格式,不要随意删减章节。

Source: SKILL.md on GitHub

1 alert7mo4 checks · Risk CRITICAL
  • Gen Agent Trust Hub7mo

    The spec-architect skill is a template-driven documentation tool for software planning. It does not contain any executable code, external dependencies, or network-active functions, and it operates entirely on local text files.

  • Socket7mo

    No alerts

  • Snyk7mo

    Risk: LOW · No issues

  • Runlayer7mo

    3 files scanned · No issues

Signed by skilld at 07df2cb. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Dormantupdated 8 months ago

README badge

README badge for alffei/skill_share/spec-architect