Through interview-style dialogue, help users share their IDD (Intent Driven Development) adoption experience and generate blog posts that spread the IDD methodology.
Core Concepts
- Interview-style creation: AI analysis + questions + user answers + AI integration according to style
- Real stories: Based on the user's real experience, no fabricated cases
- Spread IDD: Every article naturally introduces the IDD philosophy and tools
Workflow
/intent-story
↓
┌───────────────────────────────────┐
│ Phase 1: 背景分析 │
│ - 检测输入语言 │
│ - 加载写作风格（如有） │
│ - 了解用户 IDD 使用背景 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 2: 结构化采访 │
│ - 采用经历 │
│ - 关键转折/教训 │
│ - 具体收益/数据 │
│ - 建议和反思 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 3: 确认输出需求 │
│ - 文章格式/风格/长度 │
│ - 目标语言版本 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 4: 生成文章 │
│ - 完整博客 + 社交媒体版 │
│ - 多语言版本（按需） │
│ - 自然融入 IDD 介绍 │
└───────────────────────────────────┘
Phase 1: Background Analysis
Language Detection
- Determine the initial writing language based on the user's primary input language
- Later you may ask whether other language versions are needed
Writing Style Loading
Load by priority (if present):
~/.claude/content-profile/writing-style.md(user-defined)- Use this skill's default style
Initial Questions
Use AskUserQuestion to learn the background:
question: "你是在什么类型的项目中使用 IDD 的？"
header: "项目类型"
options:
- label: "系统软件/框架"
description: "框架、库、基础设施等"
- label: "Web 应用"
description: "前端或全栈 Web 项目"
- label: "移动应用"
description: "iOS、Android 或跨平台"
- label: "其他"
description: "其他类型项目"
Phase 2: Structured Interview
Interview Dimensions
2-3 questions per round, usually completed in 3-5 rounds.
1. Motivation for adoption
"是什么让你开始尝试 IDD？"
- A) 文档总是过时，想找更好的方法
- B) AI 辅助开发需要更好的上下文管理
- C) 团队协作需要更清晰的设计契约
- D) 其他原因
2. Turning point
"使用 IDD 过程中，有没有一个'啊哈'时刻让你觉得值得？"
[开放式，收集故事]
3. Specific benefits
"你观察到的最明显的改变是什么？"
- A) AI 代码质量提升（更少需要修改）
- B) 架构边界更清晰
- C) 文档不再过时
- D) 新人上手更快
- E) 其他
"能否量化一下收益？（可选）"
[开放式，如："AI 一次生成可用代码的比例从 30% 提升到 70%"]
4. Lessons and challenges
"遇到过什么挑战或走过的弯路？"
[开放式]
"如果重新开始，你会有什么不同的做法？"
[开放式]
5. Advice for others
"对考虑采用 IDD 的人，你有什么建议？"
[开放式]
Interview Principles
- Ask less, infer more: Don't repeat questions that can be inferred from the preceding context
- Story first: Encourage users to share specific experiences
- Authenticity: Don't fabricate cases; don't add anything the user doesn't have
- In-depth follow-up: Keep digging into valuable answers
Phase 3: Confirm Output Requirements
After the interview is complete, confirm the output format:
Article style
question: "这篇文章的风格？"
header: "风格"
options:
- label: "技术分享"
description: "peer-to-peer，工程师视角"
- label: "经验总结"
description: "回顾反思，Founder/Lead 视角"
- label: "入门指南"
description: "帮助新人理解和上手"
- label: "案例研究"
description: "详细的项目案例分析"
Article length
question: "目标长度？"
header: "长度"
options:
- label: "短文 (800-1200字)"
description: "快速阅读，重点突出"
- label: "中等 (1500-2500字)"
description: "有深度的分享"
- label: "长文 (3000+字)"
description: "完整详细的案例分析"
Language version
question: "需要生成哪些语言版本？"
header: "语言"
multiSelect: true
options:
- label: "中文"
description: "简体中文版本"
- label: "English"
description: "English version"
- label: "两者都要"
description: "中英双语"
Phase 4: Generate the Article
Article structure
# [标题：吸引人的 IDD 经验标题]
[开头：核心洞察/结论，吸引读者]
## 背景/起因
[为什么开始使用 IDD]
## 关键发现/转折
[使用过程中的洞察和故事]
## 实际收益
[具体的改变和量化数据]
## 教训和建议
[给其他人的建议]
## 结语
[总结 + IDD 介绍]
---
## 关于 IDD
[IDD 简介和工具链，见下文模板]
IDD introduction template (must be included)
Naturally incorporate at the end of each article:
---
## About IDD (Intent Driven Development)
IDD 是一种以 Intent（意图）为核心的开发方法论：
Intent → Test → Code → Sync
**核心理念**：Intent 是新的源代码。Code review 由 AI 完成，Intent review 由 Human 完成。
**工具链**：
- `/intent-assess` - 评估项目是否适合 IDD
- `/intent-init` - 初始化 IDD 结构
- `/intent-interview` - 从想法创建 Intent
- `/intent-check` - 验证代码与 Intent 一致性
**开始使用**：
```bash
npx add-skill arcblock/idd
Learn more:github.com/ArcBlock/idd
### 社交媒体版本
同时生成 Twitter/X 版本：
[Core insight, 1-2 sentences]
[Key data/benefits]
[One-sentence CTA]
🔗 [Article link]
#IntentDrivenDevelopment #IDD #AIEngineering
### 写作风格指南
遵循以下原则（来自用户写作风格）：
| 原则 | 说明 |
|------|------|
| 观点鲜明 | 不做骑墙派，有明确立场 |
| 真实案例 | 故事来自用户，不编造 |
| 段落充实 | 每段 4-8 句，有完整论述 |
| 小标题精简 | 2-4 个小标题，内容丰富 |
| 内省式表达 | "我觉得..."而非"你应该..." |
| 避免套话 | 每个观点要有具体洞察支撑 |
| 禁用 em dash | 用 "-" 或 "," 替代 "—" |
## 输出示例
```markdown
# 从「文档总是过时」到「Intent 就是代码」- 我的 IDD 实践
半年前，我们团队面临一个经典困境：文档写得再好，三周后就过时...
[正文...]
---
## About IDD
IDD (Intent Driven Development) 是一种以意图为核心的开发方法论...
[工具链介绍...]
**开始使用**：
\`\`\`bash
git clone https://github.com/ArcBlock/idd
claude mcp add-plugin ~/path/to/idd
\`\`\`
Working with Other Commands
[用户使用 IDD 一段时间]
↓
/intent-story # 分享经验，生成博客
↓
发布博客 / 社交媒体
↓
传播 IDD 方法论
Notes
- Authenticity: All cases and data must come from the user and must not be fabricated
- Natural integration: The IDD introduction should be naturally integrated at the end, not a stiff advertisement
- User language: The primary language follows the user's input
- Style consistency: If there is a user writing style configuration, use it first