My prompt for ai coding with intent, harness and feedback
/sdlc "fix login bug" | "add user auth" | "review my changes"
│
▼
Intent Detection Engine
│
├─ fix|bug → bugfix workflow ─┐
├─ add|new → feature workflow │
├─ refactor → refactor workflow ├─→ Execute Skill → .sdlc/docs/category-feature-date.type.md
├─ review|cr → action:cr │
├─ understand → understand(cache) ─┘
└─ commit|pr → action:commit
/actions:<action>: understand | spec | coding | test | commit | cr | pr | regression
│
▼
Action Map
│
├─ understand → .sdlc/arch/overview-*.arch.md
├─ spec → .sdlc/docs/*.spec.md
├─ coding → .sdlc/docs/*.coding.md
├─ test → .sdlc/docs/*.test.md
├─ commit → .sdlc/docs/*.commit.md
└─ pr → .sdlc/docs/*.pr.md
/sdlc add user authentication
│
▼
Feature Workflow:
understand → research → spec → coding → test → commit → pr
│ │ │ │ │ │ │
.sdlc/ .sdlc/ .sdlc/ .sdlc/ .sdlc/ .sdlc/ .sdlc/
arch/ docs/ docs/ docs/ docs/ docs/ docs/
overview- auth-* auth-* auth-* auth-* auth-* auth-*
*.arch.md .research .spec .coding .test .commit .pr
.md .md .md .md .md .md
Interactive Flow: 继续 / 下一步 → Next phase 跳过测试 → Skip phase 到哪了? → Check status
-
Specifications matter.
-
Trust in the power of process.
The Software Development Life Cycle (SDLC) may be classical, but it still has much to teach us.
-
Do not attempt to keep every specification constantly updated as the code evolves.
High-level specifications will inevitably lag behind.
-
Validation specifications are critical.
We refer to this layer as the
Harness. -
Embrace the practice of maintaining and sharing the
Harness:- It strengthens code reviews
- It accelerates debugging
- It supports safe refactoring
- ……
-
REMEMBER There is no silver bullet.
The only constant is change.
-
规范(SPEC)很重要。
-
相信流程的力量。
Software Development Life Cycle (SDLC) 虽然古典,甚至略显传统,但它能教会我们的,远不止流程本身。
-
不要试图让所有 SPEC 随代码实时同步。
一般性的 SPEC,天然会滞后,这是常态,而非问题。
-
验证型 SPEC 更关键。
我们可以称之为
Harness。 -
主动建设并沉淀
Harness:- 让 Code Review 更有依据
- 让 Debug 更高效
- 让 Refactoring 更安全
- ……
-
不存在银弹。
变化常在。
vibely/
├── actions/ # SDLC action definitions (slash commands)
│ ├── coding.md # /coding - Coding phase
│ ├── commit.md # /commit - Commit phase
│ ├── cr.md # /cr - Code review phase
│ ├── debug.md # /debug - Debugging phase
│ ├── discuss.md # /discuss - Discussion
│ ├── guard.md # /guard - Guard/validation
│ ├── handoff.md # /handoff - Handoff procedures
│ ├── harness.md # /harness - Harness integration
│ ├── pr.md # /pr - Pull request
│ ├── regression.md # /regression - Regression testing
│ ├── research.md # /research - Research phase
│ ├── secure.md # /secure - Security phase
│ ├── simplify.md # /simplify - Code simplification
│ ├── spec.md # /spec - Specification phase
│ ├── test.md # /test - Testing phase
│ ├── understand.md # /understand - Understanding/analysis
│ └── validate.md # /validate - Validation phase
├── commands/ # Extended commands and utilities
│ ├── codeclean.md # /codeclean - Code cleaning
│ ├── discuss.md # Discussion documentation
│ └── new-command.md # /new-command - Create new commands
├── flow/ # Flow control and state management
│ ├── resume.md # /sdlc resume - Resume workflow
│ └── status.md # /sdlc status - Status tracking
├── resource/ # Resource files
│ └── showcase-oauth.png # OAuth showcase image
├── utils/ # Utility skills and tools
│ ├── README.md # Utilities overview
│ ├── archive.md # Archive utility
│ ├── branch.md # Branch detection utility
│ ├── cache.md # Cache utility
│ ├── doc.md # Documentation utility
│ ├── git-resolve.md # Git conflict resolution
│ └── git.md # Git utility
│ └── pencil.md # Pencil framework utility
├── workflows/ # Workflow definitions
│ ├── bugfix.md # Bug fix workflow
│ ├── feature.md # Feature development workflow
│ ├── minor.md # Minor changes workflow
│ ├── refactor.md # Refactoring workflow
│ └── research.md # Research workflow
├── .gitignore # Git ignore rules
├── AGENTS.md # Agents documentation
├── README.md # This file
├── feedback.md # Feedback skill
└── sdlc.md # SDLC main documentation
-
反馈驱动演进。
-
工作流结束,学习才刚开始。
每一次通过
/sdlc完成的任务,都会产生新的洞察。 -
不要满足于静态流程。
今天有效的方法,明天可能需要改进。
-
打分、反思、迭代。
-
持续改进:
- 评估哪些有效,哪些无效
- 基于真实经验更新工作流
- 让每次迭代为下次提供依据
- ……
-
不存在银弹。
系统在每一次反馈循环中自我完善,人的反馈非常重要且简单。
-
Feedback drives evolution.
-
The workflow completes, but the learning continues.
Every task executed through
/sdlcgenerates insights. -
Do not settle for static processes.
What works today may need refinement tomorrow.
-
Score, reflect, and iterate.
# tasks done with /sdlc
# now we score them and update them
/feedback
-
Embrace continuous improvement:
- Evaluate what worked and what didn't
- Update workflows based on real experience
- Let each iteration inform the next
- ……
-
REMEMBER There is no silver bullet.
The system improves itself, but feedback loop is important at a time.
- Inspiration from https://github.com/karpathy/autoresearch
- Implemented as
/feedback
- A markdown writing plugin (support *.md) for coding task spec writing - https://github.com/FFengIll/vscode-tingly-spec.git
- AI Orchestrator - https://github.com/tingly-dev/tingly-box
