Communitygithub.com

jintomjose/mini-software-factory

将提交的 intent.md 转换为 spec.md(需求与设计合一的产物),并内联标注策略关注点和未决决策。适用于捕获意图之后、规划模式之前。

mini-software-factory 是什么?

该技能(`jintomjose/mini-software-factory`)是一个 AI 智能体技能,主要用于将 `intent.md`(意图文档)自动转化为 `spec.md`(规范文档)。其核心价值在于:在编写规范前强制阅读相关代码库,避免因未考虑代码约束而导致的常见失败;同时通过内联标记 `[NEEDS CLARIFICATION]` 和 `[POLICY: ...]` 来明确未决决策和策略关注点(如隐私、安全、资金等),杜绝隐性处理。输出的 `spec.md` 包含按优先级排序的用户故事、带有稳定 ID 的功能需求与成功标准、必要的设计深度(数据变更、接口、状态、错误处理)以及显式的“超出范围”列表。该技能适用于支持 SKILL.md 的 AI 编码工具(如 Claude Code、Cursor 等),在“捕获意图”步骤之后、“规划模式”之前使用,提交 `spec.md` 即触发后续规划流程。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jintomjose/mini-software-factory/tree/HEAD/.claude/skills/write-spec

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

编写规范

输入:work/<feature>/intent.md。输出:work/<feature>/spec.md,来源于 factory/templates/spec.md。

  1. 阅读 intent.md、CLAUDE.md 以及变更将触及的代码库相关部分。未阅读代码而编写的规范会遗漏约束;这是最常见的失败原因。
  2. 按优先级顺序(P1、P2、P3)编写用户故事。每个 P1 故事必须能独立交付和测试。
  3. 为每个功能需求赋予稳定 ID(FR-001),每个成功标准也赋予 ID(SC-001)。评审和测试将引用这些 ID。
  4. 内联标记,绝不隐性处理:
    • [NEEDS CLARIFICATION: ...] 用于任何意图未明确的决策
    • [POLICY: privacy | security | legal | money | brand] 在规则适用处,并附上该规则
  5. 仅编写规划所需的深度设计内容:数据变更、接口、状态、错误处理。
  6. 明确列出不在范围内的内容。
  7. 展示规范,与人员澄清所有 [NEEDS CLARIFICATION] 后保存。提交 spec.md 是触发规划模式的条件。

相关技能