task-spec
Skill1 starsChanged 30 days agoMITView on GitHub
把当前对话定稿为任务规格(背景、方案、决策、分阶段 TODO),落 .agentdocs/workflow/。不做二次访谈,只综合已讨论过的内容。需要拆分执行时接 /task-tickets。
3 other projects use a version of this.
Adopted by
Most recently taken up by
- hammoda711/task-spec-skilltheir own version, first seen Nov 8, 2026
- MagicianDu/task-spec-studiotheir own version, first seen Jul 1, 2026
- YorkWong1995/OPC-Harnesstheir own version, first seen May 26, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- YorkWong1995/OPC-Harness★ 4same name
- hammoda711/task-spec-skill★ 0same name
- MagicianDu/task-spec-studio★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository31 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- agentdocs-setupSkill
- agent-docsSkill
- codebase-designSkill
- code-reviewSkill
- commit-msgSkill
- diagnoseSkill
- engramSkill
- handoffSkill
- improve-archSkill
- interviewSkill
- prototypeSkill
- prSkill
- questionnaireSkill
- researchSkill
- review-frontend-productionSkill
- run-ticketSkill
- setup-gatesSkill
- sync-claude-mdSkill
- sync-readmeSkill
- task-retroSkill
- task-ticketsSkill
- tddSkill
- teachSkill
- team-devSkill
- wait-whatSkill
- wayfinderSkill
- which-skillSkill
- wizardSkill
- writing-for-agentsSkill
The file
Files
定稿任务规格
把当前对话与代码库理解合成为任务文档,写入 .agentdocs/workflow/。不访谈用户,只综合已知内容。
前置:.agentdocs/ 应已初始化。未初始化时,告诉用户先运行 /agentdocs-setup。
流程
- 前置判断:需求仍有未解决的关键分歧时,先向用户澄清少量关键问题再继续;已清晰则直接进入下一步。
- 探索代码库(若本次会话尚未探索):遵循
agent-docsskill 的读纪律,index.md、相关领域文档、术语表。输出使用术语表词汇,尊重相关决策记录。 - 确定测试边界:找出将要验证本功能的既有接缝(seam),优先复用既有接缝,新接缝放在尽可能高的位置,全库接缝越少越好。与用户确认接缝选择。
- 合成任务文档:按 task-doc-template.md 写入
.agentdocs/workflow/YYMMDD-slug.md。YYMMDD为当日日期,slug为短横线连接的英文任务简述。 - 更新索引:
.agentdocs/index.md的"当前任务文档"下追加一行主旨。 - 收尾提示:任务需要拆分执行时,建议用户运行
/task-tickets。
边界
- 任务文档是合成的产物,不是访谈记录:对话里没有的决策不发明,标注"待定"留给后续;
- 简单任务(单文件、单步、低风险)不需要任务文档,直接实现。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.